claw_messenger 1.0.0

package/dist/openclaw-config.js

@@ -0,0 +1,359 @@
+/**
+ * OpenClaw 配置管理
+ * 自动配置 plugins.allow / plugins.entries / channels 等，只添加不重置
+ */
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { access, readFile, writeFile, mkdir, rename } from 'fs/promises';
+import { createLogger } from './logger.js';
+const log = createLogger('openclaw-config');
+const OPENCLAW_DIR = join(homedir(), '.openclaw');
+const SETTINGS_FILE = join(OPENCLAW_DIR, 'openclaw.json');
+const DEFAULT_PLUGINS = [
+    'claw_messenger',
+];
+const REMOVED_PLUGINS = [
+    'openclaw-weixin',
+    'openclaw-wechat',
+];
+/**
+ * 安全读取配置文件
+ * - 文件不存在：返回 null（调用方决定是创建新文件还是跳过）
+ * - 文件存在但解析失败：抛错，避免后续覆盖导致配置丢失
+ */
+async function safeReadSettings(file) {
+    try {
+        await access(file);
+    }
+    catch (_a) {
+        return null;
+    }
+    const content = await readFile(file, 'utf-8');
+    try {
+        return JSON.parse(content);
+    }
+    catch (err) {
+        throw new Error(`配置文件 ${file} 解析失败: ${err.message}。请检查 JSON 语法，修复后再试。`);
+    }
+}
+/**
+ * 安全写入配置文件
+ * - 先写入临时文件
+ * - 再原子重命名为目标文件，避免写入中断导致文件损坏
+ */
+async function safeWriteSettings(file, settings) {
+    await mkdir(dirname(file), { recursive: true });
+    const tmpFile = `${file}.tmp.${Date.now()}`;
+    await writeFile(tmpFile, JSON.stringify(settings, null, 2), 'utf-8');
+    await rename(tmpFile, file);
+}
+export async function getOpenClawSettings(settingsPath) {
+    const file = settingsPath || SETTINGS_FILE;
+    try {
+        return await safeReadSettings(file);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+export async function getPluginsAllow() {
+    var _a;
+    const settings = await getOpenClawSettings();
+    return ((_a = settings === null || settings === void 0 ? void 0 : settings.plugins) === null || _a === void 0 ? void 0 : _a.allow) || [];
+}
+export async function ensurePluginsAllow(settingsPath) {
+    const file = settingsPath || SETTINGS_FILE;
+    let settings;
+    try {
+        settings = (await safeReadSettings(file)) || {};
+        if (settings) {
+            log.info('[OpenClawConfig] 已加载配置文件');
+        }
+        else {
+            log.info('[OpenClawConfig] 配置文件不存在，创建新配置');
+            settings = {};
+        }
+    }
+    catch (err) {
+        log.error('[OpenClawConfig]', err.message);
+        return false;
+    }
+    if (!settings.plugins) {
+        settings.plugins = {};
+    }
+    const existingAllow = settings.plugins.allow || [];
+    const cleanedAllow = existingAllow.filter(p => !REMOVED_PLUGINS.includes(p));
+    const removedCount = existingAllow.length - cleanedAllow.length;
+    const missingPlugins = DEFAULT_PLUGINS.filter(p => !cleanedAllow.includes(p));
+    if (missingPlugins.length === 0 && removedCount === 0) {
+        log.info('[OpenClawConfig] plugins.allow 已配置完整');
+        return true;
+    }
+    settings.plugins.allow = [...new Set([...cleanedAllow, ...DEFAULT_PLUGINS])];
+    try {
+        await safeWriteSettings(file, settings);
+        if (missingPlugins.length > 0) {
+            log.info(`[OpenClawConfig] 已添加插件到 plugins.allow: ${missingPlugins.join(', ')}`);
+        }
+        if (removedCount > 0) {
+            log.info(`[OpenClawConfig] 已清理无效插件: ${REMOVED_PLUGINS.join(', ')}`);
+        }
+        return true;
+    }
+    catch (err) {
+        log.error('[OpenClawConfig] 写入配置失败:', err.message);
+        return false;
+    }
+}
+/**
+ * 确保插件在 plugins.entries 中注册
+ * OpenClaw 只有在 entries 中配置了才会加载插件
+ */
+export async function ensurePluginEntry(settingsPath) {
+    const file = settingsPath || SETTINGS_FILE;
+    let settings;
+    try {
+        settings = (await safeReadSettings(file)) || {};
+        if (settings) {
+            log.info('[OpenClawConfig] 已加载配置文件');
+        }
+        else {
+            log.info('[OpenClawConfig] 配置文件不存在，创建新配置');
+            settings = {};
+        }
+    }
+    catch (err) {
+        log.error('[OpenClawConfig]', err.message);
+        return false;
+    }
+    if (!settings.plugins) {
+        settings.plugins = {};
+    }
+    // 确保 plugins.allow 包含 claw_messenger
+    const existingAllow = settings.plugins.allow || [];
+    if (!existingAllow.includes('claw_messenger')) {
+        settings.plugins.allow = [...existingAllow, 'claw_messenger'];
+        log.info('[OpenClawConfig] 已添加 claw_messenger 到 plugins.allow');
+    }
+    // 确保 plugins.entries 包含 claw_messenger
+    if (!settings.plugins.entries) {
+        settings.plugins.entries = {};
+    }
+    const existingEntry = settings.plugins.entries['claw_messenger'];
+    if (!existingEntry || existingEntry.enabled !== true) {
+        settings.plugins.entries['claw_messenger'] = {
+            enabled: true
+        };
+        log.info('[OpenClawConfig] 已启用 claw_messenger 插件 entries');
+    }
+    // 确保 plugins.load.paths 包含扩展目录（辅助发现，非必须）
+    const extensionsDir = join(OPENCLAW_DIR, 'extensions', 'claw_messenger');
+    if (!settings.plugins.load) {
+        settings.plugins.load = {};
+    }
+    if (!settings.plugins.load.paths) {
+        settings.plugins.load.paths = [];
+    }
+    if (!settings.plugins.load.paths.includes(extensionsDir)) {
+        settings.plugins.load.paths.push(extensionsDir);
+        log.info(`[OpenClawConfig] 已添加插件加载路径: ${extensionsDir}`);
+    }
+    try {
+        await safeWriteSettings(file, settings);
+        log.info('[OpenClawConfig] 已注册 claw_messenger 插件到 plugins.entries');
+        return true;
+    }
+    catch (err) {
+        log.error('[OpenClawConfig] 注册插件 entries 失败:', err.message);
+        return false;
+    }
+}
+/**
+ * 确保 channels.claw_messenger 配置包含 nodeName
+ * OpenClaw 的 hasMeaningfulChannelConfig 会忽略 enabled，
+ * 只有包含非 enabled 属性时才认为 channel 已配置，从而加载插件。
+ */
+export async function ensureChannelConfig(nodeName, settingsPath) {
+    const file = settingsPath || SETTINGS_FILE;
+    let settings;
+    try {
+        settings = (await safeReadSettings(file)) || {};
+        if (!settings) {
+            log.info('[OpenClawConfig] 配置文件不存在，创建新配置');
+            settings = {};
+        }
+    }
+    catch (err) {
+        log.error('[OpenClawConfig]', err.message);
+        return false;
+    }
+    if (!settings.channels) {
+        settings.channels = {};
+    }
+    const existingChannelConfig = settings.channels['claw_messenger'] || {};
+    const existingNodeName = existingChannelConfig.nodeName;
+    if (existingNodeName && typeof existingNodeName === 'string' && existingNodeName.trim()) {
+        log.info('[OpenClawConfig] channels.claw_messenger 已包含 nodeName');
+        return true;
+    }
+    // 尝试从节点配置文件读取昵称
+    let finalNodeName = nodeName;
+    if (!finalNodeName) {
+        try {
+            const bridgeConfigPath = join(homedir(), '.claw-bridge', 'openclaw', 'config.json');
+            const bridgeContent = await readFile(bridgeConfigPath, 'utf-8');
+            const bridgeConfig = JSON.parse(bridgeContent);
+            finalNodeName = bridgeConfig.nodeName;
+        }
+        catch (_a) {
+            // 忽略读取失败
+        }
+    }
+    if (!finalNodeName || typeof finalNodeName !== 'string' || !finalNodeName.trim()) {
+        log.warn('[OpenClawConfig] 未找到节点昵称，跳过 channels.claw_messenger 配置');
+        return false;
+    }
+    settings.channels['claw_messenger'] = Object.assign(Object.assign({}, existingChannelConfig), { nodeName: finalNodeName.trim() });
+    try {
+        await safeWriteSettings(file, settings);
+        log.info(`[OpenClawConfig] 已设置 channels.claw_messenger.nodeName: ${finalNodeName.trim()}`);
+        return true;
+    }
+    catch (err) {
+        log.error('[OpenClawConfig] 写入 channel 配置失败:', err.message);
+        return false;
+    }
+}
+/**
+ * 确保 gateway HTTP chatCompletions 端点已启用
+ * 供 SSE 流式调用使用（OpenClaw 默认禁用该端点）
+ */
+export async function ensureChatCompletionsEnabled(settingsPath) {
+    var _a, _b, _c, _d;
+    const file = settingsPath || SETTINGS_FILE;
+    let settings;
+    try {
+        settings = (await safeReadSettings(file)) || {};
+        if (settings) {
+            log.info('[OpenClawConfig] 已加载配置文件');
+        }
+        else {
+            log.info('[OpenClawConfig] 配置文件不存在，创建新配置');
+            settings = {};
+        }
+    }
+    catch (err) {
+        log.error('[OpenClawConfig]', err.message);
+        return false;
+    }
+    const current = (_d = (_c = (_b = (_a = settings.gateway) === null || _a === void 0 ? void 0 : _a.http) === null || _b === void 0 ? void 0 : _b.endpoints) === null || _c === void 0 ? void 0 : _c.chatCompletions) === null || _d === void 0 ? void 0 : _d.enabled;
+    if (current === true) {
+        log.info('[OpenClawConfig] chatCompletions 端点已启用');
+        return true;
+    }
+    // 深度设置路径 gateway.http.endpoints.chatCompletions.enabled
+    if (!settings.gateway) {
+        settings.gateway = {};
+    }
+    if (!settings.gateway.http) {
+        settings.gateway.http = {};
+    }
+    if (!settings.gateway.http.endpoints) {
+        settings.gateway.http.endpoints = {};
+    }
+    if (!settings.gateway.http.endpoints.chatCompletions) {
+        settings.gateway.http.endpoints.chatCompletions = {};
+    }
+    settings.gateway.http.endpoints.chatCompletions.enabled = true;
+    try {
+        await safeWriteSettings(file, settings);
+        log.info('[OpenClawConfig] 已启用 chatCompletions 端点');
+        return true;
+    }
+    catch (err) {
+        log.error('[OpenClawConfig] 启用 chatCompletions 端点失败:', err.message);
+        return false;
+    }
+}
+/**
+ * 确保网关模型支持 image 类型
+ * OpenClaw 默认模型 type 只有 "text"，插件需要 "image" 支持
+ * 遍历 gateway.http.endpoints.chatCompletions.models 中的每个模型，
+ * 如果 type 是字符串 "text" 则改为 ["text", "image"]，
+ * 如果 type 是数组则追加 "image"
+ */
+export async function ensureImageModelSupport(settingsPath) {
+    var _a, _b, _c, _d;
+    const file = settingsPath || SETTINGS_FILE;
+    let settings;
+    try {
+        settings = (await safeReadSettings(file)) || {};
+        if (!settings) {
+            log.info('[OpenClawConfig] 配置文件不存在，跳过模型 image 类型配置');
+            return true;
+        }
+    }
+    catch (err) {
+        log.error('[OpenClawConfig]', err.message);
+        return false;
+    }
+    const models = (_d = (_c = (_b = (_a = settings === null || settings === void 0 ? void 0 : settings.gateway) === null || _a === void 0 ? void 0 : _a.http) === null || _b === void 0 ? void 0 : _b.endpoints) === null || _c === void 0 ? void 0 : _c.chatCompletions) === null || _d === void 0 ? void 0 : _d.models;
+    if (!models) {
+        log.info('[OpenClawConfig] 未找到 models 配置，跳过');
+        return true;
+    }
+    let modified = false;
+    // 确保 type 包含 image
+    const ensureImageType = (type) => {
+        if (typeof type === 'string') {
+            return type === 'text' ? ['text', 'image'] : [type, 'image'];
+        }
+        if (Array.isArray(type)) {
+            if (!type.includes('image')) {
+                return [...type, 'image'];
+            }
+            return type;
+        }
+        return ['text', 'image'];
+    };
+    // 处理 models 数组格式: [{ id: "...", type: "text" }, ...]
+    if (Array.isArray(models)) {
+        for (const model of models) {
+            if (model && typeof model === 'object') {
+                const newType = ensureImageType(model.type);
+                if (JSON.stringify(newType) !== JSON.stringify(model.type)) {
+                    model.type = newType;
+                    modified = true;
+                    log.info(`[OpenClawConfig] 模型 "${model.id || model.model || '(unknown)'}" type 已更新为`, newType);
+                }
+            }
+        }
+    }
+    // 处理 models 对象格式: { "claude": { type: "text" }, ... }
+    else if (typeof models === 'object' && models !== null) {
+        for (const key of Object.keys(models)) {
+            const model = models[key];
+            if (model && typeof model === 'object') {
+                const newType = ensureImageType(model.type);
+                if (JSON.stringify(newType) !== JSON.stringify(model.type)) {
+                    model.type = newType;
+                    modified = true;
+                    log.info(`[OpenClawConfig] 模型 "${key}" type 已更新为`, newType);
+                }
+            }
+        }
+    }
+    if (!modified) {
+        log.info('[OpenClawConfig] 模型 image 类型已配置');
+        return true;
+    }
+    try {
+        await safeWriteSettings(file, settings);
+        log.info('[OpenClawConfig] 已为模型添加 image 类型支持');
+        return true;
+    }
+    catch (err) {
+        log.error('[OpenClawConfig] 更新模型 image 类型失败:', err.message);
+        return false;
+    }
+}

package/dist/openclaw.plugin.json

@@ -0,0 +1,40 @@
+{
+  "id": "claw_messenger",
+  "name": "claw_messenger",
+  "description": "虾说 IM 直连通道插件，支持私聊、群聊、流式消息",
+  "version": "2.1.2",
+  "author": "",
+  "license": "MIT",
+  "repository": "https://github.com/quukk/clawmessenger",
+  "keywords": ["claw-messenger", "im", "chat", "channel"],
+  "entry": "./dist/plugin-entry.js",
+  "channels": ["claw_messenger"],
+  "channelConfigs": {
+    "claw_messenger": {
+      "schema": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "nodeName": {
+            "type": "string",
+            "label": "节点昵称",
+            "description": "在虾说 IM 中显示的节点名称"
+          }
+        }
+      },
+      "label": "虾说 IM",
+      "description": "通过融云 IM 连接虾说消息系统",
+      "preferOver": []
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": true,
+    "properties": {
+      "nodeName": {
+        "type": "string",
+        "label": "节点昵称"
+      }
+    }
+  }
+}

package/dist/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "claw_messenger",
+  "version": "1.0.0",
+  "description": "OpenClaw 插件 - 虾说应用桥接",
+  "type": "module",
+  "main": "dist/plugin-entry.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "claw_messenger": "bin/install.js",
+    "claw-messenger": "bin/install.js",
+    "claw-messenger-bridge": "bin/install.js",
+    "claw-bridge": "dist/bridge-runner.js",
+    "claw-bridge-setup": "bin/setup.js",
+    "clawmessenger": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "package.json",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./dist/plugin-entry.js"
+    ],
+    "channel": {
+      "id": "claw_messenger",
+      "label": "claw_messenger",
+      "selectionLabel": "虾说 IM",
+      "docsPath": "/channels/claw_messenger",
+      "blurb": "claw_messenger IM channel for OpenClaw",
+      "order": 80
+    },
+    "compat": {
+      "pluginApi": ">=2.0.0"
+    },
+    "install": {
+      "npmSpec": "claw_messenger",
+      "defaultChoice": "npx",
+      "minHostVersion": ">=2026.3.24"
+    }
+  },
+  "scripts": {
+    "build": "node ./node_modules/typescript/bin/tsc && copy /Y package.json dist\\ && copy /Y openclaw.plugin.json dist\\ && copy /Y bin\\postinstall.js dist\\postinstall.js",
+    "setup": "npm run build && node bin/install.js",
+    "install-local": "node bin/install.js",
+    "start": "node bin/dm-bridge.cjs",
+    "bridge": "ts-node bridge-runner.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node dist/postinstall.js",
+    "publish:patch": "npm version patch && npm publish",
+    "publish:minor": "npm version minor && npm publish",
+    "publish:major": "npm version major && npm publish",
+    "unpublish:last": "node scripts/unpublish.js",
+    "unpublish:version": "node scripts/unpublish.js",
+    "deprecate:last": "npm deprecate $(node -p \"require('./package.json').name\")@$(node -p \"require('./package.json').version\") \"This version is deprecated. Please upgrade.\"",
+    "deprecate:version": "npm deprecate"
+  },
+  "keywords": [
+    "openclaw",
+    "claw-messenger",
+    "im",
+    "chat",
+    "bridge",
+    "ai"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quukk/clawmessenger.git"
+  },
+  "bugs": {
+    "url": "https://github.com/quukk/clawmessenger/issues"
+  },
+  "homepage": "https://github.com/quukk/clawmessenger#readme",
+  "dependencies": {
+    "@rongcloud/engine": "^5.36.6",
+    "@rongcloud/imlib-next": "^5.36.6",
+    "axios": "^1.15.0",
+    "fake-indexeddb": "^6.2.5",
+    "jsdom": "^24.0.0",
+    "qrcode-terminal": "^0.12.0",
+    "ws": "^8.16.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.24"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/jsdom": "^21.1.6",
+    "@types/node": "^20.11.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/ws": "^8.5.10",
+    "@vitest/coverage-v8": "^1.6.1",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.6.1"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/dist/plugin-entry.d.ts

@@ -0,0 +1,54 @@
+interface ChannelGatewayContext {
+    cfg: any;
+    accountId: string;
+    account: any;
+    runtime?: any;
+    channelRuntime?: any;
+    abortSignal: AbortSignal;
+    log?: {
+        info?: (msg: string) => void;
+        warn?: (msg: string) => void;
+        error?: (msg: string) => void;
+        debug?: (msg: string) => void;
+    };
+    getStatus: () => any;
+    setStatus: (next: any) => void;
+}
+declare class RongCloudChannelImpl {
+    private client;
+    private accountId;
+    private openclaw;
+    private serverAPI;
+    private appSecret;
+    private streamQueue;
+    private streamMessageUIDs;
+    /**
+     * 启动 channel account（OpenClaw 2026.4.21+ 新 API）
+     */
+    startAccount(ctx: ChannelGatewayContext): Promise<void>;
+    sendMessage(to: string, content: string, metadata?: any): Promise<void>;
+    sendMediaMessage(targetId: string, media: {
+        mediaUrl: string;
+        mimeType?: string;
+        fileName?: string;
+        fileSize?: number;
+    }, conversationType: number): Promise<void>;
+    private extractMentions;
+    handleMessage(msg: any, ctx: ChannelGatewayContext): Promise<void>;
+    private handleStreamChat;
+    private _handleDeviceStatusRequest;
+    private _sendDeviceStatusReport;
+    private _sendWebSearchStatus;
+    private _sendStreamChunk;
+    private _sendStreamHistory;
+    callOpenClaw(message: string, fromUser: string): Promise<string>;
+}
+declare const channelImpl: RongCloudChannelImpl;
+export { RongCloudChannelImpl, channelImpl };
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: any): void;
+};
+export default _default;