@53ai/53ai-openclaw 1.0.0

package/dist/src/message-sender.d.ts

@@ -0,0 +1,26 @@
+import type { RuntimeEnv } from "openclaw/plugin-sdk";
+import type { WebSocket } from "ws";
+import { ErrorCode } from "./interface.js";
+interface SendReplyParams {
+    wsClient: WebSocket;
+    text: string;
+    toChatId: string;
+    replyToMsgId?: string;
+    runtime: RuntimeEnv;
+    finish: boolean;
+    streamId: string;
+    isError?: boolean;
+    errorCode?: ErrorCode | string;
+    errorDetails?: string;
+}
+export declare function sendReply(params: SendReplyParams): Promise<void>;
+export declare function sendDirectMessage(wsClient: WebSocket, to: string, content: string, runtime?: RuntimeEnv): Promise<void>;
+export declare function sendMediaMessage(wsClient: WebSocket, to: string, media: {
+    type: "image" | "file";
+    url?: string;
+    base64?: string;
+    mimeType?: string;
+    filename?: string;
+}, text?: string, runtime?: RuntimeEnv): Promise<void>;
+export declare function sendThinkingMessage(wsClient: WebSocket, text: string, msgId: string, streamId: string, runtime?: RuntimeEnv): Promise<void>;
+export {};

package/dist/src/monitor.d.ts

@@ -0,0 +1,2 @@
+import type { MonitorOptions } from "./interface.js";
+export declare function monitorProvider(options: MonitorOptions): Promise<void>;

package/dist/src/onboarding.d.ts

@@ -0,0 +1,2 @@
+import { type ChannelOnboardingAdapter } from "openclaw/plugin-sdk";
+export declare const aiHubOnboardingAdapter: ChannelOnboardingAdapter;

package/dist/src/reqid-store.d.ts

@@ -0,0 +1,9 @@
+export interface PersistentReqIdStore {
+    set(chatId: string, reqId: string): void;
+    get(chatId: string): Promise<string | undefined>;
+    getSync(chatId: string): string | undefined;
+    delete(chatId: string): void;
+    warmup(onError?: (error: unknown) => void): Promise<number>;
+    flush(): Promise<void>;
+}
+export declare function createPersistentReqIdStore(accountId: string): PersistentReqIdStore;

package/dist/src/runtime.d.ts

@@ -0,0 +1,3 @@
+import type { PluginRuntime } from "openclaw/plugin-sdk";
+export declare function setRuntime(r: PluginRuntime): void;
+export declare function getRuntime(): PluginRuntime;

package/dist/src/state-manager.d.ts

@@ -0,0 +1,17 @@
+import type { WebSocket } from "ws";
+import type { MessageState } from "./interface.js";
+export declare function getWebSocket(accountId: string): WebSocket | null;
+export declare function setWebSocket(accountId: string, client: WebSocket): void;
+export declare function deleteWebSocket(accountId: string): void;
+export declare function startMessageStateCleanup(): void;
+export declare function stopMessageStateCleanup(): void;
+export declare function setMessageState(messageId: string, state: MessageState): void;
+export declare function getMessageState(messageId: string): MessageState | undefined;
+export declare function deleteMessageState(messageId: string): void;
+export declare function clearAllMessageStates(): void;
+export declare function setLastMsgIdForChat(chatId: string, msgId: string, accountId?: string): void;
+export declare function getLastMsgIdForChat(chatId: string, accountId?: string): string | undefined;
+export declare function warmupReqIdStore(accountId?: string, log?: (msg: string) => void): Promise<number>;
+export declare function flushReqIdStore(accountId?: string): Promise<void>;
+export declare function cleanupAccount(accountId: string): Promise<void>;
+export declare function cleanupAll(): Promise<void>;

