@wecode-ai/weibo-openclaw-plugin 1.0.0

package/README.md

@@ -0,0 +1,59 @@
+# openclaw-weibo
+
+OpenClaw Weibo DM channel plugin - 微博私信通道插件
+
+
+
+## 使用
+### 获取凭证
+
+1. 打开微博客户端，私信 [@微博龙虾助手](https://weibo.com/u/6808810981)
+2. 发送消息：`连接龙虾`
+3. 收到回复示例：
+   ```
+   您的应用凭证信息如下：
+
+   AppId: your-app-id
+   AppSecret: your-app-secret
+
+   如需重置凭证，请发送 "重置凭证" 命令。
+   ```
+
+### 配置OpenClaw 
+#### 安装插件
+```
+git clone https://gitee.com/wecode-ai/openclaw-weibo.git
+cd openclaw-weibo
+openclaw plugins install .
+openclaw gateway restart
+```
+
+#### 配置凭证
+使用命令配置：
+```bash
+openclaw config set 'channels.weibo.appSecret' 'your-appSecret'
+openclaw config set 'channels.weibo.appId' 'your-appId'
+```
+
+或编辑 `~/.openclaw/openclaw.config.json`：
+
+```json
+{
+...existing config...
+  "channels": {
+    ...existing config...
+    "weibo": {
+      "appId": "your-app-id",
+      "appSecret": "your-app-secret"
+    }
+  }
+}
+```
+
+## 插件网络访问说明
+* 插件通过域名 `open-im.api.weibo.com` 来调用微博接口。
+* 如在出入口网络受限环境下使用该插件请注意配置访问权限。
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,67 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { weiboPlugin } from "./src/channel.js";
+import { setWeiboRuntime } from "./src/runtime.js";
+import { reconnectWeiboMonitor } from "./src/monitor.js";
+import { clearClientCache } from "./src/client.js";
+import { clearTokenCache } from "./src/token.js";
+import { registerWeiboSearchTools } from "./src/weibo-search.js";
+import { registerWeiboStatusTools } from "./src/weibo-status.js";
+import { registerWeiboHotSearchTools } from "./src/weibo-hot-search.js";
+
+export { monitorWeiboProvider } from "./src/monitor.js";
+export { sendMessageWeibo } from "./src/send.js";
+export { weiboPlugin } from "./src/channel.js";
+
+const plugin = {
+  id: "weibo",
+  name: "Weibo",
+  description: "Weibo DM channel plugin",
+  configSchema: { type: "object" as const, properties: {} },
+  register(api: OpenClawPluginApi) {
+    setWeiboRuntime(api.runtime);
+    api.registerChannel({ plugin: weiboPlugin });
+    registerWeiboSearchTools(api);
+    registerWeiboStatusTools(api);
+    registerWeiboHotSearchTools(api);
+
+    // 工具调用钩子
+    api.on("before_tool_call", (event) => {
+        if (event.toolName.startsWith("weibo_")) {
+            console.log(`[微博工具调用] ${event.toolName} 参数: ${JSON.stringify(event.params)}`);
+        }
+    });
+    api.on("after_tool_call", (event) => {
+        if (event.toolName.startsWith("weibo_")) {
+            if (event.error) {
+                console.error(`[微博工具调用失败] ${event.toolName} 错误: ${event.error}`);
+            } else {
+                console.log(`[微博工具调用成功] ${event.toolName} 耗时: ${event.durationMs}ms`);
+            }
+        }
+    });
+
+    api.registerGatewayMethod("weibo.reconnect", async ({ params, respond, context }) => {
+      const accountId =
+        typeof params.accountId === "string" && params.accountId.trim()
+          ? params.accountId.trim()
+          : undefined;
+
+      try {
+        await reconnectWeiboMonitor(accountId);
+        clearClientCache(accountId);
+        clearTokenCache(accountId);
+        await context.stopChannel("weibo", accountId);
+        await context.startChannel("weibo", accountId);
+        respond(true, { ok: true, accountId: accountId ?? "default" });
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        respond(false, undefined, {
+          code: "weibo_reconnect_failed",
+          message,
+        });
+      }
+    });
+  },
+};
+
+export default plugin;

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@wecode-ai/weibo-openclaw-plugin",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "OpenClaw Weibo DM channel plugin",
+  "scripts": {
+    "test:unit": "vitest run",
+    "ci:check": "npx tsc --noEmit && npm run test:unit",
+    "build": "tsc",
+    "dev": "tsx",
+    "sim:server": "tsx weibo-server.ts"
+  },
+  "license": "MIT",
+  "files": [
+    "index.ts",
+    "src/**/*.ts",
+    "!src/**/__tests__/**",
+    "!src/**/*.test.ts"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "weibo",
+      "label": "Weibo",
+      "selectionLabel": "Weibo (微博)",
+      "docsPath": "/channels/weibo",
+      "docsLabel": "weibo",
+      "blurb": "Weibo direct message channel.",
+      "order": 80
+    }
+  },
+  "dependencies": {
+    "@sinclair/typebox": "0.34.48",
+    "ws": "^8.18.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "@types/ws": "^8.5.14",
+    "@vitest/coverage-v8": "^2.1.8",
+    "openclaw": "^2026.3.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.8"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.1"
+  }
+}

