@kirigaya/openclaw-onebot 1.0.1 → 1.0.3

package/dist/reply-context.d.ts

@@ -4,8 +4,27 @@
  * （Agent 可能传入裸数字或 user:xxx，导致误发私聊）
  */
 export declare function setActiveReplyTarget(to: string): void;
+export declare function setActiveReplySelfId(selfId: number | null): void;
+export declare function getActiveReplySelfId(): number | null;
+export declare function setForwardSuppressDelivery(suppress: boolean): void;
+export declare function getForwardSuppressDelivery(): boolean;
 export declare function clearActiveReplyTarget(): void;
 export declare function getActiveReplyTarget(): string | null;
+/**
+ * 回复会话 ID：同一用户问题下，AI 的多次 deliver 调用共享此 ID，便于统一处理
+ * 在 processInboundMessage 开始 dispatch 时设置，结束时清除
+ */
+export declare function setActiveReplySessionId(id: string | null): void;
+export declare function getActiveReplySessionId(): string | null;
+/** 判断 to 是否与当前回复目标相同（用于 forward 模式下拦截 outbound 自动发送） */
+export declare function isTargetActiveReply(to: string): boolean;
+/**
+ * forward 模式下：发往用户（非 selfId）的普通消息应被拦截，只保留发给自己（构建转发）和最终的合并转发
+ * @param type "private" | "group"
+ * @param targetId 目标 ID（userId 或 groupId）
+ * @returns true 表示应拦截，不发送
+ */
+export declare function shouldBlockSendInForwardMode(type: "private" | "group", targetId: number): boolean;
 /**
  * 若当前有活跃群聊回复目标，且传入的 to 可能被误判为私聊（裸数字或 user:xxx 与群号相同），则返回修正后的 target
  */

package/dist/reply-context.js

@@ -4,15 +4,69 @@
  * （Agent 可能传入裸数字或 user:xxx，导致误发私聊）
  */
 let activeReplyTarget = null;
+let activeReplySessionId = null;
+/** forward 模式下需拦截 channel outbound 的自动发送，避免 N 条重复发出 */
+let forwardSuppressDelivery = false;
+/** 机器人自身 QQ，forward 时发给自己需放行 */
+let activeReplySelfId = null;
 export function setActiveReplyTarget(to) {
     activeReplyTarget = to;
 }
+export function setActiveReplySelfId(selfId) {
+    activeReplySelfId = selfId;
+}
+export function getActiveReplySelfId() {
+    return activeReplySelfId;
+}
+export function setForwardSuppressDelivery(suppress) {
+    forwardSuppressDelivery = suppress;
+}
+export function getForwardSuppressDelivery() {
+    return forwardSuppressDelivery;
+}
 export function clearActiveReplyTarget() {
     activeReplyTarget = null;
 }
 export function getActiveReplyTarget() {
     return activeReplyTarget;
 }
+/**
+ * 回复会话 ID：同一用户问题下，AI 的多次 deliver 调用共享此 ID，便于统一处理
+ * 在 processInboundMessage 开始 dispatch 时设置，结束时清除
+ */
+export function setActiveReplySessionId(id) {
+    activeReplySessionId = id;
+}
+export function getActiveReplySessionId() {
+    return activeReplySessionId;
+}
+/** 规范化 target 便于比较：group:123 / onebot:group:123 -> group:123 */
+function normalizeTargetForCompare(t) {
+    const s = (t || "").replace(/^(onebot|qq|lagrange):/i, "").trim().toLowerCase();
+    return s || "";
+}
+/** 判断 to 是否与当前回复目标相同（用于 forward 模式下拦截 outbound 自动发送） */
+export function isTargetActiveReply(to) {
+    const target = activeReplyTarget;
+    if (!target)
+        return false;
+    return normalizeTargetForCompare(to) === normalizeTargetForCompare(target);
+}
+/**
+ * forward 模式下：发往用户（非 selfId）的普通消息应被拦截，只保留发给自己（构建转发）和最终的合并转发
+ * @param type "private" | "group"
+ * @param targetId 目标 ID（userId 或 groupId）
+ * @returns true 表示应拦截，不发送
+ */
+export function shouldBlockSendInForwardMode(type, targetId) {
+    if (!forwardSuppressDelivery)
+        return false;
+    const selfId = activeReplySelfId;
+    if (type === "private") {
+        return targetId !== selfId;
+    }
+    return true;
+}
 /**
  * 若当前有活跃群聊回复目标，且传入的 to 可能被误判为私聊（裸数字或 user:xxx 与群号相同），则返回修正后的 target
  */

