@53ai/53ai-openclaw 1.0.6 → 1.0.8

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [1.0.7] - 2026-03-19
+
+### Changed
+- 规范配置项命名：将 `websocketUrl` 统一更名为 `WSUrl`。
+- 文档更新：优化了 README.md 中的参数说明。
+
 ## [1.0.6] - 2026-03-19
 
 ### Changed

package/README.md

@@ -83,9 +83,9 @@ openclaw gateway restart
 sudo systemctl restart openclaw-gateway
 
 # 配置必要参数
-openclaw config set channels.53aihub.botId "智能体详情的botId"
-openclaw config set channels.53aihub.secret "智能体详情的botId对应的secret"
-openclaw config set channels.53aihub.websocketUrl "ws://域名/api/v1/openclaw/ws/connect"
+openclaw config set channels.53aihub.botId "智能体的botId"
+openclaw config set channels.53aihub.secret "智能体对应的secret"
+openclaw config set channels.53aihub.WSUrl "ws:/你的域名/api/v1/openclaw/ws/connect"
 
 # 启用通道
 openclaw config set channels.53aihub.enabled true
@@ -95,9 +95,9 @@ openclaw config set channels.53aihub.enabled true
 
 | 参数 | 必填 | 默认值 | 说明 |
 |------|------|--------|------|
-| `botId` | 是 | - | 53AIHub 智能体 ID  |
-| `secret` | 是 | - | 53AIHub Secret |
-| `websocketUrl` | 是 | - | 53AIHub 长连接连接地址 |
+| `botId` | 是 | - | 智能体的ID  |
+| `secret` | 是 | - | 智能体的Secret |
+| `WSUrl` | 是 | - | 53AIHub平台的WS地址 |
 | `token` | 否 | - | secret 的别名，与 secret 二选一 |
 | `enabled` | 否 | false | 是否启用通道 |
 | `accessPolicy` | 否 | `open` | 访问策略: `open`=开放所有用户, `allowlist`=仅白名单用户, `pairing`=首次使用需审批, `disabled`=禁用 |
@@ -142,8 +142,8 @@ openclaw plugins list | grep 53aihub
 # 检查通道配置
 openclaw config get channels.53aihub
 
