@kirigaya/openclaw-onebot 1.0.0

package/dist/service.js

@@ -0,0 +1,71 @@
+/**
+ * OneBot WebSocket 服务
+ */
+import { getOneBotConfig } from "./config.js";
+import { connectForward, createServerAndWait, setWs, stopConnection, handleEchoResponse, startImageTempCleanup, stopImageTempCleanup } from "./connection.js";
+import { processInboundMessage } from "./handlers/process-inbound.js";
+import { handleGroupIncrease } from "./handlers/group-increase.js";
+import { startScheduler, stopScheduler } from "./scheduler.js";
+export function registerService(api) {
+    api.registerService({
+        id: "onebot-ws",
+        start: async () => {
+            const config = getOneBotConfig(api);
+            if (!config) {
+                api.logger?.warn?.("[onebot] no config, service will not connect");
+                return;
+            }
+            try {
+                let ws;
+                if (config.type === "forward-websocket") {
+                    ws = await connectForward(config);
+                }
+                else {
+                    ws = await createServerAndWait(config);
+                }
+                setWs(ws);
+                api.logger?.info?.("[onebot] WebSocket connected");
+                startImageTempCleanup();
+                startScheduler(api);
+                ws.on("message", (data) => {
+                    try {
+                        const payload = JSON.parse(data.toString());
+                        if (handleEchoResponse(payload))
+                            return;
+                        if (payload.meta_event_type === "heartbeat")
+                            return;
+                        const msg = payload;
+                        if (msg.post_type === "message" && (msg.message_type === "private" || msg.message_type === "group")) {
+                            processInboundMessage(api, msg).catch((e) => {
+                                api.logger?.error?.(`[onebot] processInboundMessage: ${e?.message}`);
+                            });
+                        }
+                        else if (msg.post_type === "notice" && msg.notice_type === "group_increase") {
+                            handleGroupIncrease(api, msg).catch((e) => {
+                                api.logger?.error?.(`[onebot] handleGroupIncrease: ${e?.message}`);
+                            });
+                        }
+                    }
+                    catch (e) {
+                        api.logger?.error?.(`[onebot] parse message: ${e?.message}`);
+                    }
+                });
+                ws.on("close", () => {
+                    api.logger?.info?.("[onebot] WebSocket closed");
+                });
+                ws.on("error", (e) => {
+                    api.logger?.error?.(`[onebot] WebSocket error: ${e?.message}`);
+                });
+            }
+            catch (e) {
+                api.logger?.error?.(`[onebot] start failed: ${e?.message}`);
+            }
+        },
+        stop: async () => {
+            stopImageTempCleanup();
+            stopScheduler();
+            stopConnection();
+            api.logger?.info?.("[onebot] service stopped");
+        },
+    });
+}

package/dist/setup.d.ts

@@ -0,0 +1 @@
+export declare function runOneBotSetup(): Promise<void>;

package/dist/setup.js

