@claw-camp/openclaw-plugin 2.0.1 → 2.0.3

package/README.md

@@ -2,48 +2,52 @@
 
 实时监控你的 OpenClaw Agent 状态、Token 消耗、Gateway 健康度。
 
-Dashboard：[camp.aigc.sx.cn](https://camp.aigc.sx.cn)
+**Dashboard：[camp.aigc.sx.cn](https://camp.aigc.sx.cn)**
 
 ---
 
-## 安装
+## 快速开始
+
+### 第一步：注册账号，创建 Bot
+
+1. 访问 [camp.aigc.sx.cn](https://camp.aigc.sx.cn) 注册账号
+2. 登录后进入 **Bot 管理** → 创建一个 Bot
+3. 记录下 **Bot ID** 和 **Bot Token**
+
+### 第二步：安装插件
 
 ```bash
 openclaw plugins install @claw-camp/openclaw-plugin
 ```
 
-安装完成后重启 Gateway：
+### 第三步：配置 Bot 信息
+
+**方式一：交互向导（推荐）**
 
 ```bash
-openclaw gateway restart
+openclaw onboard
 ```
 
----
+在渠道选择步骤中选择 `claw-camp`，按提示填入 Bot ID 和 Bot Token 即可。
 
-## 配置
-
-安装后在 OpenClaw 配置文件中添加：
-
-```json
-{
-  "channels": {
-    "claw-camp": {
-      "enabled": true,
-      "accounts": {
-        "default": {
-          "botId": "your-bot-id",
-          "botToken": "your-bot-token"
-        }
-      }
-    }
-  },
-  "plugins": {
-    "allow": ["claw-camp"]
-  }
-}
+**方式二：命令行手动配置**
+
+```bash
+openclaw config set channels.claw-camp.accounts.default.botId "your-bot-id"
+openclaw config set channels.claw-camp.accounts.default.botToken "your-bot-token"
+openclaw config set plugins.allow '["claw-camp"]'
 ```
 
-> `botId` 和 `botToken` 从 [camp.aigc.sx.cn](https://camp.aigc.sx.cn) 注册获取。
+### 第四步：启动 Gateway
+
+```bash
+openclaw gateway restart
+```
+
+首次启动用：
+```bash
+openclaw gateway
+```
 
 ---
 
@@ -53,14 +57,14 @@ openclaw gateway restart
 openclaw plugins list | grep claw-camp
 ```
 
-看到 `loaded` 状态即成功。访问 [camp.aigc.sx.cn](https://camp.aigc.sx.cn) 查看你的 Agent 上线。
+看到 `loaded` 即成功。访问 [camp.aigc.sx.cn](https://camp.aigc.sx.cn)，你的 Agent 会出现在列表中并显示 `online`。
 
 ---
 
 ## 监控内容
 
-- Gateway 运行状态
-- 会话列表 & Token 消耗
+- Gateway 运行状态（running / stopped）
+- 活跃会话数 & Token 消耗
 - 系统资源（CPU / 内存）
 - 已加载插件列表
 
@@ -68,7 +72,8 @@ openclaw plugins list | grep claw-camp
 
 ## 相关项目
 
-- [claw-camp/claw-hub](https://github.com/claw-camp/claw-hub) — Hub 服务端（自建用）
+- [claw-camp/claw-hub](https://github.com/claw-camp/claw-hub) — Hub 服务端（想自建的看这里）
+- [npmjs.com/@claw-camp/openclaw-plugin](https://www.npmjs.com/package/@claw-camp/openclaw-plugin) — npm 包
 
 ## License
 

package/index.ts

@@ -33,6 +33,11 @@ class ClawCampChannel {
   private reconnectTimeout: NodeJS.Timeout | null = null;
   private isShuttingDown = false;
   private reconnectAttempts = 0;
+  private channelRuntime: any = null;
+
+  setChannelRuntime(rt: any) {
+    this.channelRuntime = rt;
+  }
 
   constructor(api: OpenClawPluginApi, config: any) {
     this.api = api;
@@ -398,6 +403,12 @@ class ClawCampChannel {
           this.api.logger.error('[Claw Camp Channel] 任务执行失败:', String(e))
         );
         break;
+      case 'chat-message':
+        this.api.logger.info('[Claw Camp Channel] 收到聊天消息:', payload?.conversationId);
+        this.handleChatMessage(payload).catch((e) =>
+          this.api.logger.error('[Claw Camp Channel] 处理聊天消息失败:', String(e))
+        );
+        break;
       case 'registered':
         this.api.logger.info('[Claw Camp Channel] 注册成功:', payload?.id);
         break;
@@ -407,6 +418,80 @@ class ClawCampChannel {
     }
   }
 
+  async handleChatMessage(payload: any) {
+    const { conversationId, userId, username, content, sessionKey: rawSessionKey, msgId } = payload;
+    const botId = this.config.agentId;
+
+    if (!this.channelRuntime) {
+      this.api.logger.warn('[Claw Camp Channel] channelRuntime 未初始化，无法处理聊天消息');
+      // 降级：直接返回提示
+      this._sendRaw({
+        type: 'chat-reply',
+        payload: {
+          msgId,
+          conversationId,
+          sessionKey: rawSessionKey || `${botId}:direct:${userId}`,
+          reply: '抱歉，Agent 尚未就绪，请稍后再试。'
+        }
+      });
+      return;
+    }
+
+    const sessionKey = rawSessionKey || `claw-camp:direct:${userId}`;
+    const accountId = this.config.accountId || 'default';
+
+    const ctx = {
+      Body: content,
+      BodyForAgent: content,
+      From: userId,
+      To: botId,
+      SessionKey: sessionKey,
+      AccountId: accountId,
+      Channel: 'claw-camp',
+      // 可选：附加发言者名称作为上下文
+      ...(username ? { SenderName: username } : {}),
+    };
+
+    const cfg = this.api.config;
+
+    try {
+      await this.channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher({
+        ctx,
+        cfg,
+        dispatcherOptions: {
+          deliver: async (replyPayload: any) => {
+            // replyPayload 是文本块或 block 对象，统一取文本
+            const replyText = typeof replyPayload === 'string'
+              ? replyPayload
+              : replyPayload?.text ?? replyPayload?.content ?? JSON.stringify(replyPayload);
+
+            this._sendRaw({
+              type: 'chat-reply',
+              payload: {
+                msgId,
+                conversationId,
+                sessionKey,
+                reply: replyText
+              }
+            });
+          }
+        }
+      });
+    } catch (e) {
+      this.api.logger.error('[Claw Camp Channel] dispatchReply 失败:', String(e));
+      // 降级回复
+      this._sendRaw({
+        type: 'chat-reply',
+        payload: {
+          msgId,
+          conversationId,
+          sessionKey,
+          reply: `处理失败: ${e instanceof Error ? e.message : String(e)}`
+        }
+      });
+    }
+  }
+
   async executeTask(task: any) {
     const { action } = task;
     let result: any;
@@ -547,34 +632,8 @@ export default function (api: OpenClawPluginApi) {
 
   const channels = new Map<string, ClawCampChannel>();
 
-  const startChannels = () => {
-    const accounts = config.channels?.['claw-camp']?.accounts || {};
-    const accountKeys = Object.keys(accounts);
-
-    if (accountKeys.length === 0) {
-      logger.warn('[Claw Camp] 未配置 accounts，跳过连接');
-      return;
-    }
-
-    for (const accountKey of accountKeys) {
-      const accountConfig = accounts[accountKey];
-      const { botId, botToken } = accountConfig;
-      if (botId && botToken) {
-        const agentName = accountConfig.agentName || accountKey;
-        logger.info(`[Claw Camp] 启动连接: botId=${botId}, name=${agentName}`);
-        const channel = new ClawCampChannel(api, {
-          hubUrl: 'wss://camp.aigc.sx.cn/ws',
-          token: botToken,
-          agentId: botId,
-          agentName
-        });
-        channels.set(accountKey, channel);
-        channel.connect();
-      } else {
-        logger.warn(`[Claw Camp] account ${accountKey} 缺少 botId/botToken`);
-      }
-    }
-  };
+  // 注意：channelRuntime 通过 gateway.startAccount 传入
+  // 如果 startAccount 没被调用，channelRuntime 将不可用
 
   const stopAllChannels = () => {
     logger.info(`[Claw Camp] 停止 ${channels.size} 个连接...`);
@@ -585,14 +644,11 @@ export default function (api: OpenClawPluginApi) {
     channels.clear();
   };
 
-  // 注册 shutdown hook（只注册一次）
+  // 注册 shutdown hook
   process.once('SIGTERM', stopAllChannels);
   process.once('SIGINT', stopAllChannels);
   api.on?.('shutdown', stopAllChannels);
 
-  // 延迟启动，等 Gateway 完全就绪
-  setTimeout(startChannels, 2000);
-
   // 注册渠道
   if (api.registerChannel) {
     api.registerChannel({
@@ -642,6 +698,40 @@ export default function (api: OpenClawPluginApi) {
           listAccountIds: (cfg: any) => Object.keys(cfg?.accounts || {}),
           resolveAccount: (cfg: any, accountId: string) => cfg?.accounts?.[accountId] || null
         },
+        gateway: {
+          startAccount: async (ctx: any) => {
+            const { accountId, account, channelRuntime } = ctx;
+            const { botId, botToken, agentName } = account as any;
+            if (!botId || !botToken) {
+              logger.warn(`[Claw Camp] account ${accountId} 缺少 botId/botToken，跳过`);
+              return;
+            }
+            logger.info(`[Claw Camp] 启动连接: botId=${botId}, name=${agentName || accountId}`);
+            const channel = new ClawCampChannel(api, {
+              hubUrl: 'wss://camp.aigc.sx.cn/ws',
+              token: botToken,
+              agentId: botId,
+              agentName: agentName || accountId,
+              accountId,
+              botId,
+              botToken,
+            });
+            if (channelRuntime) {
+              channel.setChannelRuntime(channelRuntime);
+            } else {
+              logger.warn(`[Claw Camp] account ${accountId}: channelRuntime 不可用，聊天消息将降级处理`);
+            }
+            channels.set(accountId, channel);
+            channel.connect();
+          },
+          stopAccount: async (ctx: any) => {
+            const channel = channels.get(ctx.accountId);
+            if (channel) {
+              channel.disconnect();
+              channels.delete(ctx.accountId);
+            }
+          }
+        },
         onboarding: clawCampOnboardingAdapter,
         reload: { configPrefixes: ['channels.claw-camp'] }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claw-camp/openclaw-plugin",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Claw Camp plugin for OpenClaw - monitor your AI agents in real-time",
   "main": "index.ts",
   "keywords": ["openclaw", "plugin", "monitoring", "agent", "claw-camp"],