package/dist/send-debug-log.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 发送调试日志：记录所有文字/媒体发送相关的关键信息，便于排查
+ * 日志路径：项目根目录的绝对路径 send-debug.log
+ * 启用：设置环境变量 OPENCLAW_ONEBOT_SEND_DEBUG=1
+ */
+/** 绝对路径：openclaw-onebot/send-debug.log，运行前设置 OPENCLAW_ONEBOT_SEND_DEBUG=1 启用 */
+export declare const SEND_DEBUG_LOG_PATH: string;
+export declare function logSend(layer: "send" | "connection", fn: string, data: {
+    targetType?: "group" | "user" | "to";
+    targetId?: number | string;
+    to?: string;
+    textPreview?: string;
+    textLen?: number;
+    suppressed?: boolean;
+    forwardSuppress?: boolean;
+    activeReplyTarget?: string | null;
+    /** 会话 ID，如 onebot:group:123 */
+    sessionId?: string | null;
+    /** 回复会话 ID，同一问题下多次 deliver 共享 */
+    replySessionId?: string | null;
+    messageId?: number | string;
+    isForward?: boolean;
+    nodeCount?: number;
+    imagePreview?: string;
+    mediaUrlPreview?: string;
+    blocked?: boolean;
+}): void;

package/dist/send-debug-log.js

@@ -0,0 +1,28 @@
+/**
+ * 发送调试日志：记录所有文字/媒体发送相关的关键信息，便于排查
+ * 日志路径：项目根目录的绝对路径 send-debug.log
+ * 启用：设置环境变量 OPENCLAW_ONEBOT_SEND_DEBUG=1
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** 绝对路径：openclaw-onebot/send-debug.log，运行前设置 OPENCLAW_ONEBOT_SEND_DEBUG=1 启用 */
+export const SEND_DEBUG_LOG_PATH = path.resolve(__dirname, "..", "send-debug.log");
+function isEnabled() {
+    return process.env.OPENCLAW_ONEBOT_SEND_DEBUG === "1";
+}
+let sessionLogged = false;
+export function logSend(layer, fn, data) {
+    if (!isEnabled())
+        return;
+    try {
+        if (!sessionLogged) {
+            fs.appendFileSync(SEND_DEBUG_LOG_PATH, `${new Date().toISOString()} [session] 日志路径(绝对): ${SEND_DEBUG_LOG_PATH}\n`);
+            sessionLogged = true;
+        }
+        const line = `${new Date().toISOString()} [${layer}] ${fn} ${JSON.stringify(data)}\n`;
+        fs.appendFileSync(SEND_DEBUG_LOG_PATH, line);
+    }
+    catch (_) { }
+}

package/dist/send.d.ts

@@ -12,12 +12,26 @@ type OneBotConfigGetter = () => OneBotAccountConfig | null;
 /**
  * 发送文本消息到 OneBot 目标（私聊或群聊）
  * @param getConfig 可选，用于按需连接（forward-websocket 下 message send 可独立运行）
+ * @param cfg 可选，用于读取 renderMarkdownToPlain 配置
  */
-export declare function sendTextMessage(to: string, text: string, getConfig?: OneBotConfigGetter): Promise<OneBotSendResult>;
+export declare function sendTextMessage(to: string, text: string, getConfig?: OneBotConfigGetter, cfg?: {
+    channels?: {
+        onebot?: {
+            renderMarkdownToPlain?: boolean;
+        };
+    };
+}): Promise<OneBotSendResult>;
 /**
  * 发送媒体消息（图片等）到 OneBot 目标
  * mediaUrl 支持 file:// 路径、http(s):// URL、base64://
  * @param getConfig 可选，用于按需连接
+ * @param cfg 可选，用于读取 renderMarkdownToPlain 配置
  */
-export declare function sendMediaMessage(to: string, mediaUrl: string, text?: string, getConfig?: OneBotConfigGetter): Promise<OneBotSendResult>;
+export declare function sendMediaMessage(to: string, mediaUrl: string, text?: string, getConfig?: OneBotConfigGetter, cfg?: {
+    channels?: {
+        onebot?: {
+            renderMarkdownToPlain?: boolean;
+        };
+    };
+}): Promise<OneBotSendResult>;
 export {};