@@ -0,0 +1,65 @@
+/**
+ * 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 { existsSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const OPENCLAW_HOME = join(homedir(), ".openclaw");
+const CONFIG_PATH = join(OPENCLAW_HOME, "openclaw.json");
+function guardCancel(v) {
+    if (isCancel(v)) {
+        clackCancel("已取消。");
+        process.exit(0);
+    }
+    return v;
+}
+export async function runOneBotSetup() {
+    const type = guardCancel(await clackSelect({
+        message: "连接类型",
+        options: [
+            { 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",
+    }));
+    const host = guardCancel(await clackText({
+        message: "主机地址",
+        initialValue: process.env.LAGRANGE_WS_HOST || "127.0.0.1",
+    }));
+    const portStr = guardCancel(await clackText({
+        message: "端口",
+        initialValue: process.env.LAGRANGE_WS_PORT || "3001",
+    }));
+    const accessToken = guardCancel(await clackText({
+        message: "Access Token（可选，留空回车跳过）",
+        initialValue: process.env.LAGRANGE_WS_ACCESS_TOKEN || "",
+    }));
+    const port = parseInt(String(portStr).trim(), 10);
+    if (!Number.isFinite(port)) {
+        console.error("端口必须为数字");
+        process.exit(1);
+    }
+    let existing = {};
+    if (existsSync(CONFIG_PATH)) {
+        try {
+            existing = JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+        }
+        catch { }
+    }
+    const channels = existing.channels || {};
+    channels.onebot = {
+        ...(channels.onebot || {}),
+        type,
+        host: String(host).trim(),
+        port,
+        ...(accessToken?.trim() ? { accessToken: String(accessToken).trim() } : {}),
+        enabled: true,
+        requireMention: true,
+    };
+    const next = { ...existing, channels };
+    writeFileSync(CONFIG_PATH, JSON.stringify(next, null, 2), "utf-8");
+    clackNote(`配置已保存到 ${CONFIG_PATH}`, "完成");
+    clackOutro("运行 openclaw gateway restart 使配置生效");
+}

package/dist/tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Agent 工具注册
+ * 供 OpenClaw cron 等场景下，AI 调用 OneBot 能力
+ */
+import { sendPrivateMsg, sendGroupMsg, sendGroupImage, sendPrivateImage, getGroupMsgHistory, getGroupInfo, getStrangerInfo, getGroupMemberInfo, getAvatarUrl } from "./connection.js";
+export interface OneBotClient {
+    sendGroupMsg: typeof sendGroupMsg;
+    sendGroupImage: typeof sendGroupImage;
+    sendPrivateMsg: typeof sendPrivateMsg;
+    sendPrivateImage: typeof sendPrivateImage;
+    getGroupMsgHistory: typeof getGroupMsgHistory;
+    getGroupInfo: typeof getGroupInfo;
+    getStrangerInfo: typeof getStrangerInfo;
+    getGroupMemberInfo: typeof getGroupMemberInfo;
+    getAvatarUrl: typeof getAvatarUrl;
+}
+export declare const onebotClient: OneBotClient;
+export declare function registerTools(api: any): void;

package/dist/tools.js

