openclaw-mochat 2026.2.3

package/README.md

@@ -0,0 +1,82 @@
+# Mochat 插件（OpenClaw）
+
+这是一个 OpenClaw 的渠道插件，用于对接 Mochat/Tailchat（Claw IM）。
+
+## 打包/分发方式
+
+插件目录需要包含：
+
+- `openclaw.plugin.json`
+- `package.json`（含 `openclaw.extensions`）
+- 入口文件（如 `index.ts` 或 `dist/index.js`）
+
+常见分发方式：
+
+1) **本地目录/压缩包**
+- 直接把插件目录发送给用户。
+- 用户用 `openclaw plugins install /path/to/mochat` 安装。
+
+2) **发布到 npm（推荐）**
+- `package.json` 中配置：
+  - `openclaw.extensions` 指向入口（`./index.ts` 或 `./dist/index.js`）
+- 运行依赖放在插件自身 `dependencies`。
+- 发布后，用户可用：
+  - `openclaw plugins install openclaw-mochat`
+
+## 用户标准安装流程
+
+1) **安装插件**
+
+```bash
+# npm 安装
+openclaw plugins install openclaw-mochat
+
+# 或本地目录安装
+openclaw plugins install /path/to/mochat
+
+# 开发联调（软链接，不复制）
+openclaw plugins install -l /path/to/mochat
+```
+
+2) **启用插件**
+
+```bash
+openclaw plugins enable mochat
+# 或
+openclaw config set plugins.entries.mochat.enabled true
+```
+
+3) **配置渠道参数**
+
+```bash
+openclaw config set channels.mochat.baseUrl "http://localhost:11000"
+openclaw config set channels.mochat.socketUrl "http://localhost:11000"
+openclaw config set channels.mochat.clawToken "claw_ef06c64c7589bb36d27e16ab8e337dded50529cfc3982d88"
+openclaw config set channels.mochat.agentUserId "69820107a785110aea8b1069"
+openclaw config set channels.mochat.sessions '["*"]'
+openclaw config set channels.mochat.panels '["*"]'
+openclaw config set channels.mochat.refreshIntervalMs 30000
+openclaw config set channels.mochat.replyDelayMode "non-mention"
+openclaw config set channels.mochat.replyDelayMs 120000
+```
+
+`replyDelayMode=non-mention` 时：仅 **panel** 启用混合模式（被 @ 立即回复，未 @ 延迟合并）。Session 消息仍然立即回复，不受影响。
+
+4) **重启网关**
+
+```bash
+openclaw gateway restart
+```
+
+5) **验证**
+
+```bash
+openclaw plugins list
+openclaw channels status --probe
+```
+
+## 开发/调试建议
+
+- 如果使用 `openclaw plugins install -l`，代码修改后无需重新安装。
+- 依赖变更后需要在插件目录执行安装（例如 `pnpm install`）。
+- 配置变更后需重启网关生效。

package/index.ts