package/dist/send.js

@@ -3,7 +3,10 @@
  * 对应 Lagrange.onebot context.ts 的 sendPrivateMsg / sendGroupMsg / 图片消息
  */
 import { sendPrivateMsg, sendGroupMsg, sendPrivateImage, sendGroupImage, } from "./connection.js";
-import { resolveTargetForReply } from "./reply-context.js";
+import { resolveTargetForReply, getForwardSuppressDelivery, isTargetActiveReply, getActiveReplyTarget, getActiveReplySessionId } from "./reply-context.js";
+import { logSend } from "./send-debug-log.js";
+import { getRenderMarkdownToPlain, getCollapseDoubleNewlines } from "./config.js";
+import { markdownToPlain, collapseDoubleNewlines } from "./markdown.js";
 function parseTarget(to) {
     const t = to.replace(/^(onebot|qq|lagrange):/i, "").trim();
     if (!t)
@@ -26,8 +29,25 @@ function parseTarget(to) {
 /**
  * 发送文本消息到 OneBot 目标（私聊或群聊）
  * @param getConfig 可选，用于按需连接（forward-websocket 下 message send 可独立运行）
+ * @param cfg 可选，用于读取 renderMarkdownToPlain 配置
  */
-export async function sendTextMessage(to, text, getConfig) {
+export async function sendTextMessage(to, text, getConfig, cfg) {
+    const forwardSuppress = getForwardSuppressDelivery();
+    const activeTarget = getActiveReplyTarget();
+    const suppressed = forwardSuppress && isTargetActiveReply(to);
+    logSend("send", "sendTextMessage", {
+        to,
+        textPreview: text?.slice(0, 80),
+        textLen: text?.length,
+        suppressed,
+        forwardSuppress,
+        activeReplyTarget: activeTarget,
+        sessionId: activeTarget,
+        replySessionId: getActiveReplySessionId(),
+    });
+    if (suppressed) {
+        return { ok: true, messageId: "" };
+    }
     const resolvedTo = resolveTargetForReply(to);
     const target = parseTarget(resolvedTo);
     if (!target) {
@@ -36,14 +56,24 @@ export async function sendTextMessage(to, text, getConfig) {
     if (!text?.trim()) {
         return { ok: false, error: "No text provided" };
     }
+    let finalText = getRenderMarkdownToPlain(cfg) ? markdownToPlain(text) : text.trim();
+    if (getCollapseDoubleNewlines(cfg))
+        finalText = collapseDoubleNewlines(finalText);
     try {
         let messageId;
         if (target.type === "group") {
-            messageId = await sendGroupMsg(target.id, text, getConfig);
+            messageId = await sendGroupMsg(target.id, finalText, getConfig);
         }
         else {
-            messageId = await sendPrivateMsg(target.id, text, getConfig);
+            messageId = await sendPrivateMsg(target.id, finalText, getConfig);
         }
+        logSend("send", "sendTextMessage", {
+            targetType: target.type,
+            targetId: target.id,
+            messageId,
+            sessionId: activeTarget,
+            replySessionId: getActiveReplySessionId(),
+        });
         return { ok: true, messageId: messageId != null ? String(messageId) : "" };
     }
     catch (err) {
@@ -57,8 +87,25 @@ export async function sendTextMessage(to, text, getConfig) {
  * 发送媒体消息（图片等）到 OneBot 目标
  * mediaUrl 支持 file:// 路径、http(s):// URL、base64://
  * @param getConfig 可选，用于按需连接
+ * @param cfg 可选，用于读取 renderMarkdownToPlain 配置
  */
-export async function sendMediaMessage(to, mediaUrl, text, getConfig) {
+export async function sendMediaMessage(to, mediaUrl, text, getConfig, cfg) {
+    const forwardSuppress = getForwardSuppressDelivery();
+    const activeTarget = getActiveReplyTarget();
+    const suppressed = forwardSuppress && isTargetActiveReply(to);
+    logSend("send", "sendMediaMessage", {
+        to,
+        textPreview: text?.slice(0, 40),
+        mediaUrlPreview: mediaUrl?.slice(0, 60),
+        suppressed,
+        forwardSuppress,
+        activeReplyTarget: activeTarget,
+        sessionId: activeTarget,
+        replySessionId: getActiveReplySessionId(),
+    });
+    if (suppressed) {
+        return { ok: true, messageId: "" };
+    }
     const resolvedTo = resolveTargetForReply(to);
     const target = parseTarget(resolvedTo);
     if (!target) {
@@ -67,14 +114,17 @@ export async function sendMediaMessage(to, mediaUrl, text, getConfig) {
     if (!mediaUrl?.trim()) {
         return { ok: false, error: "No mediaUrl provided" };
     }
+    let finalText = text?.trim() ? (getRenderMarkdownToPlain(cfg) ? markdownToPlain(text) : text.trim()) : "";
+    if (finalText && getCollapseDoubleNewlines(cfg))
+        finalText = collapseDoubleNewlines(finalText);
     try {
         let messageId;
-        if (text?.trim()) {
+        if (finalText) {
             if (target.type === "group") {
-                messageId = await sendGroupMsg(target.id, text, getConfig);
+                messageId = await sendGroupMsg(target.id, finalText, getConfig);
             }
             else {
-                messageId = await sendPrivateMsg(target.id, text, getConfig);
+                messageId = await sendPrivateMsg(target.id, finalText, getConfig);
             }
         }
         if (target.type === "group") {
@@ -87,6 +137,13 @@ export async function sendMediaMessage(to, mediaUrl, text, getConfig) {
             if (id != null)
                 messageId = id;
         }
+        logSend("send", "sendMediaMessage", {
+            targetType: target.type,
+            targetId: target.id,
+            messageId,
+            sessionId: activeTarget,
+            replySessionId: getActiveReplySessionId(),
+        });
         return { ok: true, messageId: messageId != null ? String(messageId) : "" };
     }
     catch (err) {

package/dist/setup.js

@@ -2,7 +2,7 @@
  * OneBot TUI 配置向导
  * openclaw onebot setup
  */
-import { cancel as clackCancel, isCancel, note as clackNote, outro as clackOutro, select as clackSelect, text as clackText, } from "@clack/prompts";
+import { cancel as clackCancel, confirm as clackConfirm, isCancel, note as clackNote, outro as clackOutro, select as clackSelect, text as clackText, } from "@clack/prompts";
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
@@ -22,25 +22,37 @@ export async function runOneBotSetup() {
             { value: "forward-websocket", label: "forward-websocket（正向，主动连接 OneBot）" },
             { value: "backward-websocket", label: "backward-websocket（反向，OneBot 连接本机）" },
         ],
-        initialValue: process.env.LAGRANGE_WS_TYPE === "backward-websocket" ? "backward-websocket" : "forward-websocket",
+        initialValue: process.env.ONEBOT_WS_TYPE === "backward-websocket" ? "backward-websocket" : "forward-websocket",
     }));
     const host = guardCancel(await clackText({
         message: "主机地址",
-        initialValue: process.env.LAGRANGE_WS_HOST || "127.0.0.1",
+        initialValue: process.env.ONEBOT_WS_HOST || "127.0.0.1",
     }));
     const portStr = guardCancel(await clackText({
         message: "端口",
-        initialValue: process.env.LAGRANGE_WS_PORT || "3001",
+        initialValue: process.env.ONEBOT_WS_PORT || "3001",
     }));
     const accessToken = guardCancel(await clackText({
         message: "Access Token（可选，留空回车跳过）",
-        initialValue: process.env.LAGRANGE_WS_ACCESS_TOKEN || "",
+        initialValue: process.env.ONEBOT_WS_ACCESS_TOKEN || "",
+    }));
+    const renderMarkdownToPlain = guardCancel(await clackConfirm({
+        message: "是否将机器人回复中的 Markdown 渲染为纯文本再发送？（去除 **、# 等标记，推荐开启）",
+        initialValue: true,
+    }));
+    const longMessageMode = guardCancel(await clackSelect({
+        message: "长消息处理模式（单次回复超过阈值时）：",
+        options: [
+            { value: "normal", label: "正常发送（分段发送）" },
+            { value: "og_image", label: "生成图片发送（需安装 node-html-to-image）" },
+            { value: "forward", label: "合并转发发送（发给自己后打包转发）" },
+        ],
+        initialValue: "normal",
+    }));
+    const longMessageThreshold = guardCancel(await clackText({
+        message: "长消息阈值（字符数，超过则启用上述模式）",
+        initialValue: "300",
     }));
-    const port = parseInt(String(portStr).trim(), 10);
-    if (!Number.isFinite(port)) {
-        console.error("端口必须为数字");
-        process.exit(1);
-    }
     let existing = {};
     if (existsSync(CONFIG_PATH)) {
         try {
@@ -48,7 +60,22 @@ export async function runOneBotSetup() {
         }
         catch { }
     }
+    const prevOnebot = (existing.channels || {}).onebot;
+    const whitelistInitial = Array.isArray(prevOnebot?.whitelistUserIds)
+        ? prevOnebot.whitelistUserIds.join(", ")
+        : "";
+    const whitelistInput = guardCancel(await clackText({
+        message: "白名单 QQ 号（逗号分隔，留空则所有人可回复）",
+        initialValue: whitelistInitial,
+    }));
+    const port = parseInt(String(portStr).trim(), 10);
+    if (!Number.isFinite(port)) {
+        console.error("端口必须为数字");
+        process.exit(1);
+    }
     const channels = existing.channels || {};
+    const thresholdNum = parseInt(String(longMessageThreshold).trim(), 10);
+    const whitelistIds = (String(whitelistInput).trim().split(/[,\s]+/).map((s) => s.trim()).filter(Boolean).map((s) => (/^\d+$/.test(s) ? Number(s) : null)).filter((n) => n != null));
     channels.onebot = {
         ...(channels.onebot || {}),
         type,
@@ -57,6 +84,10 @@ export async function runOneBotSetup() {
         ...(accessToken?.trim() ? { accessToken: String(accessToken).trim() } : {}),
         enabled: true,
         requireMention: true,
+        renderMarkdownToPlain,
+        longMessageMode,
+        longMessageThreshold: Number.isFinite(thresholdNum) ? thresholdNum : 300,
+        ...(whitelistIds.length > 0 ? { whitelistUserIds: whitelistIds } : {}),
     };
     const next = { ...existing, channels };
     writeFileSync(CONFIG_PATH, JSON.stringify(next, null, 2), "utf-8");

package/dist/tools.js

@@ -5,6 +5,8 @@
 import WebSocket from "ws";
 import { loadScript } from "./load-script.js";
 import { getWs, sendPrivateMsg, sendGroupMsg, sendGroupImage, sendPrivateImage, uploadGroupFile, uploadPrivateFile, getGroupMsgHistory, getGroupInfo, getStrangerInfo, getGroupMemberInfo, getAvatarUrl, } from "./connection.js";
+import { getRenderMarkdownToPlain } from "./config.js";
+import { markdownToPlain } from "./markdown.js";
 export const onebotClient = {
     sendGroupMsg,
     sendGroupImage,
@@ -35,14 +37,16 @@ export function registerTools(api) {
             if (!w || w.readyState !== WebSocket.OPEN) {
                 return { content: [{ type: "text", text: "OneBot 未连接" }] };
             }
+            const cfg = api?.config;
+            const textToSend = getRenderMarkdownToPlain(cfg) ? markdownToPlain(params.text) : params.text;
             const t = params.target.replace(/^onebot:/i, "");
             try {
                 if (t.startsWith("group:")) {
-                    await sendGroupMsg(parseInt(t.slice(6), 10), params.text);
+                    await sendGroupMsg(parseInt(t.slice(6), 10), textToSend);
                 }
                 else {
                     const id = parseInt(t.replace(/^user:/, ""), 10);
-                    await sendPrivateMsg(id, params.text);
+                    await sendPrivateMsg(id, textToSend);
                 }
                 return { content: [{ type: "text", text: "发送成功" }] };
             }

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
-  "id": "@kirigaya/openclaw-onebot",
+  "id": "openclaw-onebot",
   "name": "OneBot Channel",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OneBot v11 protocol channel (QQ/Lagrange.Core via WebSocket)",
   "author": "Lagrange.Onebot",
   "channels": ["onebot"],
@@ -23,6 +23,16 @@
         "default": true,
         "description": "群聊是否必须 @ 机器人才回复"
       },
+      "whitelistUserIds": {
+        "type": "array",
+        "items": { "type": "number" },
+        "description": "白名单 QQ 号，非空时仅白名单内用户可触发 AI；为空则所有人可回复"
+      },
+      "renderMarkdownToPlain": {
+        "type": "boolean",
+        "default": true,
+        "description": "是否将机器人回复中的 Markdown 渲染为纯文本再发送（去除 **、# 等标记）"
+      },
       "groupIncrease": {
         "type": "object",
         "properties": {
@@ -31,9 +41,13 @@
             "type": "string",
             "description": "欢迎语模板。占位符：{name} 新成员昵称，{userId} QQ号，{groupName} 群名，{groupId} 群号，{avatarUrl} 头像链接"
           },
-          "handler": {
+          "command": {
+            "type": "string",
+            "description": "在 cwd 下用系统 shell 执行的命令。调用方自动追加 --userId、--username、--groupId 参数。命令可自行发送（如调用 openclaw message send），或向 stdout 输出 JSON 行供 handler 发送"
+          },
+          "cwd": {
             "type": "string",
-            "description": "自定义脚本路径（.mjs/.ts/.mts），接收 ctx，返回 { text?, imagePath?, imageUrl? }。TS 需安装 tsx。优先级高于 message"
+            "description": "命令执行的工作目录（绝对路径）"
           }
         }
       },
@@ -42,6 +56,21 @@
         "default": 60,
         "description": "表情 ID（Lagrange/QQ NT set_msg_emoji_like），收到消息时添加，回复完成后取消"
       },
+      "onReplySessionEnd": {
+        "type": "string",
+        "description": "回复会话结束时的钩子脚本路径（.mjs/.ts/.mts）。脚本接收 ctx: { replySessionId, sessionId, to, chunks, userMessage }，可对同一问题下的多次发送做统一处理（如日志、合并、上报等）"
+      },
+      "longMessageMode": {
+        "type": "string",
+        "enum": ["normal", "og_image", "forward"],
+        "default": "normal",
+        "description": "长消息处理模式：normal 正常发送；og_image 生成图片（需 node-html-to-image）；forward 合并转发"
+      },
+      "longMessageThreshold": {
+        "type": "number",
+        "default": 300,
+        "description": "长消息阈值（字符数），超过则启用 longMessageMode"
+      },
       "cronJobs": {
         "type": "array",
         "description": "内置定时任务（无 AI 介入，直接执行脚本并推送到群聊）",
@@ -67,6 +96,7 @@
     "accessToken": { "label": "Access Token", "sensitive": true },
     "host": { "label": "主机地址", "placeholder": "127.0.0.1" },
     "port": { "label": "端口", "placeholder": "8080" },
-    "requireMention": { "label": "群聊需 @ 回复" }
+    "requireMention": { "label": "群聊需 @ 回复" },
+    "renderMarkdownToPlain": { "label": "Markdown 转纯文本" }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirigaya/openclaw-onebot",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "OneBot v11 protocol channel plugin for OpenClaw (QQ/Lagrange.Core/go-cqhttp)",
   "license": "MIT",
   "publishConfig": { "access": "public" },
@@ -46,6 +46,8 @@
   "scripts": {
     "build": "tsc",
     "test:connect": "npx tsx scripts/test-connect.ts",
+    "test:group-welcome": "npx tsx scripts/test-group-welcome.ts",
+    "test:group-increase-handler": "npx tsx scripts/test-group-increase-handler.ts",
     "prepublishOnly": "npm run build",
     "pub": "npm run build && npm publish"
   },
@@ -53,7 +55,12 @@
     "ws": "^8.17.0",
     "@clack/prompts": "^1.0.0",
     "tsx": "^4.0.0",
-    "cron": "^4.4.0"
+    "cron": "^4.4.0",
+    "marked": "^15.0.0",
+    "highlight.js": "^11.10.0"
+  },
+  "optionalDependencies": {
+    "node-html-to-image": "^3.0.0"
   },
   "peerDependencies": {
     "openclaw": "*",

package/skills/onebot-ops/SKILL.md

@@ -32,7 +32,7 @@ openclaw plugins install ./openclaw-onebot
 
 - Gateway 已启动：`openclaw gateway`
 - OneBot 实现（Lagrange.Core / go-cqhttp）已运行并暴露 WebSocket
-- 在 `openclaw.json` 中配置 `channels.onebot` 或通过 `LAGRANGE_WS_*` 环境变量
+- 在 `openclaw.json` 中配置 `channels.onebot` 或通过 `ONEBOT_WS_*` 环境变量
 
 ## OneBot 协议能力