1. OpenClaw 定时任务到底解决什么问题OpenClaw 是一个可以本地部署、通过消息渠道微信、Telegram、钉钉等跟你交互的 AI 助手框架。它本身能聊天、能查资料、能跑工作流但真正让它从「你问一句它答一句」变成「它自己到点就干活」的是定时任务模块。核心检索词就是 OpenClaw 定时任务配置而定时任务的灵魂是 Cron 表达式。先说清楚它适合谁如果你每天要手动整理资讯、汇总数据、发提醒、跑巡检那这套东西就是给你准备的。我自己的用法是早上 8 点自动拉天气和科技资讯下午 6 点自动生成当天的工作摘要中间还有几个巡检任务盯着服务状态。配置好之后这些活全是它自己干你只需要在消息里看结果。定时任务的本质是一个「触发器 动作 通知」的三段式结构。触发器就是 Cron 表达式决定什么时候跑动作是 OpenClaw 内置或自定义的 action决定跑什么通知决定结果发到哪里。三者缺一不可很多人配完不生效八成是这三段里有一段没对上。Cron 表达式是五个位置从左到右分别是分、时、日、月、周。这里有个坑不同系统对「周」的取值定义不一样有的 0 是周日有的 1 是周一。OpenClaw 用的是标准五段式0 和 7 都代表周日。下面这张对照表建议直接存下来表达式含义0 8 * * *每天早上 8 点整0 18 * * 5每周五下午 6 点*/2 * * * *每隔 2 小时整点触发0 9-18 * * 1-5工作日 9 到 18 点每小时整点0 0 * * *每天午夜 0 点0 8 * * 1-5工作日早上 8 点*/15 * * * *每 15 分钟注意*/2这种写法是「步长」不是「每 2 小时的第 0 分钟」那么简单它会在 0、2、4、6……这些整点触发。如果你想要「每隔 2 小时但从 1 点开始」得写0 1-23/2 * * *这个细节后面排障会用到。场景上最常见的四类是每日摘要把当天要干的事、要看的资讯汇总成一条消息、定时巡检检查服务是否存活、磁盘是否告警、定时推送固定时间发资讯或提醒、定时备份凌晨跑数据备份。这四类覆盖了 90% 的自动化需求配置思路完全一致只是 action 和 notify 不同。2. TaoToken 统一 Key 接入前置准备OpenClaw 的定时任务里很多 action 是要调用大模型的比如生成摘要、总结资讯、判断巡检结果。默认情况下你可能在配置里填了某个厂商的 API 地址和 Key但一旦你要换模型、换厂商或者多个任务用不同模型Key 管理就会变得很乱。这时候用 TaoToken 做统一 Key 接入就省事了一个 Key、一个 Base URL所有模型调用都走同一个通道。TaoToken 的定位是统一模型调用入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。你需要在控制台创建一个 API Key然后把它填到 OpenClaw 的模型配置里。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 管理页是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。前置准备分三步。第一步拿到 Key。登录控制台在 API Keys 页面新建一个 Key复制出来。这个 Key 就是后面所有模型调用的凭证别泄露。第二步确认你要用的模型 ID。TaoToken 支持多种模型你在模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 可以先试一下确认模型能正常返回再把它写进配置。第三步确认 OpenClaw 的模型配置位置。OpenClaw 的模型配置通常在config/models.yaml或者环境变量里具体看你部署方式。Docker 部署的话一般挂载在/opt/openclaw/config下。这里要强调一个原则Base URL、Key、Model ID 三件套必须同时改不能只改一个。很多人只把 Key 换成 TaoToken 的Base URL 还指着原来的地址结果就是 401 或者连接失败。正确的做法是三个一起对齐。如果你用的是 Claude Code 或者类似的编码工具TaoToken 也提供了对应的接入方式文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Claude Code 的接入可以参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 里面写了 Base URL 和 Key 怎么填。对于长期跑编码任务或 Agent 的场景可以考虑 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 适合任务量大、需要稳定额度的用户。前置准备做完后你手里应该有三样东西TaoToken 的 API Key、Base URLhttps://taotoken.net/api、以及你要用的 Model ID。接下来就是把这些填进 OpenClaw 的配置并让定时任务用上它们。3. 可复制的定时任务配置片段这一节直接给可复制的配置。OpenClaw 的定时任务配置一般写在config/reminders.yaml或者config/tasks.yaml里具体文件名看你版本但结构一致。下面是一个完整的配置示例包含模型调用和 TaoToken 接入。先看模型配置通常单独放在config/models.yaml# config/models.yaml models: default: provider: openai-compatible base_url: https://taotoken.net/api api_key: sk-你的TaoTokenKey model: claude-3-5-sonnet timeout: 60 summary: provider: openai-compatible base_url: https://taotoken.net/api api_key: sk-你的TaoTokenKey model: gpt-4o-mini timeout: 30注意base_url后面不要加/v1TaoToken 的端点就是https://taotoken.net/api加错了会 404。api_key填你在控制台拿到的 Key。model填模型 ID不同模型 ID 不一样以模型对话页确认的为准。然后是定时任务配置# config/reminders.yaml reminders: timezone: Asia/Shanghai - name: morning_weather cron: 0 8 * * * action: get_weather params: city: 上海 model: default notify: channel: wechat - name: morning_tech_news cron: 0 9 * * * action: fetch_tech_news model: summary notify: channel: telegram format: brief - name: daily_summary cron: 0 18 * * * action: generate_daily_summary model: default notify: channels: - wechat - telegram - name: service_check cron: */15 * * * * action: check_status params: targets: - http://localhost:8080/health notify: channel: telegram only_on_failure: true这里有几个关键点。timezone一定要设成Asia/Shanghai否则容器默认 UTC你的 8 点会变成下午 4 点。model字段引用的是models.yaml里的模型名这样不同任务可以用不同模型比如摘要用便宜的复杂分析用强的。only_on_failure是巡检任务的常用参数正常时不打扰你出问题才发消息。如果你用的是 JSON 格式配置等价写法如下{ reminders: { timezone: Asia/Shanghai, tasks: [ { name: morning_weather, cron: 0 8 * * *, action: get_weather, params: { city: 上海 }, model: default, notify: { channel: wechat } } ] } }配置写完后重启 OpenClaw 让配置生效。Docker 部署的话docker restart openclaw重启后看日志确认任务已加载docker logs openclaw | grep -i reminder\|cron\|task如果看到类似loaded 4 reminders的输出说明配置被正确读取了。如果没看到检查 YAML 缩进YAML 对缩进极其敏感两个空格和四个空格混用会直接解析失败。4. 手动触发与日志核对验证配置写完不代表跑通必须手动触发一次确认任务能执行、模型能返回、通知能发出。OpenClaw 一般提供手动触发命令常见的是docker exec -it openclaw openclaw task run morning_weather或者通过 CLIopenclaw reminder trigger --name morning_weather执行后你会看到类似输出[INFO] triggering task: morning_weather [INFO] cron matched: 0 8 * * * [INFO] calling model: default (claude-3-5-sonnet) [INFO] model response received, length312 [INFO] sending notification to wechat [INFO] task completed in 4.2s如果卡在calling model这一步多半是 TaoToken 的 Key 或 Base URL 有问题。如果卡在sending notification那是消息渠道配置的问题跟模型无关。日志核对要看三个点。第一任务是否被触发看triggering task这行。第二模型是否返回看model response received如果这里报错往下翻会有具体的 HTTP 状态码。第三通知是否发出看sending notification后面有没有completed。我实测下来最容易出问题的是模型调用这一步。常见报错是401 Unauthorized说明 Key 不对或者没带上。检查models.yaml里的api_key是不是复制完整了有没有多余空格。另一个是local proxy failed这个通常是你本地网络配置的问题不是 TaoToken 的问题检查一下容器能不能访问外网。验证模型调用是否正常可以单独跑一个测试curl -X POST https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-3-5-sonnet, messages: [{role: user, content: 回复OK}] }如果返回里有choices字段说明 Key 和端点都没问题。如果返回reading choices相关错误说明返回结构不对检查模型 ID 是否写错。手动触发成功后等一个真实的 Cron 周期确认它按点执行。比如你配了0 8 * * *那就第二天早上 8 点看消息有没有到。如果没到先看日志有没有触发记录再看通知渠道。这一步不能省因为手动触发和定时触发在环境上可能有差异比如容器时间、时区。5. 常见报错与排查对照这一节把真实会遇到的报错列出来对照着查。401 Unauthorized模型调用被拒。原因通常是 Key 错误、Key 过期、或者 Base URL 写成了别的地址。排查顺序先确认api_key是 TaoToken 控制台新建的再确认base_url是https://taotoken.net/api最后用上面的 curl 命令单独测一次。如果 curl 通但 OpenClaw 不通检查 OpenClaw 有没有读到最新的models.yaml改完配置要重启。local proxy failed本地网络或代理配置问题。OpenClaw 容器访问外部 API 时如果宿主机有代理设置容器可能继承不到或者继承错了。检查docker run时有没有传HTTP_PROXY环境变量或者docker-compose.yml里的网络配置。这个报错跟 TaoToken 无关是本地环境问题。reading choices 报错模型返回结构解析失败。常见于模型 ID 写错或者返回的不是标准 OpenAI 兼容格式。确认model字段填的是 TaoToken 支持的模型 ID不要自己编。另外检查provider是不是openai-compatible。OAuth 相关报错如果你用的是 Claude Code 或 Codex 这类需要 OAuth 的工具报错可能是 token 过期。这类工具接入 TaoToken 时Base URL 和 Key 的填法跟普通 API 不同参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 里的说明。Codex 的auth.json里要填对base_url和api_key三件套缺一不可。任务不执行Cron 表达式写错或者时区不对。先确认表达式五个位置都对再用docker logs openclaw看有没有解析错误。时区问题最隐蔽容器默认 UTC你写0 8 * * *实际是北京时间下午 4 点。在reminders.yaml里加timezone: Asia/Shanghai解决。重复执行同一个任务跑了多次。检查有没有多个 OpenClaw 实例同时跑或者配置里同一个任务写了两次。如果是分布式部署需要加锁机制OpenClaw 支持run_once: true参数但那只针对单次任务周期任务要去重得靠外部锁。执行失败无重试任务失败后没有重试。在任务配置里加retry: max: 3 interval: 5m这样失败后会重试 3 次每次间隔 5 分钟。对于网络抖动导致的失败很有效。排查的核心思路是分层先确认配置被加载再确认任务被触发再确认模型调用成功最后确认通知发出。每一层都有对应的日志顺着日志往下查比盲目改配置快得多。6. 把定时任务用起来的下一步配置跑通之后你可以开始扩展场景。比如把每日摘要做成多城市天气 日程 资讯的聚合用format字段自定义消息模板notify: channel: wechat format: | {{city}}今日天气 温度{{temp}}° 天气{{weather}} 穿衣建议{{dressing}}巡检任务可以加多个目标失败才通知- name: service_check cron: */15 * * * * action: check_status params: targets: - http://localhost:8080/health - http://localhost:9090/metrics notify: channel: telegram only_on_failure: true如果你要跑长期编码任务或 Agent 类工作流模型调用量大可以考虑 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 额度和稳定性更适合持续跑。模型对话验证在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。最后说一个实用技巧定时任务的配置改完后不要直接等下一个周期先手动触发一次确认没问题再等真实周期。这样能省掉很多「等了一天才发现没跑」的时间。另外把reminders.yaml和models.yaml纳入版本管理改坏了能回滚。