1. 从被动响应到主动出击OpenClaw 自动化到底解决什么问题如果你用过一段时间的 OpenClaw大概率会有一种感觉它很好用但总有点“被动”。你问一句它答一句你不说话它就安安静静待在那里。真正让 OpenClaw 从“聊天机器人”变成“自动化助手”的是它内置的三套主动触发机制——Cron 定时任务、Webhooks 外部触发、以及 EventBus 事件总线。这三者组合起来才能实现真正意义上的事件驱动自动化。先说清楚它们各自能做什么。Cron 解决的是“到点自动干活”每天早上 8 点给你推一份天气加日历加未读邮件的简报每 2 小时检查一次 CI/CD 有没有挂每周一整理 GitHub Issue 积压。Webhooks 解决的是“外部系统一有动静就通知我”GitHub 合并了 PR、Sentry 抓到线上报错、Stripe 收到付款这些事件发生后几秒内就能触发 OpenClaw 去处理。EventBus 则是内部模块之间的“广播站”让 Skill、Node、Web UI 这些组件可以松散地互相感知而不用硬编码调用对方。适合谁来读这篇如果你已经在本地跑通了 OpenClaw想让它在你不发消息的时候也能主动做事那这篇就是为你写的。我会从源码层面拆解这三种机制的协作流程给出可以直接复制的 Cron 表达式配置、Webhook 接入示例和 EventBus 事件注册代码最后带你走一遍本地验证事件流转的完整步骤。整个过程不需要你改 OpenClaw 的核心代码全部通过配置文件和命令行完成。有一个设计点值得先点出来Cron 和 Webhook 触发的“消息”最终都会走和用户消息完全一样的分发链路——Session 解析、Agent 路由、Agent Runtime、Skill 调用、回复生成。这意味着你不需要为自动化任务单独写一套处理逻辑它们和用户主动发消息走的是同一条路。这个“统一入口”设计是 OpenClaw 自动化体系里最值得学习的地方后面拆源码时会反复看到它的影子。2. 前置准备TaoToken 接入与 OpenClaw 运行环境确认在动手配置自动化之前得先确保 OpenClaw 能正常调用模型。OpenClaw 本身是一个 Agent 框架它需要后端模型服务来生成回复。这里我用 TaoToken 作为模型接入层它兼容 OpenAI 风格的 API配置起来比较直接。首先确认你的 OpenClaw 已经安装并能启动。打开终端执行openclaw --version如果能看到版本号输出说明基础环境没问题。接下来配置模型接入。OpenClaw 的模型配置通常在~/.openclaw/openclaw.json里你需要填入 Base URL、API Key 和 Model ID 这三件套。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 Base URL 使用。去 TaoToken 控制台创建一个 API Key然后编辑配置文件{ models: { default: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: gpt-4o } } }这里 Model ID 填你实际要用的模型名称TaoToken 支持多种主流模型具体可以在模型对话页面查看可用列表。配置保存后用一条简单命令验证连通性openclaw chat --message 你好测试一下连接如果能看到模型正常回复说明接入成功。如果报 401检查 API Key 是否复制完整如果报连接超时检查 Base URL 是否写成了https://taotoken.net/api而不是其他路径。另外Cron 和 Webhook 功能依赖 OpenClaw 的 Gateway 服务。确认 Gateway 在运行openclaw gateway status如果显示未启动用openclaw gateway start启动。Webhook 端点默认监听http://localhost:18789后面配置 Webhook 时会用到这个端口。如果你改了默认端口记得在 Webhook 配置里同步修改。3. 可复制配置Cron 表达式、Webhook 注册与 EventBus 事件绑定这一节是整篇的核心操作部分我会给出三套可以直接复制到~/.openclaw/openclaw.json的配置片段以及对应的源码逻辑说明。你不需要理解每一行代码先跑起来再回头看原理。3.1 Cron 定时任务配置Cron 的配置写在openclaw.json的cron数组里。每个任务需要id、name、schedule、message、enabled五个字段。schedule用标准五段式 cron 表达式分 时 日 月 星期。{ cron: [ { id: morning-briefing, name: 早晨简报, schedule: 0 8 * * *, message: 给我一个今天的早晨简报天气、日历安排、未读邮件摘要。, enabled: true }, { id: ci-check, name: CI 状态检查, schedule: 0 */2 * * *, message: 检查最近 2 小时的 CI/CD 状态有失败的通知我。, enabled: true }, { id: nightly-todo, name: 晚间 Todo 总结, schedule: 0 23 * * *, message: 给我一个今天的未完成 Todo 总结。, enabled: false } ] }几个常用表达式对照0 8 * * *是每天 8:000 */2 * * *是每 2 小时整点*/15 * * * *是每 15 分钟0 9 * * 1是每周一 9:00。注意enabled为false的任务不会注册到调度器方便你临时关掉某个任务而不用删配置。源码层面CronEngine 在初始化时会遍历配置数组对每个enabled为 true 的任务调用schedule.createJob()创建定时器。定时器触发时triggerJob()会构造一条InboundMessage其中channel设为internal:cronpeerId设为system然后调用gateway.dispatchInbound()把这条合成消息丢进标准分发链路。这就是为什么 Cron 任务能复用用户消息的全部处理逻辑——它本质上就是伪造了一条“用户消息”。3.2 Webhook 端点注册Webhook 配置写在webhooks数组里。每个 Webhook 需要id、name、secret、messageTemplate、enabled。messageTemplate支持{payload.xxx}占位符用来从请求体里提取字段。{ webhooks: [ { id: github-pr-merged, name: GitHub PR 合并通知, secret: my-secret-token, messageTemplate: GitHub 上有一个 PR 被合并了{payload.pull_request.title}仓库{payload.repository.full_name}, enabled: true }, { id: sentry-alert, name: Sentry 报错告警, secret: sentry-secret, messageTemplate: Sentry 检测到新报错{payload.data.issue.title}请帮我诊断。, enabled: true } ] }注册后Gateway 会暴露统一端点POST http://localhost:18789/webhook/{webhookId}。以 GitHub 为例在仓库的 Webhook 设置里填入http://你的地址:18789/webhook/github-pr-mergedSecret 填my-secret-tokenContent type 选application/json。源码里 Webhook 处理分三步先验证签名x-hub-signature-256头签名不对直接返回 401签名通过后立即返回 200让发起方尽快确认接收然后用setImmediate异步处理渲染模板、构造合成消息、调用dispatchInbound。先回 200 再异步处理是 Webhook 的标准做法因为 GitHub、Stripe 这些发起方通常要求 5 到 10 秒内收到响应超时会触发重发。3.3 EventBus 事件注册EventBus 是 Gateway 内部的轻量级事件总线用于模块间解耦。发布和订阅的代码长这样// 发布事件 eventBus.emit(skill:gmail:archive_completed, { sessionId: main, count: 17, timestamp: new Date(), }); // 订阅事件 eventBus.on(skill:gmail:archive_completed, async (data) { await dashboard.updateStats({ type: archive, count: data.count }); });事件命名建议用模块:子模块:动作的格式比如skill:gmail:archive_completed、cron:job:triggered、webhook:received。这样订阅方可以按前缀批量监听也方便排查问题时定位来源。EventBus 让 Skill、Node、Automation Engine、Web UI 这些组件可以松散地互相感知而不需要直接调用对方接口。4. 验证请求本地触发 Cron、Webhook 与事件流转的完整步骤配置写好了接下来要验证它们真的能跑起来。这一节我带你走一遍完整的本地验证流程每一步都有明确的预期结果。4.1 验证 Cron 任务先列出当前注册的所有 Cron 任务openclaw cron list预期输出会显示每个任务的 id、name、schedule 和 enabled 状态。如果你看到morning-briefing和ci-check都在列表里说明配置被正确加载了。然后手动触发一次不用等到调度时间openclaw cron trigger morning-briefing这条命令会立即构造合成消息并走分发链路。几秒后你应该能在你配置的 Slack 或 iMessage 里收到一条早晨简报。如果没收到检查 Gateway 日志openclaw gateway logs --tail 50日志里应该能看到dispatchInbound被调用以及后续的 Agent 路由和 Skill 调用记录。你也可以临时改一个任务的 schedule 为*/1 * * * *每分钟触发观察它是否按预期频率执行。验证完记得改回去。4.2 验证 Webhook 端点用 curl 模拟一次 GitHub PR 合并事件curl -X POST http://localhost:18789/webhook/github-pr-merged \ -H Content-Type: application/json \ -H x-hub-signature-256: sha256你的签名 \ -d { pull_request: {title: 修复登录超时问题}, repository: {full_name: myorg/myrepo} }签名验证这块如果你暂时不想算签名可以先把配置里的secret改成一个空字符串或者临时在代码里跳过验证仅限本地调试。生产环境一定要保留签名验证。预期结果是 curl 立即返回 200然后几秒内你的聊天窗口收到一条消息“GitHub 上有一个 PR 被合并了修复登录超时问题仓库myorg/myrepo”。如果返回 404检查 webhookId 是否拼写正确如果返回 401检查签名计算是否正确如果返回 200 但没收到消息检查 Gateway 日志里setImmediate之后的异步处理是否有报错。4.3 验证 EventBus 事件流转EventBus 的验证需要一点代码。你可以在 OpenClaw 的插件目录里写一个简单的监听器// ~/.openclaw/plugins/event-logger.ts export function register(eventBus) { eventBus.on(cron:job:triggered, (data) { console.log([EventBus] Cron 任务触发:, data.jobId); }); eventBus.on(webhook:received, (data) { console.log([EventBus] Webhook 收到:, data.webhookId); }); }然后在openclaw.json里注册这个插件。重启 Gateway 后再触发一次 Cron 或 Webhook你就能在控制台看到 EventBus 的事件日志。这一步能帮你确认事件总线确实在工作而不是只有 Cron 和 Webhook 各自为战。4.4 验证幂等去重Webhook 的幂等去重也值得验证一下。用同一个x-github-delivery头连续发两次请求curl -X POST http://localhost:18789/webhook/github-pr-merged \ -H Content-Type: application/json \ -H x-github-delivery: test-delivery-001 \ -d {pull_request: {title: 测试幂等}, repository: {full_name: test/repo}}第一次会正常触发 Agent第二次应该被idempotencyStore拦截直接返回 200 但不触发新的 Agent 调用。你可以在日志里看到duplicate delivery detected之类的记录。这个机制防止了因为网络重试导致的重复触发。5. 常见报错排查401、local proxy failed、reading choices 与 OAuth 问题自动化配置过程中最容易踩的坑集中在几个报错上。这一节我把常见错误和排查路径列出来你遇到问题时可以对照着查。5.1 401 Unauthorized这个报错通常出现在两个地方。一是模型调用返回 401说明 TaoToken 的 API Key 不对或过期了。检查openclaw.json里的apiKey字段确认没有多余空格确认 Key 没有在控制台被删除。二是 Webhook 签名验证返回 401说明x-hub-signature-256计算不对。GitHub 的签名算法是sha256HMAC-SHA256(secret, rawBody)注意要用原始请求体而不是解析后的 JSON。5.2 local proxy failed这个报错一般出现在 Gateway 启动时提示本地代理连接失败。OpenClaw 的 Gateway 默认监听localhost:18789如果这个端口被其他程序占用了就会报这个错。用lsof -i :18789查一下占用进程要么杀掉占用进程要么在配置里改 Gateway 端口。改端口后记得同步更新 Webhook 的 Payload URL。5.3 reading choices 报错这个报错通常出现在模型返回格式不符合预期时。OpenClaw 期望模型返回 OpenAI 风格的choices数组如果 TaoToken 返回的格式有差异或者模型返回了空内容就会报reading choices相关的错误。排查方法先用openclaw chat --message test确认基础对话正常如果基础对话也报这个错检查 Model ID 是否写对以及 TaoToken 控制台里该模型是否可用。5.4 OAuth 与 Gmail Pub/Sub 授权失败如果你在配置 Gmail Pub/Sub 时遇到 OAuth 报错通常是授权范围没配对或者 token 过期了。Gmail 的 watch 需要gmail.readonly和pubsub相关权限。检查你的 GCP 项目里是否启用了 Gmail API 和 Pub/Sub API以及 OAuth 同意屏幕是否配置正确。token 过期的话重新走一遍授权流程即可。5.5 Cron 任务不触发如果openclaw cron list能看到任务但到点了没触发先检查enabled是否为 true。然后检查 Gateway 是否在运行Cron 调度器是 Gateway 的一部分Gateway 停了 Cron 也不会触发。最后检查系统时间是否正确cron 表达式依赖系统时钟。5.6 Webhook 收到但 Agent 没响应如果 curl 返回 200 但聊天窗口没消息问题多半出在异步处理阶段。看 Gateway 日志里setImmediate之后的记录常见原因是messageTemplate里的占位符路径写错了导致渲染出的消息为空。比如{payload.pull_request.title}要求请求体里确实有pull_request.title这个嵌套字段路径不对就渲染成空字符串Agent 收到空消息可能直接忽略。6. 把自动化接进日常工作流从配置到习惯配置跑通只是第一步真正让 OpenClaw 自动化产生价值的是把它接进你的日常工作流。我自己的做法是先从一两个高频场景开始跑顺了再逐步加。早晨简报是最容易见效的。把morning-briefing的 schedule 设成你起床前 15 分钟message 里写清楚你要什么天气、日历、未读邮件、今天的 Todo。跑几天后你会发现自己不再需要手动去各个 App 里翻信息了。CI 检查适合开发团队。ci-check每 2 小时跑一次有失败就通知。关键是 message 要写具体“检查最近 2 小时的 CI/CD 状态有失败的通知我并附上失败 job 的名称和链接。”这样 Agent 返回的结果才可直接操作。Webhook 方面GitHub PR 合并通知和 Sentry 报错告警是两个最实用的场景。PR 合并通知让你随时知道团队动态Sentry 告警让线上问题在第一时间被感知。如果你用 Stripe 收款加一个收款通知也很方便。EventBus 更多是给二次开发用的。如果你在写自己的 Skill 或插件通过 EventBus 订阅cron:job:triggered或webhook:received事件可以在不修改核心代码的情况下扩展自动化行为。比如订阅webhook:received后自动把事件写入自己的数据库或者触发一个自定义的通知渠道。最后提醒一点自动化任务多了之后记得定期openclaw cron list检查一下有没有失效或不再需要的任务。我试过配置了七八个 Cron 任务结果有几个早就没用了还在跑白白消耗模型调用额度。定期清理和enabled: false临时关闭比直接删配置更灵活。如果你还没接入 TaoToken可以去控制台创建一个 API Key然后按照第 2 节的配置填进openclaw.json。接入文档里有更详细的参数说明模型对话页面可以测试不同模型的效果。对于需要长期跑自动化任务的场景Coding Plan 提供了更稳定的调用额度适合把 OpenClaw 当成日常助手来用的同学。