@53ai/53ai-openclaw 1.0.5 → 1.0.7

package/CHANGELOG.md

@@ -4,6 +4,23 @@ 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
+- 文档更新：修正了 `botId` 和 `secret` 的说明。
+
+## [1.0.5] - 2026-03-19
+
+### Changed
+- 重构了接口名称，将 `Hub53AIMessageData` 简化为 `MessageData`。
+- 代码格式优化。
+
 ## [1.0.4] - 2026-03-19
 
 ### Fixed

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 (HashID) |
-| `secret` | 是 | - | 53AIHub App Secret / Token |
-| `websocketUrl` | 是 | - | 53AIHub WebSocket 连接地址 |
+| `botId` | 是 | - | 智能体的ID  |
+| `secret` | 是 | - | 智能体的Secret |
+| `WSUrl` | 是 | - | 53AIHub平台的WS地址 |
 | `token` | 否 | - | secret 的别名，与 secret 二选一 |
 | `enabled` | 否 | false | 是否启用通道 |
 | `accessPolicy` | 否 | `open` | 访问策略: `open`=开放所有用户, `allowlist`=仅白名单用户, `pairing`=首次使用需审批, `disabled`=禁用 |
@@ -407,7 +407,7 @@ npm test
 
 ### WebSocket 连接失败
 
-1. 检查 `websocketUrl` 格式是否正确
+1. 检查 `WSUrl` 格式是否正确
 2. 确认网络可达性
 3. 检查 `botId` 和 `secret` 是否正确
 

package/dist/index.cjs.js

@@ -1108,7 +1108,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 +1207,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 +1228,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 +1267,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 +1340,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 +1423,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 }) => {