@@ -0,0 +1,19 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { mochatPlugin } from "./src/channel.js";
+import { setMochatRuntime } from "./src/runtime.js";
+import { mochatTool } from "./src/tool.js";
+
+const plugin = {
+  id: "mochat",
+  name: "Mochat",
+  description: "OpenClaw Mochat (Claw IM) channel plugin",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    setMochatRuntime(api.runtime);
+    api.registerChannel({ plugin: mochatPlugin });
+    api.registerTool(mochatTool, { optional: true });
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,9 @@
+{
+  "id": "mochat",
+  "channels": ["mochat"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "openclaw-mochat",
+  "version": "2026.2.3",
+  "description": "OpenClaw Mochat (Claw IM) channel plugin",
+  "type": "module",
+  "dependencies": {
+    "@sinclair/typebox": "0.34.48",
+    "socket.io-client": "^4.7.2",
+    "socket.io-msgpack-parser": "^3.0.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "openclaw": "workspace:*"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "mochat",
+      "label": "Mochat",
+      "selectionLabel": "Mochat (Claw IM)",
+      "docsPath": "/channels/mochat",
+      "docsLabel": "mochat",
+      "blurb": "Claw IM gateway for Mochat/Tailchat",
+      "order": 95
+    },
+    "install": {
+      "npmSpec": "openclaw-mochat",
+      "localPath": "extensions/moltchat",
+      "defaultChoice": "npm"
+    }
+  },
+  "files": [
+    "index.ts",
+    "src/**",
+    "openclaw.plugin.json",
+    "README.md",
+    "package.json"
+  ]
+}

package/src/accounts.ts

@@ -0,0 +1,180 @@
+import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk";
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import type { MochatConfig } from "./config-schema.js";
+
+export type MochatAccountConfig = MochatConfig & {
+  accounts?: Record<string, MochatConfig | undefined>;
+};
+
+export type ResolvedMochatAccount = {
+  accountId: string;
+  name?: string;
+  enabled: boolean;
+  configured: boolean;
+  config: Required<
+    Pick<
+      MochatConfig,
+      | "baseUrl"
+      | "refreshIntervalMs"
+      | "watchTimeoutMs"
+      | "watchLimit"
+      | "retryDelayMs"
+      | "maxRetryAttempts"
+      | "socketPath"
+      | "socketDisableMsgpack"
+      | "socketReconnectDelayMs"
+      | "socketMaxReconnectDelayMs"
+      | "socketConnectTimeoutMs"
+      | "replyDelayMode"
+      | "replyDelayMs"
+    >
+  > &
+    Pick<
+      MochatConfig,
+      | "clawToken"
+      | "agentUserId"
+      | "sessions"
+      | "panels"
+      | "mention"
+      | "groups"
+      | "socketUrl"
+    > & {
+    autoDiscoverSessions: boolean;
+    autoDiscoverPanels: boolean;
+  };
+};
+
+const DEFAULT_BASE_URL = "http://localhost:11000";
+const DEFAULT_WATCH_TIMEOUT_MS = 25000;
+const DEFAULT_WATCH_LIMIT = 100;
+const DEFAULT_RETRY_DELAY_MS = 200;
+const DEFAULT_MAX_RETRY_ATTEMPTS = 3;
+const DEFAULT_SOCKET_PATH = "/socket.io";
+const DEFAULT_SOCKET_DISABLE_MSGPACK = false;
+const DEFAULT_SOCKET_RECONNECT_DELAY_MS = 1000;
+const DEFAULT_SOCKET_MAX_RECONNECT_DELAY_MS = 10000;
+const DEFAULT_SOCKET_CONNECT_TIMEOUT_MS = 10000;
+const DEFAULT_REFRESH_INTERVAL_MS = 30000;
+const DEFAULT_REPLY_DELAY_MODE = "off";
+const DEFAULT_REPLY_DELAY_MS = 120000;
+
+type NormalizedList = {
+  items: string[];
+  hasWildcard: boolean;
+};
+
+function normalizeIdList(values?: string[]): NormalizedList {
+  const cleaned = (values ?? [])
+    .map((entry) => String(entry).trim())
+    .filter(Boolean);
+  const hasWildcard = cleaned.includes("*");
+  const items = Array.from(new Set(cleaned.filter((entry) => entry !== "*")));
+  return { items, hasWildcard };
+}
+
+export function listMochatAccountIds(cfg: OpenClawConfig): string[] {
+  const channel = (cfg.channels?.mochat ?? {}) as MochatAccountConfig;
+  const accountIds = Object.keys(channel.accounts ?? {});
+  if (accountIds.length > 0) {
+    return accountIds;
+  }
+  return [DEFAULT_ACCOUNT_ID];
+}
+
+export function resolveDefaultMochatAccountId(_cfg: OpenClawConfig): string {
+  return DEFAULT_ACCOUNT_ID;
+}
+
+export function resolveMochatAccount(params: {
+  cfg: OpenClawConfig;
+  accountId?: string | null;
+}): ResolvedMochatAccount {
+  const accountId = params.accountId ?? DEFAULT_ACCOUNT_ID;
+  const channel = (params.cfg.channels?.mochat ?? {}) as MochatAccountConfig;
+  const accountConfig = channel.accounts?.[accountId] ?? channel;
+
+  const baseUrl = accountConfig.baseUrl ?? channel.baseUrl ?? DEFAULT_BASE_URL;
+  const clawToken = accountConfig.clawToken ?? channel.clawToken;
+  const agentUserId = accountConfig.agentUserId ?? channel.agentUserId;
+  const sessionList = normalizeIdList(accountConfig.sessions ?? channel.sessions);
+  const panelList = normalizeIdList(accountConfig.panels ?? channel.panels);
+  const sessions = sessionList.items;
+  const panels = panelList.items;
+  const autoDiscoverSessions = sessionList.hasWildcard;
+  const autoDiscoverPanels = panelList.hasWildcard;
+  const mention = accountConfig.mention ?? channel.mention;
+  const groups = accountConfig.groups ?? channel.groups;
+  const socketUrl = accountConfig.socketUrl ?? channel.socketUrl ?? baseUrl;
+  const socketPath = accountConfig.socketPath ?? channel.socketPath ?? DEFAULT_SOCKET_PATH;
+  const socketDisableMsgpack =
+    accountConfig.socketDisableMsgpack ??
+    channel.socketDisableMsgpack ??
+    DEFAULT_SOCKET_DISABLE_MSGPACK;
+  const socketReconnectDelayMs =
+    accountConfig.socketReconnectDelayMs ??
+    channel.socketReconnectDelayMs ??
+    DEFAULT_SOCKET_RECONNECT_DELAY_MS;
+  const socketMaxReconnectDelayMs =
+    accountConfig.socketMaxReconnectDelayMs ??
+    channel.socketMaxReconnectDelayMs ??
+    DEFAULT_SOCKET_MAX_RECONNECT_DELAY_MS;
+  const socketConnectTimeoutMs =
+    accountConfig.socketConnectTimeoutMs ??
+    channel.socketConnectTimeoutMs ??
+    DEFAULT_SOCKET_CONNECT_TIMEOUT_MS;
+  const refreshIntervalMs =
+    accountConfig.refreshIntervalMs ??
+    channel.refreshIntervalMs ??
+    DEFAULT_REFRESH_INTERVAL_MS;
+  const watchTimeoutMs =
+    accountConfig.watchTimeoutMs ?? channel.watchTimeoutMs ?? DEFAULT_WATCH_TIMEOUT_MS;
+  const watchLimit = accountConfig.watchLimit ?? channel.watchLimit ?? DEFAULT_WATCH_LIMIT;
+  const retryDelayMs =
+    accountConfig.retryDelayMs ?? channel.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+  const maxRetryAttempts =
+    accountConfig.maxRetryAttempts ?? channel.maxRetryAttempts ?? DEFAULT_MAX_RETRY_ATTEMPTS;
+  const replyDelayMode =
+    accountConfig.replyDelayMode ?? channel.replyDelayMode ?? DEFAULT_REPLY_DELAY_MODE;
+  const replyDelayMs =
+    accountConfig.replyDelayMs ?? channel.replyDelayMs ?? DEFAULT_REPLY_DELAY_MS;
+
+  const enabled = accountConfig.enabled ?? channel.enabled ?? true;
+  const configured =
+    Boolean(clawToken?.trim()) &&
+    Boolean(agentUserId?.trim()) &&
+    ((Array.isArray(sessions) && sessions.length > 0) ||
+      (Array.isArray(panels) && panels.length > 0) ||
+      autoDiscoverSessions ||
+      autoDiscoverPanels);
+
+  return {
+    accountId,
+    name: accountConfig.name ?? channel.name,
+    enabled,
+    configured,
+    config: {
+      baseUrl,
+      clawToken,
+      agentUserId,
+      sessions,
+      panels,
+      autoDiscoverSessions,
+      autoDiscoverPanels,
+      mention,
+      groups,
+      socketUrl,
+      socketPath,
+      socketDisableMsgpack,
+      socketReconnectDelayMs,
+      socketMaxReconnectDelayMs,
+      socketConnectTimeoutMs,
+      refreshIntervalMs,
+      watchTimeoutMs,
+      watchLimit,
+      retryDelayMs,
+      maxRetryAttempts,
+      replyDelayMode,
+      replyDelayMs,
+    },
+  };
+}