@wu529778790/open-im 1.8.3-beta.9 → 1.9.0

package/README.md

@@ -6,7 +6,7 @@ Multi-platform IM bridge for AI CLI tools. Connect Telegram, Feishu, WeCom, Ding
 
 ## Features
 
-- Multi-platform support: Telegram, Feishu, WeCom, DingTalk, QQ, and WeChat (experimental), with multiple platforms enabled at the same time
+- Multi-platform support: Telegram, Feishu, WeCom, DingTalk, QQ, WeChat (experimental), and WorkBuddy (WeChat KF via CodeBuddy), with multiple platforms enabled at the same time
 - Multiple AI tools: Claude, Codex, and CodeBuddy
 - Per-platform AI routing: each IM platform can use a different AI tool, with `aiCommand` as the global default and `platforms.<name>.aiCommand` as the override
 - Streaming replies: relay AI output and tool execution progress in real time (DingTalk streaming is not fully supported yet)
@@ -56,7 +56,7 @@ Open the config page at [`http://127.0.0.1:39282`](http://127.0.0.1:39282) (or t
 - **AI Tooling** – **General**: default AI tool (Claude / Codex / CodeBuddy), work directory, hook port, log level. **Per-tool tabs**: Claude (CLI path, timeout, proxy, config path, ANTHROPIC\_\* fields), Codex (CLI path, timeout, proxy), CodeBuddy (CLI path, timeout).
 - **Service control** – Validate config, Save, Start bridge, Stop bridge.
 
-WeChat is not in the web UI; configure it in `~/.open-im/config.json` or via `open-im init` if needed.
+WeChat and WorkBuddy are not in the web UI; configure them in `~/.open-im/config.json` or via `open-im init`.
 
 - `open-im start` serves both the config page and the bridge on your local machine.
 - `open-im dev` opens the page automatically only when setup is incomplete.
@@ -240,6 +240,14 @@ The following is valid JSON and can be saved directly as `~/.open-im/config.json
       "allowedUserIds": [],
       "appId": "YOUR_WECHAT_APP_ID",
       "appSecret": "YOUR_WECHAT_APP_SECRET"
+    },
+    "workbuddy": {
+      "enabled": false,
+      "aiCommand": "claude",
+      "allowedUserIds": [],
+      "accessToken": "",
+      "refreshToken": "",
+      "userId": ""
     }
   }
 }
@@ -287,6 +295,13 @@ The following is valid JSON and can be saved directly as `~/.open-im/config.json
 | `WECHAT_USER_ID`             | WeChat AGP mode user ID                                                |
 | `WECHAT_WS_URL`              | WeChat WebSocket URL                                                   |
 | `WECHAT_ALLOWED_USER_IDS`    | WeChat allowlist                                                       |
+| `WORKBUDDY_ACCESS_TOKEN`     | WorkBuddy OAuth access token (auto-generated by `open-im init`)        |
+| `WORKBUDDY_REFRESH_TOKEN`    | WorkBuddy OAuth refresh token (auto-generated by `open-im init`)       |
+| `WORKBUDDY_USER_ID`          | WorkBuddy user ID                                                      |
+| `WORKBUDDY_BASE_URL`         | WorkBuddy API base URL, defaults to `https://copilot.tencent.com`      |
+| `WORKBUDDY_GUID`             | WorkBuddy connection GUID (optional)                                   |
+| `WORKBUDDY_WORKSPACE_PATH`   | WorkBuddy workspace path (optional)                                    |
+| `WORKBUDDY_ALLOWED_USER_IDS` | WorkBuddy allowlist                                                    |
 
 ### Platform Setup Sources
 
@@ -296,6 +311,7 @@ The following is valid JSON and can be saved directly as `~/.open-im/config.json
 - DingTalk: create an internal enterprise app in DingTalk Open Platform, enable bot Stream Mode, and get the `Client ID` and `Client Secret`
 - WeCom: get the bot ID and secret from the [WeCom admin console](https://work.weixin.qq.com/)
 - WeChat: experimental, supports both standard mode and AGP/Qclaw-related settings
+- WorkBuddy: connects via CodeBuddy (copilot.tencent.com) Centrifuge WebSocket; run `open-im init` and select "WorkBuddy 微信客服 (WeChat KF)" to complete OAuth login and WeChat KF binding
 
 Notes on DingTalk: the current implementation uses a hybrid model of "Stream Mode for receiving messages + OpenAPI for sending messages".
 
@@ -337,6 +353,10 @@ DingTalk AI card templates are already compatible with the official "Search Resu
 
 **CodeBuddy prompts for login**: run `codebuddy login` first. `open-im` does not read CodeBuddy login state from `~/.open-im/config.json`.
 
+**WorkBuddy cannot connect**: run `open-im init` to re-authenticate. Tokens may expire — the client will attempt auto-reconnect, but if the refresh token is invalid, a fresh login is required.
+
+**WorkBuddy WeChat KF not receiving messages**: ensure the WeChat KF binding was completed during `open-im init`. You can re-run init to generate a new binding link.
+
 ## License
 
 [MIT](LICENSE)

package/README.zh-CN.md

@@ -6,7 +6,7 @@
 
 ## 功能特性
 
-- 多平台：支持 Telegram、飞书、企业微信、钉钉、QQ、微信（测试中），可同时启用
+- 多平台：支持 Telegram、飞书、企业微信、钉钉、QQ、微信（测试中）、WorkBuddy（通过 CodeBuddy 接入微信客服），可同时启用
 - 多 AI 工具：支持 Claude、Codex、CodeBuddy
 - 按平台分配 AI：根级 `aiCommand` 作为默认值，`platforms.<name>.aiCommand` 可为不同 IM 单独指定 AI 工具
 - 流式输出：实时回传 AI 回复与工具执行进度（目前钉钉暂未实现流式传输）
@@ -62,7 +62,7 @@ open-im start
 - **AI 工具配置** – **公共**：默认 AI 工具（Claude / Codex / CodeBuddy）、工作目录、Hook 端口、日志级别。**分工具**：Claude（CLI 路径、超时、代理、配置路径、ANTHROPIC\_\* 等）、Codex（CLI 路径、超时、代理）、CodeBuddy（CLI 路径、超时）
 - **服务控制** – 校验配置、保存、启动桥接、停止桥接
 
-微信暂不在网页中配置，如需使用请在 `~/.open-im/config.json` 中手动配置或通过 `open-im init` 引导。
+微信和 WorkBuddy 暂不在网页中配置，如需使用请在 `~/.open-im/config.json` 中手动配置或通过 `open-im init` 引导。
 
 - `open-im start` 会同时启动桥接服务并提供该配置页（本机场景）。
 - `open-im dev` 仅在未完成配置时自动打开页面。
@@ -246,6 +246,14 @@ codebuddy login
       "allowedUserIds": [],
       "appId": "YOUR_WECHAT_APP_ID",
       "appSecret": "YOUR_WECHAT_APP_SECRET"
+    },
+    "workbuddy": {
+      "enabled": false,
+      "aiCommand": "claude",
+      "allowedUserIds": [],
+      "accessToken": "",
+      "refreshToken": "",
+      "userId": ""
     }
   }
 }
@@ -293,6 +301,13 @@ codebuddy login
 | `WECHAT_USER_ID`             | 微信 AGP 模式 User ID                          |
 | `WECHAT_WS_URL`              | 微信 WebSocket 地址                            |
 | `WECHAT_ALLOWED_USER_IDS`    | 微信白名单                                     |
+| `WORKBUDDY_ACCESS_TOKEN`     | WorkBuddy OAuth 访问令牌（由 `open-im init` 自动生成） |
+| `WORKBUDDY_REFRESH_TOKEN`    | WorkBuddy OAuth 刷新令牌（由 `open-im init` 自动生成） |
+| `WORKBUDDY_USER_ID`          | WorkBuddy 用户 ID                              |
+| `WORKBUDDY_BASE_URL`         | WorkBuddy API 地址，默认 `https://copilot.tencent.com` |
+| `WORKBUDDY_GUID`             | WorkBuddy 连接 GUID（可选）                    |
+| `WORKBUDDY_WORKSPACE_PATH`   | WorkBuddy 工作区路径（可选）                   |
+| `WORKBUDDY_ALLOWED_USER_IDS` | WorkBuddy 白名单                               |
 
 ### 平台配置来源
 
@@ -302,6 +317,7 @@ codebuddy login
 - 钉钉：从钉钉开放平台创建企业内部应用，启用机器人 Stream Mode，获取 `Client ID` 和 `Client Secret`
 - 企业微信：从 [企业微信管理后台](https://work.weixin.qq.com/) 获取 Bot ID 和 Secret
 - 微信：测试中，支持标准模式和 AGP/Qclaw 相关配置
+- WorkBuddy：通过 CodeBuddy（copilot.tencent.com）Centrifuge WebSocket 接入微信客服；运行 `open-im init` 并选择 "WorkBuddy 微信客服 (WeChat KF)" 完成 OAuth 登录和微信客服绑定
 
 说明：钉钉当前采用“Stream Mode 收消息 + OpenAPI 发送消息”的混合模式。
 
@@ -343,6 +359,10 @@ codebuddy login
 
 **CodeBuddy 提示需要登录**：先执行 `codebuddy login`。`open-im` 不会从 `~/.open-im/config.json` 读取 CodeBuddy 的登录态。
 
+**WorkBuddy 无法连接**：重新运行 `open-im init` 登录。Token 可能过期——客户端会尝试自动重连，但如果 refresh token 失效，需要重新登录。
+
+**WorkBuddy 微信客服收不到消息**：确认在 `open-im init` 中完成了微信客服绑定。可重新运行 init 生成新的绑定链接。
+
 ## License
 
 [MIT](LICENSE)

package/dist/setup.js

@@ -442,6 +442,8 @@ export async function runInteractiveSetup() {
         }, { onCancel });
         if (wbModeResp.mode === "oauth") {
             console.log("\n正在启动 WorkBuddy OAuth 登录...\n");
+            // Phase 1: OAuth token acquisition (fatal if fails)
+            let oauthOk = false;
             try {
                 const { WorkBuddyOAuth } = await import("./workbuddy/oauth.js");
                 const oauth = new WorkBuddyOAuth();
@@ -459,39 +461,58 @@ export async function runInteractiveSetup() {
                 catch {
                     // account info is optional
                 }
-                const userId = accountInfo?.uid?.toString() ?? "";
+                const ai = accountInfo;
+                // Try multiple field names; fall back to tokenResult.userId, then existing config
+                const existingUserId = wb?.userId;
+                const userId = String(ai?.uid ?? ai?.userId ?? ai?.user_id ??
+                    tokenResult.userId ??
+                    existingUserId ?? "");
+                if (!userId) {
+                    console.warn("⚠️ 未能获取 WorkBuddy 用户 ID，sessionId 可能不正确，建议稍后重试");
+                }
                 // Set oauth.userId so buildSessionId() produces the correct sessionId.
                 oauth.userId = userId;
+                console.log(`   userId: ${userId || "(空)"}, sessionId 将为: ${oauth.buildSessionId()}`);
+                // Save credentials immediately — even if binding fails below
                 config.platforms.workbuddy = {
                     enabled: true,
                     accessToken: tokenResult.accessToken,
                     refreshToken: tokenResult.refreshToken,
                     userId,
                 };
-                console.log("\n正在获取微信客服绑定链接...");
-                const sessionId = oauth.buildSessionId();
-                const linkResult = await oauth.getWeChatKfLink(sessionId);
-                if (linkResult.success && linkResult.url) {
-                    console.log("\n━━━ 微信客服绑定 ━━━");
-                    console.log("请复制以下链接，在微信中发给「文件传输助手」并点击打开：");
-                    console.log(linkResult.url);
-                    console.log("\n等待绑定完成（最长 5 分钟）...\n");
-                    const bindResult = await oauth.pollBindStatus(sessionId);
-                    if (bindResult.bound) {
-                        console.log(`✅ 微信客服绑定成功！${bindResult.nickname ? ` 用户: ${bindResult.nickname}` : ""}`);
+                oauthOk = true;
+                console.log("\n✅ WorkBuddy 凭证已获取，正在生成微信客服绑定链接...");
+                // Phase 2: WeChat KF binding link (non-fatal, no polling needed)
+                try {
+                    const { join: pathJoin } = await import("node:path");
+                    const { homedir } = await import("node:os");
+                    const clawPath = pathJoin(homedir(), "WorkBuddy", "Claw");
+                    const sessionId = oauth.buildSessionId(clawPath);
+                    const linkResult = await oauth.getWeChatKfLink(sessionId);
+                    if (linkResult.success && linkResult.url) {
+                        console.log("\n━━━ 微信客服绑定 ━━━");
+                        console.log("请将以下链接发给微信「文件传输助手」并点击打开，即完成绑定：");
+                        console.log(linkResult.url);
+                        console.log("\n绑定完成后运行 open-im start 启动服务即可收发消息。");
                     }
                     else {
-                        console.log("⚠️ 绑定超时，你可以稍后重新运行 open-im init 完成绑定");
+                        console.log(`⚠️ 获取微信客服链接失败: ${linkResult.message ?? "未知错误"}`);
+                        console.log("   凭证已保存，稍后重新运行 open-im init 可重试绑定");
                     }
                 }
-                else {
-                    console.log("⚠️ 获取微信客服链接失败，你可以稍后重新运行 open-im init 完成绑定");
+                catch (bindErr) {
+                    const cause = bindErr?.cause ?? bindErr?.code;
+                    const detail = cause ? ` (${cause})` : "";
+                    console.log(`⚠️ 获取微信客服绑定链接网络失败: ${bindErr instanceof Error ? bindErr.message : String(bindErr)}${detail}`);
+                    console.log("   凭证已保存，稍后重新运行 open-im init 可重试绑定");
                 }
                 console.log("\n✅ WorkBuddy 登录成功，配置已保存");
             }
             catch (err) {
-                console.error("\n❌ WorkBuddy 登录失败:", err instanceof Error ? err.message : String(err));
-                if (platform === "workbuddy")
+                const cause = err?.cause ?? err?.code;
+                const detail = cause ? ` (${cause})` : "";
+                console.error(`\n❌ WorkBuddy 登录失败: ${err instanceof Error ? err.message : String(err)}${detail}`);
+                if (!oauthOk && platform === "workbuddy")
                     return false;
             }
         }
@@ -500,6 +521,37 @@ export async function runInteractiveSetup() {
                 ...wb,
                 enabled: true,
             };
+            // Also (re-)generate the WeChat KF binding link with existing credentials
+            try {
+                const { WorkBuddyOAuth } = await import("./workbuddy/oauth.js");
+                const oauthKeep = new WorkBuddyOAuth(wb?.baseUrl);
+                oauthKeep.loadCredentials({
+                    accessToken: wb?.accessToken ?? '',
+                    refreshToken: wb?.refreshToken ?? '',
+                    userId: wb?.userId ?? '',
+                });
+                oauthKeep.userId = wb?.userId ?? '';
+                const { join: pathJoin2 } = await import("node:path");
+                const { homedir: homedir2 } = await import("node:os");
+                const clawPath2 = pathJoin2(homedir2(), "WorkBuddy", "Claw");
+                const sessionId = oauthKeep.buildSessionId(clawPath2);
+                console.log(`\n正在获取微信客服绑定链接... (sessionId: ${sessionId})`);
+                const linkResult = await oauthKeep.getWeChatKfLink(sessionId);
+                if (linkResult.success && linkResult.url) {
+                    console.log("\n━━━ 微信客服绑定 ━━━");
+                    console.log("请将以下链接发给微信「文件传输助手」并点击打开，即完成绑定：");
+                    console.log(linkResult.url);
+                    console.log("\n绑定完成后运行 open-im start 启动服务即可收发消息。");
+                }
+                else {
+                    console.log(`⚠️ 获取绑定链接失败: ${linkResult.message ?? "未知"}`);
+                }
+            }
+            catch (keepErr) {
+                const cause = keepErr?.cause ?? keepErr?.code;
+                console.log(`⚠️ 绑定链接请求失败: ${keepErr instanceof Error ? keepErr.message : String(keepErr)}${cause ? ` (${cause})` : ""}`);
+                console.log("   稍后重新运行 open-im init 可重试");
+            }
         }
         else if (platform === "workbuddy") {
             return false;

package/dist/workbuddy/centrifuge-client.d.ts

@@ -13,6 +13,13 @@ export interface CentrifugeClientConfig {
     httpBaseUrl?: string;
     httpAccessToken?: string;
     workspaceSessionId?: string;
+    /**
+     * Called before sending a WeChat KF reply to update the channel's channelId
+     * to the current WeChat user's externalUserId.  The WorkBuddy server uses the
+     * registered channelId as the WeChat send_msg `touser`, so this must match the
+     * customer we are replying to.
+     */
+    registerChannelFn?: (externalUserId: string) => Promise<void>;
 }
 /** Client callbacks */
 export interface CentrifugeCallbacks {
@@ -58,7 +65,7 @@ export declare class WorkBuddyCentrifugeClient {
     /**
      * Send prompt response (for WeChat KF, use HTTP instead)
      */
-    sendPromptResponse(payload: PromptResponsePayload, _guid?: string, _userId?: string): void;
+    sendPromptResponse(payload: PromptResponsePayload, _guid?: string, _userId?: string): Promise<void>;
     /**
      * Handle incoming publication from Centrifuge
      */

package/dist/workbuddy/centrifuge-client.js

@@ -141,38 +141,47 @@ export class WorkBuddyCentrifugeClient {
     /**
      * Send prompt response (for WeChat KF, use HTTP instead)
      */
-    sendPromptResponse(payload, _guid, _userId) {
+    async sendPromptResponse(payload, _guid, _userId) {
         // WeChat KF messages: send via HTTP COPILOT_RESPONSE
         if (this.config.httpBaseUrl && this.config.httpAccessToken) {
             const message = payload.content?.map((c) => c.text).join('') || payload.error || '';
-            // chatId format: "<wechatUserId>::origin::wechatkfProxy"
-            // Extract user ID for toUser field; keep full chatId for routing.
-            const chatIdFull = payload.session_id;
-            const toUser = chatIdFull.includes('::') ? chatIdFull.split('::')[0] : chatIdFull;
+            const sessionId = payload.session_id; // e.g. "wmXXX::origin::wechatkfProxy"
+            // The WorkBuddy server uses the registered channelId as the WeChat KF send_msg
+            // `touser`.  Re-register the channel with the current WeChat user's externalUserId
+            // so that the server sends the reply to the correct customer.
+            if (this.config.registerChannelFn && sessionId.includes('::')) {
+                const externalUserId = sessionId.split('::')[0];
+                try {
+                    await this.config.registerChannelFn(externalUserId);
+                }
+                catch (err) {
+                    log.warn(`${this.logPrefix} registerChannelFn failed (reply may go to wrong user):`, err);
+                }
+            }
             const httpPayload = {
                 type: 'COPILOT_RESPONSE',
                 msgId: payload.prompt_id,
-                chatId: chatIdFull,
-                toUser,
+                chatId: sessionId,
                 success: payload.stop_reason === 'end_turn',
                 message,
                 metadata: {
-                    sessionId: this.config.workspaceSessionId || payload.session_id,
-                    toUser,
+                    sessionId: this.config.workspaceSessionId || sessionId,
+                    requestId: payload.prompt_id,
+                    state: payload.stop_reason === 'end_turn' ? 'completed' : payload.stop_reason,
                 },
             };
             const url = `${this.config.httpBaseUrl}/v2/backgroundagent/wecom/local-proxy/receive`;
-            log.debug(`${this.logPrefix} HTTP COPILOT_RESPONSE → ${url} chatId=${payload.session_id} msgLen=${message.length}`);
-            fetch(url, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    Authorization: `Bearer ${this.config.httpAccessToken}`,
-                },
-                body: JSON.stringify(httpPayload),
-                signal: AbortSignal.timeout(30_000),
-            })
-                .then(async (res) => {
+            log.debug(`${this.logPrefix} HTTP COPILOT_RESPONSE → ${url} chatId=${sessionId} msgLen=${message.length}`);
+            try {
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Authorization: `Bearer ${this.config.httpAccessToken}`,
+                    },
+                    body: JSON.stringify(httpPayload),
+                    signal: AbortSignal.timeout(30_000),
+                });
                 const body = await res.text().catch(() => '');
                 if (!res.ok) {
                     log.error(`${this.logPrefix} HTTP COPILOT_RESPONSE failed: ${res.status} ${body.substring(0, 300)}`);
@@ -180,10 +189,10 @@ export class WorkBuddyCentrifugeClient {
                 else {
                     log.info(`${this.logPrefix} HTTP COPILOT_RESPONSE ok: ${res.status} ${body.substring(0, 200)}`);
                 }
-            })
-                .catch((err) => {
+            }
+            catch (err) {
                 log.error(`${this.logPrefix} HTTP COPILOT_RESPONSE error:`, err);
-            });
+            }
             return;
         }
         this.sendEnvelope('session.promptResponse', payload, _guid, _userId);

package/dist/workbuddy/client.js

@@ -7,7 +7,7 @@
 import { randomUUID } from 'node:crypto';
 import { existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
-import { hostname } from 'node:os';
+import { hostname, homedir } from 'node:os';
 import { createLogger } from '../logger.js';
 import { WorkBuddyOAuth } from './oauth.js';
 import { WorkBuddyCentrifugeClient } from './centrifuge-client.js';
@@ -62,31 +62,46 @@ async function connect() {
     const pc = platformConfig;
     const baseUrl = pc.baseUrl ?? 'https://copilot.tencent.com';
     const hostId = hostname();
-    const stableWorkspaceId = `${pc.userId}-open-im-workbuddy`;
-    log.info('Registering WorkBuddy workspace...');
+    // Claw workspace path — matches the plugin's WorkBuddy Claw installation path.
+    // The directory does NOT need to exist; the server uses it as a string identifier.
+    const clawPath = join(homedir(), 'WorkBuddy', 'Claw');
+    log.info('Registering WorkBuddy host workspace...');
     let tokens;
     try {
+        // Step 1: Register host workspace (workspaceId="") — gets the Centrifuge connection
         tokens = await oauth.registerWorkspace({
             userId: pc.userId ?? '',
             hostId,
-            workspaceId: stableWorkspaceId,
-            workspaceName: 'open-im-workbuddy',
+            workspaceId: '',
+            workspaceName: 'Host Channel',
         });
     }
     catch (err) {
-        log.error('Workspace registration failed:', err);
+        log.error('Host workspace registration failed:', err);
         scheduleReconnect();
         return;
     }
-    // sessionId ≤64 chars (WeChat KF uses it as `touser`)
-    const workspaceSessionId = oauth.buildSessionId();
+    // sessionId = userId_hostId_clawPath (matches plugin's buildSessionId format)
+    const workspaceSessionId = oauth.buildSessionId(clawPath);
     const channel = tokens.channel;
     const guid = pc.guid ?? randomUUID();
-    log.info(`Workspace registered: channel=${channel}, sessionId=${workspaceSessionId}`);
+    log.info(`Host workspace registered: channel=${channel}, clawSessionId=${workspaceSessionId}`);
     if (centrifugeClient) {
         centrifugeClient.stop();
         centrifugeClient = null;
     }
+    // Re-registers the WeChat KF channel with the given externalUserId as channelId.
+    // The WorkBuddy server uses channelId as the WeChat send_msg `touser`, so this
+    // must be called with the customer's external_userid before sending each reply.
+    const registerChannelFn = async (externalUserId) => {
+        const clawSessionId = oauth.buildSessionId(clawPath);
+        await oauth.registerChannel({
+            type: 'wechatkf',
+            sessionId: clawSessionId,
+            channelId: externalUserId,
+            userId: pc.userId ?? '',
+        });
+    };
     centrifugeClient = new WorkBuddyCentrifugeClient({
         url: tokens.url,
         connectionToken: tokens.connectionToken,
@@ -97,28 +112,60 @@ async function connect() {
         httpBaseUrl: baseUrl,
         httpAccessToken: pc.accessToken ?? '',
         workspaceSessionId,
+        registerChannelFn,
     }, {
         onConnected: () => {
             log.info('WorkBuddy Centrifuge connected');
-            log.info(`sessionId (must match WeChat KF binding): ${workspaceSessionId}`);
+            log.info(`WeChat KF sessionId: ${workspaceSessionId}`);
             reconnectAttempt = 0;
             updateState('connected');
-            const doRegister = () => {
-                if (stopped || channelState !== 'connected')
-                    return;
-                oauth.registerChannel({
-                    type: 'wechatkf',
-                    sessionId: workspaceSessionId,
-                    channelId: channel,
-                    userId: pc.userId ?? '',
-                })
-                    .then((res) => log.info(`WeChat KF channel registered (online): ${JSON.stringify(res)}`))
-                    .catch((err) => log.warn(`registerChannel failed: ${String(err)}`));
-            };
-            doRegister();
-            if (heartbeatTimer)
-                clearInterval(heartbeatTimer);
-            heartbeatTimer = setInterval(doRegister, CHANNEL_HEARTBEAT_MS);
+            // Step 2: Register Claw workspace to get WeChat KF routing channel + sessionId
+            oauth.registerWorkspace({
+                userId: pc.userId ?? '',
+                hostId,
+                workspaceId: clawPath,
+                workspaceName: 'Claw',
+            }).then((clawParams) => {
+                const clawSessionId = clawParams.sessionId ?? workspaceSessionId;
+                log.info(`Claw workspace registered: channel=${clawParams.channel}, sessionId=${clawSessionId}`);
+                // Subscribe to Claw channel — WeChat KF messages are published here
+                centrifugeClient?.subscribeChannel(clawParams.channel, clawParams.subscriptionToken);
+                const doRegister = () => {
+                    if (stopped || channelState !== 'connected')
+                        return;
+                    oauth.registerChannel({
+                        type: 'wechatkf',
+                        sessionId: clawSessionId,
+                        channelId: pc.userId ?? '', // plugin uses userId, not full channel name
+                        userId: pc.userId ?? '',
+                    })
+                        .then((res) => log.info(`WeChat KF channel registered (online): ${JSON.stringify(res)}`))
+                        .catch((err) => log.warn(`registerChannel failed: ${String(err)}`));
+                };
+                doRegister();
+                if (heartbeatTimer)
+                    clearInterval(heartbeatTimer);
+                heartbeatTimer = setInterval(doRegister, CHANNEL_HEARTBEAT_MS);
+            }).catch((err) => {
+                log.error('Claw workspace registration failed:', err);
+                // Fallback: register with host sessionId
+                const doRegister = () => {
+                    if (stopped || channelState !== 'connected')
+                        return;
+                    oauth.registerChannel({
+                        type: 'wechatkf',
+                        sessionId: workspaceSessionId,
+                        channelId: pc.userId ?? '',
+                        userId: pc.userId ?? '',
+                    })
+                        .then((res) => log.info(`WeChat KF channel registered (fallback): ${JSON.stringify(res)}`))
+                        .catch((e) => log.warn(`registerChannel failed: ${String(e)}`));
+                };
+                doRegister();
+                if (heartbeatTimer)
+                    clearInterval(heartbeatTimer);
+                heartbeatTimer = setInterval(doRegister, CHANNEL_HEARTBEAT_MS);
+            });
         },
         onDisconnected: (reason) => {
             log.info(`WorkBuddy Centrifuge disconnected: ${reason}`);

package/dist/workbuddy/message-sender.js

@@ -14,7 +14,7 @@ export async function sendTextReply(_client, chatId, text, msgId) {
         return;
     }
     log.info(`Sending WorkBuddy reply to chatId=${chatId}, msgId=${msgId}`);
-    client.sendPromptResponse({
+    await client.sendPromptResponse({
         session_id: chatId,
         prompt_id: msgId,
         content: [{ type: 'text', text }],
@@ -31,7 +31,7 @@ export async function sendErrorReply(_client, chatId, error, msgId) {
         return;
     }
     log.info(`Sending WorkBuddy error to chatId=${chatId}, msgId=${msgId}`);
-    client.sendPromptResponse({
+    await client.sendPromptResponse({
         session_id: chatId,
         prompt_id: msgId,
         error,

package/dist/workbuddy/oauth.d.ts

@@ -39,7 +39,7 @@ export declare class WorkBuddyOAuth {
     /**
      * Build sessionId for WorkBuddy workspace
      */
-    buildSessionId(_workspacePath?: string): string;
+    buildSessionId(workspacePath?: string): string;
     /**
      * Get WeChat KF binding link
      */

package/dist/workbuddy/oauth.js

@@ -174,10 +174,10 @@ export class WorkBuddyOAuth {
     /**
      * Build sessionId for WorkBuddy workspace
      */
-    buildSessionId(_workspacePath) {
-        // Keep session ID ≤64 chars: WeChat KF uses it as `touser` in send_msg.
-        // userId (36) + "_" + hostId (≤26) is always well under the 64-char limit.
-        return `${this.userId}_${this.hostId}`;
+    buildSessionId(workspacePath) {
+        // Must match the plugin's format: ${userId}_${hostId}_${workspacePath}
+        // The server uses this as the chatId/routing key for WeChat KF messages.
+        return `${this.userId}_${this.hostId}_${workspacePath ?? ''}`;
     }
     /**
      * Get WeChat KF binding link

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wu529778790/open-im",
-  "version": "1.8.3-beta.9",
+  "version": "1.9.0",
   "description": "Multi-platform IM bridge for AI CLI tools (Claude, Codex, CodeBuddy)",
   "type": "module",
   "main": "dist/index.js",