package/dist/src/timeout.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 超时处理工具模块
+ */
+/**
+ * 为 Promise 添加超时保护
+ * @param promise 需要包装的 Promise
+ * @param ms 超时时间（毫秒）
+ * @param message 超时错误消息
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, message: string): Promise<T>;

package/dist/src/utils.d.ts

@@ -0,0 +1,48 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+/**
+ * 53AIHub 渠道配置
+ */
+export interface AIHubConfig {
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 账户名称 */
+    name?: string;
+    /** 机器人 ID */
+    botId?: string;
+    /** 用户 ID */
+    userId?: string;
+    /** 密钥 */
+    secret?: string;
+    /** 访问令牌 */
+    token?: string;
+    /** WebSocket URL */
+    websocketUrl?: string;
+    /** 访问控制白名单 */
+    allowFrom?: Array<string | number>;
+    /** 访问策略: open=开放, allowlist=白名单, pairing=配对审批 */
+    accessPolicy?: "open" | "allowlist" | "pairing" | "disabled";
+    /** 是否发送"思考中"消息 */
+    sendThinkingMessage?: boolean;
+}
+/**
+ * 解析后的账户配置
+ */
+export interface ResolvedAccount {
+    accountId: string;
+    name: string;
+    enabled: boolean;
+    websocketUrl: string;
+    botId: string;
+    secret: string;
+    token: string;
+    sendThinkingMessage: boolean;
+    config: AIHubConfig;
+}
+/**
+ * 解析账户配置
+ */
+export declare function resolveAccount(cfg: OpenClawConfig, accountId?: string): ResolvedAccount;
+/**
+ * 设置账户配置
+ */
+export declare function setAccount(cfg: OpenClawConfig, account: Partial<AIHubConfig>): OpenClawConfig;

package/openclaw.plugin.json

@@ -0,0 +1,41 @@
+{
+  "id": "53ai-openclaw",
+  "channels": [
+    "53aihub"
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "botId": {
+        "type": "string",
+        "description": "AgentHub 智能体 ID (HashID)"
+      },
+      "secret": {
+        "type": "string",
+        "description": "AgentHub App Secret / Token"
+      },
+      "token": {
+        "type": "string",
+        "description": "AgentHub App Secret / Token (Alias)"
+      },
+      "websocketUrl": {
+        "type": "string",
+        "description": "AgentHub WebSocket 连接地址"
+      },
+      "accessPolicy": {
+        "type": "string",
+        "enum": ["open", "allowlist", "pairing"],
+        "default": "open",
+        "description": "访问策略: open=开放所有用户, allowlist=仅白名单用户, pairing=首次使用需审批"
+      },
+      "allowFrom": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "访问控制白名单，配合 accessPolicy=allowlist 或 pairing 使用"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@53ai/53ai-openclaw",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "test": "echo \"No tests configured\" && exit 0",
+    "prepublishOnly": "npm run build",
+    "release": "bash scripts/publish.sh",
+    "release:patch": "bash scripts/publish.sh patch",
+    "release:minor": "bash scripts/publish.sh minor",
+    "release:major": "bash scripts/publish.sh major"
+  },
+  "keywords": [
+    "53ai",
+    "openclaw",
+    "53ai-openclaw",
+    "agent",
+    "chatbot",
+    "websocket"
+  ],
+  "author": "53AI",
+  "license": "MIT",
+  "description": "OpenClaw 53AI channel plugin",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/53AI/53ai-openclaw.git"
+  },
+  "bugs": {
+    "url": "https://github.com/53AI/53ai-openclaw/issues"
+  },
+  "homepage": "https://github.com/53AI/53ai-openclaw#readme",
+  "openclaw": {
+    "extensions": [
+      "./dist/index.esm.js"
+    ],
+    "channel": {
+      "id": "53aihub",
+      "paclabel": "53AIHub",
+      "selectionLabel": "53AIHub (AgentHub)",
+      "docsPath": "/channels/53aihub",
+      "docsLabel": "53ai-openclaw",
+      "blurb": "53AIHub 智能机器人接入插件",
+      "order": 90,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@53ai/53ai-openclaw",
+      "localPath": "extensions/53ai-openclaw",
+      "defaultChoice": "npm"
+    }
+  },
+  "dependencies": {
+    "ws": "^8.16.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/ws": "^8.5.10",
+    "openclaw": ">=2026.2.13",
+    "rollup": "^4.9.6",
+    "rollup-plugin-dts": "^6.1.0",
+    "tslib": "^2.6.2",
+    "typescript": "^5.3.3"
+  }
+}