★ FEATURED ARTICLE 1. 为什么你的 OpenClaw 只会“戳一下动一下”很多人把 OpenClaw 装好、连上模型之后会发现它其实是个很被动的家伙你不发消息它就安安静静待着你问一句它答一句。这跟“AI 助理”的预期差得有点远。真正好用的 Agent应该像一位靠谱的同事——早上主动把今天的日程推给你发现重要邮件会提醒你到了固定时间自己去抓数据、跑脚本、发汇总。要做到这一点靠的不是把模型换得更聪明而是给它装上“主动干活”的三条链路Heartbeat 心跳、Cron 定时任务、Webhook 事件回调。先说清楚这三个词到底解决什么问题不然后面配置容易懵。Heartbeat 心跳是让 OpenClaw 每隔一段时间自己“醒过来”一次醒来后去读一份巡检清单判断有没有事情需要处理。它解决的是“无人触发时也要动起来”的问题。Cron 定时任务是在固定时间点执行固定动作比如每天早上 9 点抓新闻、每周一生成周报。它解决的是“周期性、可预期”的任务。Webhook 事件回调是让外部系统在发生某件事时“拍一拍”OpenClaw比如收到一封标记为加急的邮件、代码仓库来了一个新 PR、监控系统报警。它解决的是“事件驱动、实时响应”的问题。这三条链路配合起来OpenClaw 才从“算盘”变成“有主观能动性的助理”。本文适合已经在本地或云主机跑起 OpenClaw、想让它主动干活的人也适合还在观望、想先搞清楚心跳和定时任务怎么配的新手。下面我会给出可复制的配置片段、验证动作以及我自己踩过的坑。为了让长时间挂机不心疼算力我会用 TaoToken 作为统一的模型接入层把 Base URL、Key、Model ID 三件套一次配好后面心跳频率想调多密都不慌。需要先明确一点主动干活意味着它会自己消耗算力。心跳设成 5 分钟一次一天就是 288 次唤醒如果每次唤醒都跑一轮模型推理按量计费的账单会很难看。所以“让它主动”和“控制成本”必须一起考虑这也是我后面推荐用套餐制接入的原因。2. 用 TaoToken 给 OpenClaw 备好模型接入层在配心跳和定时任务之前得先保证 OpenClaw 能稳定、便宜地调用模型。OpenClaw 支持多种协议接入最省事的做法是走 OpenAI 兼容协议把 Base URL 指向 TaoToken 的 API 地址再填上 Key 和 Model ID。这样无论你后面用哪个模型配置层都不用改。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 Base URL 使用。Key 在控制台的 API Keys 页面创建创建后复制保存页面只显示一次。Model ID 按你实际要用的模型填写比如做 Agent 工作流时选一个工具调用能力强的模型即可。如果你用的是 Claude Code 这类走 Anthropic 协议的客户端TaoToken 也提供了对应的接入方式文档里有详细说明。对 OpenClaw 来说重点是三件套Base URL、Key、Model ID缺一不可。很多人配完发现报 401八成是 Key 复制时带了空格或者 Base URL 多写了斜杠。这里给一个 OpenClaw 的配置片段示例路径是~/.openclaw/openclaw.json不同版本可能略有差异以你本地实际文件为准。配置里把模型提供方指向 TaoToken{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: 你的ModelID } } }保存后重启 OpenClaw让它重新加载配置。如果你不确定 Model ID 填什么可以先到模型对话页面确认可用模型再回到配置里填。配好这一层后面的心跳、Cron、Webhook 才有稳定的模型底座不然任务触发了却调不通模型排查起来会很乱。另外提醒一句不要把 Key 硬编码到会提交到 Git 的文件里。OpenClaw 的配置文件通常在用户目录下问题不大但如果你把配置同步到仓库记得用环境变量或单独的密钥文件。3. 可复制配置Heartbeat、Cron、Webhook 三件套这一节是核心三条链路逐个给配置。先说 Heartbeat。OpenClaw 的心跳默认是开启的默认间隔 30 分钟。它每次醒来会执行一条默认指令大意是“如果存在 HEARTBEAT.md 就读取并严格执行不要推断或重复旧任务没事就回复 HEARTBEAT_OK”。所以真正决定它醒来干什么的是工作区里的HEARTBEAT.md文件。工作区路径一般是~/.openclaw/workspace。如果目录下没有HEARTBEAT.md就手动创建一个。内容写成巡检清单比如# 日常心跳检查清单 1. 扫描邮箱检查是否有标记为加急的未读邮件。 2. 检查今天的日历列出 2 小时内即将到期的待办。 3. 如果当前是白天且前两项无异常根据最近对话记录判断是否适合主动发起一次简短交流。 4. 如果没有任何需要处理的事项回复 HEARTBEAT_OK。这里有个我踩过的坑默认指令里没有写HEARTBEAT.md的具体位置模型有时会找不到文件导致心跳触发了却什么都没执行。解决办法是在清单开头或配置里写明绝对路径比如/Users/你的用户名/.openclaw/workspace/HEARTBEAT.md让模型明确去哪里读。心跳间隔在配置里调整。把间隔改短能让它更主动但算力消耗成倍上升。我实测下来配合套餐制接入把间隔设到 5 到 15 分钟比较平衡。配置片段示例{ heartbeat: { enabled: true, intervalMinutes: 10, workspaceFile: /Users/你的用户名/.openclaw/workspace/HEARTBEAT.md } }再说 Cron 定时任务。OpenClaw 的定时任务可以写在配置文件里也可以用系统 crontab 调用它的 CLI。用配置文件更集中示例{ cron: [ { name: morning-news, schedule: 0 9 * * *, prompt: 抓取今天的主要科技新闻汇总成 5 条要点发给我。 }, { name: weekly-report, schedule: 0 18 * * 5, prompt: 生成本周工作周报包含完成事项和下周计划。 } ] }schedule用的是标准 cron 表达式0 9 * * *表示每天 9 点。注意时区OpenClaw 一般跟随系统时区如果你在云主机上跑确认系统时区是不是你想要的。最后是 Webhook。它的作用是让外部事件触发 OpenClaw。配置里需要填一个回调地址和触发后执行的 prompt。示例{ webhook: { enabled: true, path: /hooks/openclaw, secret: 你的回调密钥, prompt: 收到外部事件{{payload}}。请判断是否需要立即处理并给出行动建议。 } }path是 OpenClaw 监听的路径外部系统往http://你的地址:端口/hooks/openclaw发 POST 请求即可。secret用于校验请求来源别省略。{{payload}}会被替换成请求体内容方便模型拿到事件详情。三条链路配好后OpenClaw 就同时具备了“定时醒”“按点干”“被事件拍醒”三种能力。接下来要验证它们是不是真的触发了。4. 验证请求确认三条链路真的触发了配置写完不代表生效必须逐条验证。先说 Heartbeat。最直接的验证方式是看日志。OpenClaw 运行时会在终端或日志文件里输出心跳记录你会看到类似“heartbeat tick”或“HEARTBEAT_OK”的字样。如果间隔设成 10 分钟等 10 分钟看日志有没有新记录。如果一直没动静先确认enabled是不是 true再确认HEARTBEAT.md路径是否正确。你也可以在HEARTBEAT.md里临时写一条“每次醒来都回复一句当前时间”这样日志里能直观看到它确实醒了。验证完再改回正式清单。Cron 的验证更简单把某条任务的schedule临时改成下一分钟比如现在是 14:30就写31 14 * * *等一分钟看它有没有执行。执行结果一般会出现在日志或你配置的输出渠道里。如果没执行检查 cron 表达式格式以及 OpenClaw 进程是否有权限读取配置。Webhook 的验证用 curl 最方便。假设 OpenClaw 监听在本地 3000 端口回调路径是/hooks/openclaw执行curl -X POST http://127.0.0.1:3000/hooks/openclaw \ -H Content-Type: application/json \ -H X-Webhook-Secret: 你的回调密钥 \ -d {event:test,message:这是一条测试事件}如果配置正确OpenClaw 会收到请求并触发对应 prompt日志里能看到它开始处理。返回 401 说明 secret 不对返回 404 说明 path 写错连接被拒绝说明服务没起来或端口不对。三条都验证通过后你可以做一个组合测试让 Cron 在某个时间点触发一个任务任务里包含一次模型调用确认整条链路从触发到模型响应都通。这一步过了才算真正把 OpenClaw 接进了 Agent 工作流。5. 常见报错排查401、local proxy failed、reading choices、OAuth主动干活跑起来后最容易在模型调用这一层翻车。下面几个报错我都遇到过逐个说排查思路。401 Unauthorized最常见。原因通常是 Key 错误、Key 过期、或者 Base URL 和 Key 不匹配。先确认baseUrl是https://taotoken.net/api没有多余斜杠再确认 Key 是从控制台 API Keys 页面新创建的复制时没有带空格或换行。如果用的是环境变量确认变量真的被加载了。local proxy failed这个报错一般出现在本地网络层说明 OpenClaw 请求模型时连接没建立起来。先确认本机能不能正常访问外网再确认 Base URL 拼写正确。如果你在容器里跑 OpenClaw检查容器网络是否能出网。这个报错和模型本身无关纯粹是链路问题。reading choices 相关报错通常表现为解析响应时拿不到choices字段。原因可能是返回的不是标准 OpenAI 格式或者模型返回了错误信息但被当成正常响应解析。先看完整响应体确认返回结构再确认 Model ID 填的是 TaoToken 支持的模型。如果 Model ID 写错有些网关会返回一个非标准结构的错误。OAuth 相关报错如果你用的是需要 OAuth 的客户端比如某些走 Anthropic 协议的场景报错往往和 token 刷新有关。检查 OAuth 配置里的回调地址、client id、secret 是否和文档一致。对 OpenClaw 来说走 OpenAI 兼容协议加 API Key 是最省事的路径能避开大部分 OAuth 麻烦。排查时有个通用技巧把 OpenClaw 的日志级别调高让它打印完整的请求和响应。很多报错光看一行信息猜不出来看到原始响应就一目了然了。另外改完配置一定要重启进程热加载不一定生效。6. 把主动能力用起来从接入到长期运行三条链路验证通过、报错也排干净之后OpenClaw 就真正具备了主动干活的能力。你可以按自己的场景组合使用用 Heartbeat 做日常巡检和主动关怀用 Cron 做周期性任务用 Webhook 接外部事件。三者叠加它就不再是“戳一下动一下”的工具而是一个会自己找事做的助理。长期运行有两个现实问题要提前想好。第一是算力成本心跳频率越高、任务越复杂消耗越大。用套餐制接入能把成本锁住不用每次心跳都盯着账单。第二是任务边界HEARTBEAT.md和 Cron 的 prompt 要写清楚“什么该做、什么不该做”否则模型可能在你没预期的时候发起一堆动作。我的做法是先在清单里只放低风险任务跑稳了再逐步加。如果你还没配好模型接入层建议先把 Base URL、Key、Model ID 三件套配通再去调心跳和定时任务。接入文档里有各协议的详细说明API Keys 页面负责创建密钥模型对话页面可以先用对话确认模型可用。想长期跑 Agent 工作流、又不想被按量计费牵着走的话Coding Plan 这类套餐更适合挂机场景。把接入层稳住剩下的就是慢慢调你的巡检清单和触发规则让 OpenClaw 越来越像你想要的那位助理。
阅读完成 · 觉得有帮助？