-# 检查 Gateway 日志
-openclaw gateway logs | grep -i 53aihub
+# 检查 Gateway 日志 (用户级服务)
+journalctl --user -u openclaw-gateway.service -f | grep -i 53aihub
 ```
 
 ## 多模态消息支持
@@ -397,7 +397,7 @@ npm test
 
 1. 确认 `openclaw.plugin.json` 存在于插件根目录
 2. 确认 `dist/` 目录包含编译后的文件
-3. 检查 Gateway 日志: `openclaw gateway logs`
+3. 检查 Gateway 日志: `journalctl --user -u openclaw-gateway.service -f`
 
 ### 通道未生效
 
@@ -407,7 +407,7 @@ npm test
 
 ### WebSocket 连接失败
 
-1. 检查 `websocketUrl` 格式是否正确
+1. 检查 `WSUrl` 格式是否正确
 2. 确认网络可达性
 3. 检查 `botId` 和 `secret` 是否正确
 

package/dist/index.cjs.js

@@ -334,7 +334,7 @@ function parseMessageContent(msg) {
 }
 
 async function sendReply(params) {
-    const { wsClient, text, toChatId, replyToMsgId, runtime, finish, streamId, isError, errorCode, errorDetails } = params;
+    const { wsClient, text, toChatId, replyToMsgId, runtime, finish, streamId, isError, errorCode, errorDetails, isThinking } = params;
     const reqId = replyToMsgId || streamId;
     runtime.log?.(`[53aihub] sendReply START: reqId=${reqId}, finish=${finish}, isError=${isError}, textLen=${text?.length || 0}, wsReadyState=${wsClient.readyState}`);
     if (wsClient.readyState !== 1) {
@@ -395,7 +395,7 @@ async function sendReply(params) {
     const payload = {
         req_id: reqId,
         action: "chat",
-        status: finish ? "done" : "streaming",
+        status: finish ? "done" : isThinking ? "thinking" : "streaming",
         data: chunk,
     };
     const jsonStr = JSON.stringify(payload);
@@ -973,7 +973,6 @@ async function processMessage(params) {
             cfg: config,
             dispatcherOptions: {
                 deliver: async (payload, info) => {
-                    state.accumulatedText += payload.text;
                     runtime.log?.(`[53aihub] deliver: kind=${info.kind}, textLen=${payload.text?.length || 0}, accumulatedLen=${state.accumulatedText.length}, isError=${payload.isError}`);
                     if (payload.isError) {
                         const errorMsg = payload.text || "Unknown error";
@@ -993,6 +992,23 @@ async function processMessage(params) {
                         });
                         return;
                     }
+                    const isCompaction = payload.text?.startsWith("🧹 Compacting context") ||
+                        state.accumulatedText.startsWith("🧹 Compacting context");
+                    if (isCompaction && info.kind !== "final") {
+                        runtime.log?.(`[53aihub] deliver COMPACTION: text preview=${payload.text?.substring(0, 50)}...`);
+                        await sendReply({
+                            wsClient,
+                            text: payload.text || "",
+                            toChatId: chatId,
+                            replyToMsgId: body.msgId,
+                            runtime,
+                            finish: false,
+                            streamId: state.streamId,
+                            isThinking: true,
+                        });
+                        return;
+                    }
+                    state.accumulatedText += payload.text;
                     if (info.kind !== "final") {
                         runtime.log?.(`[53aihub] deliver STREAMING: accumulatedText preview=${state.accumulatedText.substring(0, 50)}...`);
                         await sendReply({
@@ -1108,7 +1124,7 @@ async function monitorProvider(options) {
             if (isAborted)
                 return;
             // 安全: 不在 URL 中传递敏感信息，仅通过 headers 传递认证
-            const wsUrl = account.websocketUrl;
+            const wsUrl = account.WSUrl;
             const botId = account.botId || account.config.botId;
             const secret = account.secret || account.token || account.config.secret || account.config.token;
             // 日志输出时隐藏敏感信息
@@ -1207,7 +1223,7 @@ function resolveAccount(cfg, accountId = pluginSdk.DEFAULT_ACCOUNT_ID) {
         accountId,
         name: config.name ?? "53AIHub",
         enabled: config.enabled !== false,
-        websocketUrl: config.websocketUrl || DEFAULT_WS_URL,
+        WSUrl: config.WSUrl || DEFAULT_WS_URL,
         botId: config.botId ?? config.userId ?? "",
         secret: config.secret ?? config.token ?? "",
         token: config.token ?? config.secret ?? "",
@@ -1228,8 +1244,8 @@ function setAccount(cfg, account) {
         allowFrom: account.allowFrom ?? existing.allowFrom,
         accessPolicy: account.accessPolicy ?? existing.accessPolicy,
         sendThinkingMessage: account.sendThinkingMessage ?? existing.sendThinkingMessage,
-        ...(account.websocketUrl || existing.websocketUrl
-            ? { websocketUrl: account.websocketUrl ?? existing.websocketUrl }
+        ...(account.WSUrl || existing.WSUrl
+            ? { WSUrl: account.WSUrl ?? existing.WSUrl }
             : {}),
         ...(account.name || existing.name
             ? { name: account.name ?? existing.name }
@@ -1267,10 +1283,10 @@ async function promptSecret(prompter, account) {
         validate: (value) => (value?.trim() ? undefined : "必填"),
     })).trim();
 }
-async function promptWebsocketUrl(prompter, account) {
+async function promptWSUrl(prompter, account) {
     return String(await prompter.text({
         message: "WebSocket URL (例如: ws://localhost:8080/ws)",
-        initialValue: account?.websocketUrl ?? "",
+        initialValue: account?.WSUrl ?? "",
         validate: (value) => {
             const trimmed = value?.trim();
             if (!trimmed)
@@ -1340,11 +1356,11 @@ const aiHubOnboardingAdapter = {
         }
         const botId = await promptBotId(prompter, account);
         const secret = await promptSecret(prompter, account);
-        const websocketUrl = await promptWebsocketUrl(prompter, account);
+        const WSUrl = await promptWSUrl(prompter, account);
         const cfgWithAccount = setAccount(cfg, {
             botId,
             secret,
-            websocketUrl: websocketUrl || undefined,
+            WSUrl: WSUrl || undefined,
             enabled: true,
             accessPolicy: account.config.accessPolicy ?? "open",
             allowFrom: account.config.allowFrom ?? [],
@@ -1423,7 +1439,7 @@ const aiHubPlugin = {
             enabled: account.enabled,
             configured: Boolean(account.botId?.trim() || account.token?.trim()),
             botId: account.botId,
-            websocketUrl: account.websocketUrl,
+            WSUrl: account.WSUrl,
             accessPolicy: account.config.accessPolicy ?? "open",
         }),
         resolveAllowFrom: ({ cfg }) => {
@@ -1592,6 +1608,67 @@ const aiHubPlugin = {
     },
 };
 
+const compactionSessions = new Map();
+/**
+ * 从 sessionKey 中解析 chatId
+ * sessionKey 格式: agent:{agentId}:{channel}:direct:{chatId}
+ * 例如: agent:main:53aihub:direct:user123 -> user123
+ */
+function parseChatIdFromSessionKey(sessionKey) {
+    if (!sessionKey)
+        return null;
+    const parts = sessionKey.split(":");
+    // 格式: agent:{agentId}:{channel}:direct:{chatId}
+    // parts: [0]agent, [1]agentId, [2]channel, [3]direct, [4]chatId
+    if (parts.length >= 5 && parts[2] === CHANNEL_ID && parts[3] === "direct") {
+        return parts[4];
+    }
+    return null;
+}
+async function handleBeforeCompaction(event, ctx) {
+    const runtime = getRuntime();
+    const logger = runtime.logging.getChildLogger({ component: "53aihub-compaction" });
+    const log = (msg) => logger.info(msg);
+    log(`before_compaction: sessionKey=${ctx.sessionKey}, channelId=${ctx.channelId}, messageCount=${event.messageCount}`);
+    const sessionKey = ctx.sessionKey || "";
+    if (!sessionKey.startsWith(`${CHANNEL_ID}:`) && !sessionKey.includes(`:${CHANNEL_ID}:`)) {
+        log(`Skipping compaction hook for non-53aihub session: ${sessionKey}`);
+        return;
+    }
+    const chatId = parseChatIdFromSessionKey(sessionKey);
+    if (!chatId) {
+        logger.error(`Cannot parse chatId from sessionKey: ${sessionKey}`);
+        return;
+    }
+    compactionSessions.set(sessionKey, {
+        startTime: Date.now(),
+        messageCount: event.messageCount,
+    });
+    log(`Compaction started for chatId=${chatId}`);
+}
+async function handleAfterCompaction(event, ctx) {
+    const runtime = getRuntime();
+    const logger = runtime.logging.getChildLogger({ component: "53aihub-compaction" });
+    const log = (msg) => logger.info(msg);
+    log(`after_compaction: sessionKey=${ctx.sessionKey}, channelId=${ctx.channelId}, messageCount=${event.messageCount}, compactedCount=${event.compactedCount}`);
+    const sessionKey = ctx.sessionKey || "";
+    if (!sessionKey.startsWith(`${CHANNEL_ID}:`) && !sessionKey.includes(`:${CHANNEL_ID}:`)) {
+        log(`Skipping compaction hook for non-53aihub session: ${sessionKey}`);
+        return;
+    }
+    const chatId = parseChatIdFromSessionKey(sessionKey);
+    if (!chatId) {
+        logger.error(`Cannot parse chatId from sessionKey: ${sessionKey}`);
+        return;
+    }
+    const sessionInfo = compactionSessions.get(sessionKey);
+    compactionSessions.delete(sessionKey);
+    if (sessionInfo) {
+        const duration = Date.now() - sessionInfo.startTime;
+        log(`Compaction completed: chatId=${chatId}, duration=${duration}ms, messagesBefore=${sessionInfo.messageCount}, messagesAfter=${event.messageCount}, compacted=${event.compactedCount}`);
+    }
+}
+
 const plugin = {
     id: "53ai-openclaw",
     name: "53AI OpenClaw",
@@ -1600,6 +1677,8 @@ const plugin = {
     register(api) {
         setRuntime(api.runtime);
         api.registerChannel({ plugin: aiHubPlugin });
+        api.on("before_compaction", handleBeforeCompaction);
+        api.on("after_compaction", handleAfterCompaction);
     },
 };