clawpet-plugins 1.0.1 → 1.1.1

package/index.ts

@@ -1,27 +1,27 @@
 /**
  * ClawPet OpenClaw Plugin
  *
- * 自动上报 agent 的 tool call 到 ClawPet 后端，
- * 驱动龙虾宠物实时动画。
+ * Automatically reports agent tool calls to the ClawPet backend,
+ * driving real-time lobster pet animations.
  *
- * Hook:
- * - after_tool_call: 每次 tool 执行完毕后上报 action + summary
- * - agent_end: 每轮对话结束时上报
+ * Hooks:
+ * - after_tool_call: reports action + summary after each tool execution
+ * - agent_end: reports when an agent turn completes
  *
- * 配置（在 OpenClaw config 的 plugins.entries 段）：
+ * Configuration (in OpenClaw config plugins.entries):
  * {
  *   "clawpet-plugins": {
  *     "enabled": true,
  *     "config": {
- *       "apiKey": "cpk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
- *       "apiBase": "https://api.venusx.top"
+ *       "apiBase": "https://api.myclawpet.cn",
+ *       "apiKey": "cpk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  *     }
  *   }
  * }
  */
 
 // ---------------------------------------------------------------------------
-// 类型定义（对齐 OpenClaw Plugin API，不依赖源码 import）
+// Type definitions (aligned with OpenClaw Plugin API, no source imports)
 // ---------------------------------------------------------------------------
 
 type PluginLogger = {
@@ -44,20 +44,17 @@ type PluginApi = {
 };
 
 // ---------------------------------------------------------------------------
-// 常量
+// Constants
 // ---------------------------------------------------------------------------
 
-/** 默认 API 地址 */
-const DEFAULT_API_BASE = "https://api.venusx.top";
-
-/** 去重窗口（ms）—— 同一工具 2 秒内不重复上报 */
+/** Dedup window (ms) — skip duplicate reports for the same tool within 2s */
 const DEDUP_WINDOW = 2000;
 
-/** 上报超时（ms） */
+/** Report timeout (ms) */
 const REPORT_TIMEOUT = 5000;
 
 // ---------------------------------------------------------------------------
-// 插件入口
+// Plugin entry
 // ---------------------------------------------------------------------------
 
 export default {
@@ -66,7 +63,15 @@ export default {
       | { apiKey?: string; apiBase?: string }
       | undefined;
     const apiKey = config?.apiKey;
-    let apiBase = config?.apiBase || DEFAULT_API_BASE;
+    let apiBase = config?.apiBase;
+
+    if (!apiBase) {
+      api.logger.warn(
+        "[ClawPet] No apiBase configured — plugin disabled. " +
+          "Set plugins.entries.clawpet-plugins.config.apiBase in your OpenClaw config.",
+      );
+      return;
+    }
 
     if (!apiKey) {
       api.logger.warn(
@@ -85,28 +90,28 @@ export default {
 
     api.logger.info(`[ClawPet] Plugin active, reporting to ${apiBase}`);
 
-    // 去重：记录最近上报的 toolName → timestamp
+    // Dedup: track recently reported toolName → timestamp
     const lastReported = new Map<string, number>();
 
     /**
-     * 异步上报到 ClawPet 后端
-     * 不 await，不阻塞 agent
+     * Async report to ClawPet backend.
+     * Fire-and-forget — never blocks the agent.
      */
     function reportActivity(action: string, summary: string): void {
-      // 去重检查
+      // Dedup check
       const now = Date.now();
       const lastTime = lastReported.get(action);
       if (lastTime && now - lastTime < DEDUP_WINDOW) return;
       lastReported.set(action, now);
 
-      // 清理过期去重记录（防内存泄漏）
+      // Evict stale dedup entries (prevent memory leaks)
       if (lastReported.size > 100) {
         for (const [key, ts] of lastReported) {
           if (now - ts > DEDUP_WINDOW * 5) lastReported.delete(key);
         }
       }
 
-      // 异步 POST，fire-and-forget
+      // Async POST, fire-and-forget
       const controller = new AbortController();
       const timeout = setTimeout(() => controller.abort(), REPORT_TIMEOUT);
 
@@ -124,7 +129,7 @@ export default {
           if (res.ok) {
             try {
               const data = await res.json();
-              // 搭便车更新 apiBase
+              // Piggyback apiBase update from webhook response
               if (data?.config?.apiBase && data.config.apiBase !== apiBase) {
                 api.logger.info(
                   `[ClawPet] API base updated: ${apiBase} → ${data.config.apiBase}`,
@@ -132,19 +137,19 @@ export default {
                 apiBase = data.config.apiBase;
               }
             } catch {
-              // JSON 解析失败，忽略
+              // JSON parse failure — ignore
             }
           }
         })
         .catch(() => {
           clearTimeout(timeout);
-          // 上报失败静默忽略，不影响 agent 工作
+          // Report failure silently — never affect agent work
         });
     }
 
     // ========================================
     // Hook: after_tool_call
-    // 每次 tool 执行完毕后上报
+    // Reports after each tool execution
     // ========================================
 
     api.on("after_tool_call", (event: any) => {
@@ -159,13 +164,13 @@ export default {
 
         reportActivity(toolName, summary);
       } catch {
-        // Hook 内部错误静默，绝不影响 agent
+        // Hook errors are silent — never affect agent
       }
     });
 
     // ========================================
     // Hook: agent_end
-    // Agent 一轮结束时上报
+    // Reports when an agent turn completes
     // ========================================
 
     api.on("agent_end", (event: any) => {
@@ -177,7 +182,7 @@ export default {
           reportActivity("error", `Turn failed: ${event.error ?? "unknown"}`);
         }
       } catch {
-        // Hook 内部错误静默，绝不影响 agent
+        // Hook errors are silent — never affect agent
       }
     });
   },

package/openclaw.plugin.json

@@ -8,14 +8,13 @@
     "properties": {
       "apiBase": {
         "type": "string",
-        "description": "ClawPet API base URL",
-        "default": "https://api.venusx.top"
+        "description": "ClawPet API base URL (required)"
       },
       "apiKey": {
         "type": "string",
-        "description": "ClawPet API key (cpk_xxx)"
+        "description": "ClawPet API key (cpk_xxx, required)"
       }
     },
-    "required": []
+    "required": ["apiBase", "apiKey"]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawpet-plugins",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "OpenClaw plugin for ClawPet — auto-report tool calls for real-time pet visualization",
   "type": "module",
   "main": "index.ts",
@@ -11,7 +11,7 @@
     "openclaw.plugin.json",
     "README.md"
   ],
-  "homepage": "https://myclawpet.com",
+  "homepage": "https://myclawpet.cn",
   "publishConfig": {
     "access": "public"
   },