@@ -0,0 +1,188 @@
+/**
+ * Agent 工具注册
+ * 供 OpenClaw cron 等场景下，AI 调用 OneBot 能力
+ */
+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";
+export const onebotClient = {
+    sendGroupMsg,
+    sendGroupImage,
+    sendPrivateMsg,
+    sendPrivateImage,
+    getGroupMsgHistory,
+    getGroupInfo,
+    getStrangerInfo,
+    getGroupMemberInfo,
+    getAvatarUrl,
+};
+export function registerTools(api) {
+    if (typeof api.registerTool !== "function")
+        return;
+    api.registerTool({
+        name: "onebot_send_text",
+        description: "通过 OneBot 发送文本消息。target 格式：user:QQ号 或 group:群号",
+        parameters: {
+            type: "object",
+            properties: {
+                target: { type: "string", description: "user:123456 或 group:789012" },
+                text: { type: "string", description: "要发送的文本" },
+            },
+            required: ["target", "text"],
+        },
+        async execute(_id, params) {
+            const w = getWs();
+            if (!w || w.readyState !== WebSocket.OPEN) {
+                return { content: [{ type: "text", text: "OneBot 未连接" }] };
+            }
+            const t = params.target.replace(/^onebot:/i, "");
+            try {
+                if (t.startsWith("group:")) {
+                    await sendGroupMsg(parseInt(t.slice(6), 10), params.text);
+                }
+                else {
+                    const id = parseInt(t.replace(/^user:/, ""), 10);
+                    await sendPrivateMsg(id, params.text);
+                }
+                return { content: [{ type: "text", text: "发送成功" }] };
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: `发送失败: ${e?.message}` }] };
+            }
+        },
+    });
+    api.registerTool({
+        name: "onebot_send_image",
+        description: "通过 OneBot 发送图片。target 格式：user:QQ号 或 group:群号。image 为本地路径(file://)或 URL 或 base64://",
+        parameters: {
+            type: "object",
+            properties: {
+                target: { type: "string" },
+                image: { type: "string", description: "图片路径或 URL" },
+            },
+            required: ["target", "image"],
+        },
+        async execute(_id, params) {
+            const w = getWs();
+            if (!w || w.readyState !== WebSocket.OPEN) {
+                return { content: [{ type: "text", text: "OneBot 未连接" }] };
+            }
+            const t = params.target.replace(/^onebot:/i, "");
+            try {
+                if (t.startsWith("group:")) {
+                    await sendGroupImage(parseInt(t.slice(6), 10), params.image);
+                }
+                else {
+                    await sendPrivateImage(parseInt(t.replace(/^user:/, ""), 10), params.image);
+                }
+                return { content: [{ type: "text", text: "图片发送成功" }] };
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: `发送失败: ${e?.message}` }] };
+            }
+        },
+    });
+    api.registerTool({
+        name: "onebot_upload_file",
+        description: "通过 OneBot 上传文件到群或私聊。target: user:QQ号 或 group:群号。file 为本地绝对路径，name 为显示文件名",
+        parameters: {
+            type: "object",
+            properties: {
+                target: { type: "string" },
+                file: { type: "string" },
+                name: { type: "string" },
+            },
+            required: ["target", "file", "name"],
+        },
+        async execute(_id, params) {
+            const w = getWs();
+            if (!w || w.readyState !== WebSocket.OPEN) {
+                return { content: [{ type: "text", text: "OneBot 未连接" }] };
+            }
+            const t = params.target.replace(/^onebot:/i, "");
+            try {
+                if (t.startsWith("group:")) {
+                    await uploadGroupFile(parseInt(t.slice(6), 10), params.file, params.name);
+                }
+                else {
+                    await uploadPrivateFile(parseInt(t.replace(/^user:/, ""), 10), params.file, params.name);
+                }
+                return { content: [{ type: "text", text: "文件上传成功" }] };
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: `上传失败: ${e?.message}` }] };
+            }
+        },
+    });
+    api.registerTool({
+        name: "onebot_get_group_msg_history",
+        description: "获取群聊历史消息（需 Lagrange.Core，go-cqhttp 可能不支持）。用于定时总结、日报等场景",
+        parameters: {
+            type: "object",
+            properties: {
+                group_id: { type: "number", description: "群号" },
+                count: { type: "number", description: "获取条数，默认 50" },
+                message_seq: { type: "number", description: "可选，起始消息序号" },
+                message_id: { type: "number", description: "可选，起始消息 ID" },
+            },
+            required: ["group_id"],
+        },
+        async execute(_id, params) {
+            const w = getWs();
+            if (!w || w.readyState !== WebSocket.OPEN) {
+                return { content: [{ type: "text", text: "OneBot 未连接" }] };
+            }
+            try {
+                const msgs = await getGroupMsgHistory(params.group_id, {
+                    count: params.count ?? 50,
+                    message_seq: params.message_seq,
+                    message_id: params.message_id,
+                });
+                const summary = msgs.map((m) => {
+                    const text = typeof m.message === "string" ? m.message : JSON.stringify(m.message);
+                    const nick = m.sender?.nickname ?? m.sender?.user_id ?? "?";
+                    return `[${new Date(m.time * 1000).toISOString()}] ${nick}: ${text.slice(0, 200)}`;
+                });
+                return { content: [{ type: "text", text: summary.join("\n") || "无历史消息" }] };
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: `获取失败: ${e?.message}` }] };
+            }
+        },
+    });
+    api.registerTool({
+        name: "onebot_run_script",
+        description: "执行用户配置的 JS/TS 脚本（.mjs/.ts/.mts），脚本可调用 OneBot API（获取群历史、发图等）。用于定时任务中实现自定义逻辑（如 OG 图片生成、日报汇总）",
+        parameters: {
+            type: "object",
+            properties: {
+                scriptPath: { type: "string", description: "脚本路径，相对 process.cwd() 或绝对路径，支持 .mjs/.ts/.mts，如 ./daily-summary.mjs 或 ./daily-summary.ts" },
+                groupIds: { type: "array", items: { type: "number" }, description: "要处理的群号列表" },
+            },
+            required: ["scriptPath"],
+        },
+        async execute(_id, params) {
+            const w = getWs();
+            if (!w || w.readyState !== WebSocket.OPEN) {
+                return { content: [{ type: "text", text: "OneBot 未连接" }] };
+            }
+            try {
+                const mod = await loadScript(params.scriptPath);
+                const fn = mod?.default ?? mod?.run ?? mod?.execute;
+                if (typeof fn !== "function") {
+                    return { content: [{ type: "text", text: `脚本未导出 default/run/execute 函数` }] };
+                }
+                const ctx = {
+                    onebot: onebotClient,
+                    groupIds: params.groupIds ?? [],
+                };
+                const result = await fn(ctx);
+                const out = result != null ? String(result) : "执行完成";
+                return { content: [{ type: "text", text: out }] };
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: `脚本执行失败: ${e?.message}` }] };
+            }
+        },
+    });
+}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * OneBot 协议类型定义
+ */
+export interface OneBotMessage {
+    post_type: string;
+    message_type?: "private" | "group";
+    message_id?: number;
+    user_id?: number;
+    group_id?: number;
+    message?: Array<{
+        type: string;
+        data?: Record<string, unknown>;
+    }>;
+    raw_message?: string;
+    self_id?: number;
+    time?: number;
+    notice_type?: string;
+    [key: string]: unknown;
+}
+export interface OneBotAccountConfig {
+    accountId?: string;
+    type: "forward-websocket" | "backward-websocket";
+    host: string;
+    port: number;
+    accessToken?: string;
+    path?: string;
+    enabled?: boolean;
+}