package/src/accounts.ts

@@ -0,0 +1,134 @@
+import type { ClawdbotConfig } from "openclaw/plugin-sdk";
+import type { WeiboConfig, ResolvedWeiboAccount } from "./types.js";
+
+const DEFAULT_ACCOUNT_ID = "default";
+const DEFAULT_WS_ENDPOINT = "ws://open-im.api.weibo.com/ws/stream";
+const DEFAULT_TOKEN_ENDPOINT = "http://open-im.api.weibo.com/open/auth/ws_token";
+
+function readOptionalNonBlankString(value: unknown): string | undefined {
+  if (typeof value === "number" && !Number.isNaN(value)) {
+    return String(value);
+  }
+  if (typeof value !== "string") {
+    return undefined;
+  }
+  const trimmed = value.trim();
+  return trimmed ? trimmed : undefined;
+}
+
+export function resolveWeiboAccount({
+  cfg,
+  accountId = DEFAULT_ACCOUNT_ID,
+}: {
+  cfg: ClawdbotConfig;
+  accountId?: string;
+}): ResolvedWeiboAccount {
+  const weiboCfg = cfg.channels?.weibo as WeiboConfig | undefined;
+
+  const isDefault = accountId === DEFAULT_ACCOUNT_ID;
+  const topLevelAppId = readOptionalNonBlankString(weiboCfg?.appId);
+  const topLevelAppSecret = readOptionalNonBlankString(weiboCfg?.appSecret);
+  const topLevelWsEndpoint = readOptionalNonBlankString(weiboCfg?.wsEndpoint);
+  const topLevelTokenEndpoint = readOptionalNonBlankString(weiboCfg?.tokenEndpoint);
+
+  if (isDefault && weiboCfg) {
+    const hasCredentials = !!(topLevelAppId && topLevelAppSecret);
+    return {
+      accountId: DEFAULT_ACCOUNT_ID,
+      enabled: weiboCfg.enabled ?? true,
+      configured: hasCredentials,
+      name: "Default",
+      appId: topLevelAppId,
+      appSecret: topLevelAppSecret,
+      wsEndpoint: topLevelWsEndpoint ?? DEFAULT_WS_ENDPOINT,
+      tokenEndpoint: topLevelTokenEndpoint ?? DEFAULT_TOKEN_ENDPOINT,
+      config: {
+        dmPolicy: weiboCfg.dmPolicy ?? "open",
+        allowFrom: weiboCfg.allowFrom ?? [],
+        tokenEndpoint: topLevelTokenEndpoint ?? DEFAULT_TOKEN_ENDPOINT,
+        wsEndpoint: topLevelWsEndpoint ?? DEFAULT_WS_ENDPOINT,
+        textChunkLimit: weiboCfg.textChunkLimit,
+        chunkMode: weiboCfg.chunkMode ?? "raw",
+        blockStreaming: weiboCfg.blockStreaming ?? true,
+        tools: weiboCfg.tools,
+      },
+    };
+  }
+
+  const accountCfg = weiboCfg?.accounts?.[accountId];
+  const topLevel = {
+    appId: topLevelAppId,
+    appSecret: topLevelAppSecret,
+    wsEndpoint: topLevelWsEndpoint,
+    tokenEndpoint: topLevelTokenEndpoint,
+    dmPolicy: weiboCfg?.dmPolicy,
+    allowFrom: weiboCfg?.allowFrom,
+    textChunkLimit: weiboCfg?.textChunkLimit,
+    chunkMode: weiboCfg?.chunkMode,
+    blockStreaming: weiboCfg?.blockStreaming,
+    tools: weiboCfg?.tools,
+  };
+
+  const merged = {
+    appId: readOptionalNonBlankString(accountCfg?.appId) ?? topLevel.appId,
+    appSecret: readOptionalNonBlankString(accountCfg?.appSecret) ?? topLevel.appSecret,
+    wsEndpoint:
+      readOptionalNonBlankString(accountCfg?.wsEndpoint)
+      ?? topLevel.wsEndpoint
+      ?? DEFAULT_WS_ENDPOINT,
+    tokenEndpoint:
+      readOptionalNonBlankString(accountCfg?.tokenEndpoint)
+      ?? topLevel.tokenEndpoint
+      ?? DEFAULT_TOKEN_ENDPOINT,
+    dmPolicy: accountCfg?.dmPolicy ?? topLevel.dmPolicy ?? "open",
+    allowFrom: accountCfg?.allowFrom ?? topLevel.allowFrom ?? [],
+    textChunkLimit: accountCfg?.textChunkLimit ?? topLevel.textChunkLimit,
+    chunkMode: accountCfg?.chunkMode ?? topLevel.chunkMode ?? "raw",
+    blockStreaming: accountCfg?.blockStreaming ?? topLevel.blockStreaming ?? true,
+    tools: accountCfg?.tools ?? topLevel.tools,
+  };
+
+  const hasCredentials = !!(merged.appId && merged.appSecret);
+
+  return {
+    accountId,
+    enabled: accountCfg?.enabled ?? weiboCfg?.enabled ?? true,
+    configured: hasCredentials,
+    name: accountCfg?.name,
+    appId: merged.appId,
+    appSecret: merged.appSecret,
+    wsEndpoint: merged.wsEndpoint,
+    tokenEndpoint: merged.tokenEndpoint,
+    config: {
+      dmPolicy: merged.dmPolicy,
+      allowFrom: merged.allowFrom,
+      tokenEndpoint: merged.tokenEndpoint,
+      wsEndpoint: merged.wsEndpoint,
+      textChunkLimit: merged.textChunkLimit,
+      chunkMode: merged.chunkMode,
+      blockStreaming: merged.blockStreaming,
+      tools: merged.tools,
+    },
+  };
+}
+
+export function listWeiboAccountIds(cfg: ClawdbotConfig): string[] {
+  const weiboCfg = cfg.channels?.weibo as WeiboConfig | undefined;
+  const accounts = weiboCfg?.accounts;
+  const ids = [DEFAULT_ACCOUNT_ID];
+  if (accounts) {
+    ids.push(...Object.keys(accounts));
+  }
+  return ids;
+}
+
+export function resolveDefaultWeiboAccountId(cfg: ClawdbotConfig): string {
+  return DEFAULT_ACCOUNT_ID;
+}
+
+export function listEnabledWeiboAccounts(cfg: ClawdbotConfig): ResolvedWeiboAccount[] {
+  const ids = listWeiboAccountIds(cfg);
+  return ids
+    .map((id) => resolveWeiboAccount({ cfg, accountId: id }))
+    .filter((a) => a.enabled && a.configured);
+}