package/dist/types.js

@@ -0,0 +1,4 @@
+/**
+ * OneBot 协议类型定义
+ */
+export {};

package/openclaw.plugin.json

@@ -0,0 +1,72 @@
+{
+  "id": "@kirigaya/openclaw-onebot",
+  "name": "OneBot Channel",
+  "version": "1.0.0",
+  "description": "OneBot v11 protocol channel (QQ/Lagrange.Core via WebSocket)",
+  "author": "Lagrange.Onebot",
+  "channels": ["onebot"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "type": {
+        "type": "string",
+        "enum": ["forward-websocket", "backward-websocket"],
+        "description": "连接类型：正向或反向 WebSocket"
+      },
+      "host": { "type": "string", "description": "OneBot 主机地址" },
+      "port": { "type": "number", "description": "OneBot 端口" },
+      "accessToken": { "type": "string", "description": "访问令牌（可选）" },
+      "path": { "type": "string", "description": "WS 路径，默认 /onebot/v11/ws" },
+      "requireMention": {
+        "type": "boolean",
+        "default": true,
+        "description": "群聊是否必须 @ 机器人才回复"
+      },
+      "groupIncrease": {
+        "type": "object",
+        "properties": {
+          "enabled": { "type": "boolean", "default": false },
+          "message": {
+            "type": "string",
+            "description": "欢迎语模板。占位符：{name} 新成员昵称，{userId} QQ号，{groupName} 群名，{groupId} 群号，{avatarUrl} 头像链接"
+          },
+          "handler": {
+            "type": "string",
+            "description": "自定义脚本路径（.mjs/.ts/.mts），接收 ctx，返回 { text?, imagePath?, imageUrl? }。TS 需安装 tsx。优先级高于 message"
+          }
+        }
+      },
+      "thinkingEmojiId": {
+        "type": "number",
+        "default": 60,
+        "description": "表情 ID（Lagrange/QQ NT set_msg_emoji_like），收到消息时添加，回复完成后取消"
+      },
+      "cronJobs": {
+        "type": "array",
+        "description": "内置定时任务（无 AI 介入，直接执行脚本并推送到群聊）",
+        "items": {
+          "type": "object",
+          "required": ["name", "cron", "script", "groupIds"],
+          "properties": {
+            "name": { "type": "string", "description": "任务名称" },
+            "cron": { "type": "string", "description": "cron 表达式，如 0 8 * * * 表示每天 8:00" },
+            "timezone": { "type": "string", "default": "Asia/Shanghai", "description": "时区" },
+            "script": { "type": "string", "description": "脚本路径，相对 process.cwd()，如 ./Tiphareth/src/openclaw/cron/daily-news.ts" },
+            "groupIds": {
+              "type": "array",
+              "items": { "type": "number" },
+              "description": "要推送的群号列表"
+            }
+          }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "accessToken": { "label": "Access Token", "sensitive": true },
+    "host": { "label": "主机地址", "placeholder": "127.0.0.1" },
+    "port": { "label": "端口", "placeholder": "8080" },
+    "requireMention": { "label": "群聊需 @ 回复" }
+  }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@kirigaya/openclaw-onebot",
+  "version": "1.0.0",
+  "description": "OneBot v11 protocol channel plugin for OpenClaw (QQ/Lagrange.Core/go-cqhttp)",
+  "license": "MIT",
+  "publishConfig": { "access": "public" },
+  "author": "LSTM-Kirigaya",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LSTM-Kirigaya/openclaw-onebot.git"
+  },
+  "bugs": {
+    "url": "https://github.com/LSTM-Kirigaya/openclaw-onebot/issues"
+  },
+  "homepage": "https://github.com/LSTM-Kirigaya/openclaw-onebot#readme",
+  "keywords": [
+    "openclaw",
+    "onebot",
+    "qq",
+    "lagrange",
+    "cqhttp",
+    "chatbot"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": "./dist/index.js",
+  "files": [
+    "dist",
+    "skills",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "openclaw": {
+    "extensions": ["./dist/index.js"],
+    "skills": ["skills/onebot-ops", "skills/onebot-scripts"],
+    "channel": {
+      "id": "onebot",
+      "label": "OneBot",
+      "selectionLabel": "OneBot (QQ/Lagrange)",
+      "docsPath": "/channels/onebot",
+      "blurb": "OneBot v11 protocol via WebSocket (go-cqhttp, Lagrange.Core, etc.)",
+      "order": 85,
+      "aliases": ["qq", "lagrange", "cqhttp"]
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test:connect": "npx tsx scripts/test-connect.ts",
+    "prepublishOnly": "npm run build",
+    "pub": "npm run build && npm publish"
+  },
+  "dependencies": {
+    "ws": "^8.17.0",
+    "@clack/prompts": "^1.0.0",
+    "tsx": "^4.0.0",
+    "cron": "^4.4.0"
+  },
+  "peerDependencies": {
+    "openclaw": "*",
+    "clawdbot": "*"
+  },
+  "peerDependenciesMeta": {
+    "clawdbot": { "optional": true },
+    "openclaw": { "optional": true }
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.10"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/skills/onebot-ops/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: onebot-ops
+description: OneBot (QQ/Lagrange) 渠道运维与使用规范。消息收发通过 Channel outbound 与 deliver 完成，不依赖 Agent 工具。
+---
+
+# OneBot 运维/使用规范
+
+OneBot v11 协议渠道，支持 QQ/Lagrange.Core/go-cqhttp。消息收发均通过 Channel 的 outbound 与 deliver 完成，**不依赖 Agent 工具**。
+
+## 快速判断
+
+| 场景 | 说明 |
+|------|------|
+| **接收消息** | 私聊全回复，群聊默认仅 @ 回复，详见 [receive.md](receive.md) |
+| **message 工具 target** | 群聊必须用 `ctx.To`（格式 `group:群号`），勿用 SenderId |
+| **发送消息** | 使用 `openclaw message send` CLI，详见 [send.md](send.md) |
+| **配置** | 运行 `openclaw onebot setup` 或编辑 `openclaw.json`，详见 [config.md](config.md) |
+
+## 插件安装
+
+```bash
+openclaw plugins install @openclaw/onebot
+```
+
+本地开发时：
+
+```bash
+openclaw plugins install ./openclaw-onebot
+```
+
+## 前置条件
+
+- Gateway 已启动：`openclaw gateway`
+- OneBot 实现（Lagrange.Core / go-cqhttp）已运行并暴露 WebSocket
+- 在 `openclaw.json` 中配置 `channels.onebot` 或通过 `LAGRANGE_WS_*` 环境变量
+
+## OneBot 协议能力
+
+对应 Lagrange.onebot `context.ts` 的 API：
+
+| 能力 | 说明 |
+|------|------|
+| **send_private_msg** | 发送私聊消息 |
+| **send_group_msg** | 发送群消息 |
+| **send_msg** | 按 message_type 发送 |
+| **图片消息** | message 为 `[{ type: "image", data: { file } }]` |
+| **delete_msg** | 撤回消息 |
+| **get_msg** | 获取单条消息 |
+| **get_group_msg_history** | 获取群历史（Lagrange.Core 扩展） |
+| **upload_group_file** | 上传群文件 |
+| **upload_private_file** | 上传私聊文件 |
+| **set_msg_emoji_like** | 表情回应（Lagrange/QQ NT 扩展） |
+
+## 常用命令
+
+| 命令 | 说明 |
+|------|------|
+| `openclaw onebot setup` | 交互式配置 OneBot 连接 |
+| `openclaw message send --channel onebot --target group:xxx --message "hi"` | 发送群消息 |
+| `openclaw gateway status` | 查看 Gateway 状态 |
+| `openclaw logs --follow` | 查看日志 |

package/skills/onebot-ops/config.md

@@ -0,0 +1,55 @@
+# 配置参数
+
+## 参数表
+
+| 参数 | 说明 |
+|------|------|
+| type | `forward-websocket` / `backward-websocket` |
+| host | OneBot 主机地址 |
+| port | 端口 |
+| accessToken | 访问令牌（可选） |
+| path | 反向 WS 路径，默认 `/onebot/v11/ws` |
+| requireMention | 群聊是否需 @ 才回复，默认 `true` |
+| thinkingEmojiId | 表情 ID（set_msg_emoji_like），默认 60 |
+| groupIncrease | 新成员入群欢迎，详见 [receive.md](receive.md) |
+| cronJobs | 内置定时任务（无 AI 介入），详见下方 |
+
+## TUI 配置
+
+运行 `openclaw onebot setup` 进行交互式配置。
+
+配置写入 `openclaw.json` 的 `channels.onebot` 或通过 `LAGRANGE_WS_*` 环境变量提供。
+
+## 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| LAGRANGE_WS_TYPE | forward-websocket / backward-websocket |
+| LAGRANGE_WS_HOST | 主机地址 |
+| LAGRANGE_WS_PORT | 端口 |
+| LAGRANGE_WS_ACCESS_TOKEN | 访问令牌 |
+| LAGRANGE_WS_PATH | 反向 WS 路径 |
+
+## cronJobs 配置
+
+在 `openclaw.json` 中配置内置定时任务，直接执行脚本并推送到群，无需 AI 介入：
+
+```json
+{
+  "channels": {
+    "onebot": {
+      "cronJobs": [
+        {
+          "name": "每日科技新闻",
+          "cron": "0 8 * * *",
+          "timezone": "Asia/Shanghai",
+          "script": "./Tiphareth/src/openclaw/cron/daily-news.ts",
+          "groupIds": [782833642, 1046693162]
+        }
+      ]
+    }
+  }
+}
+```
+
+脚本需导出 `default` / `run` / `execute` 函数，接收 `ctx: { onebot, groupIds }`。