1. OpenClaw 定时任务为什么总在服务器上翻车OpenClaw 定时任务配置这件事表面看就是往 Crontab 里塞一行命令但真到服务器上跑十有八九会卡在三个地方Crontab 表达式写错、环境变量缺失、日志找不到。我自己第一次把 OpenClaw 的发布脚本挂到 Crontab 上时手动执行一切正常定时触发却静默失败排查了大半天才发现是 cron 的环境变量里没有 PATH 和 API Key。这篇聚焦 OpenClaw 定时任务在真实服务器上的落地从 Crontab 表达式编写、环境变量缺失到日志排查给出可复制的 config.toml 骨架与 TaoToken 统一 Key 接入配置并附三步验证动作手动触发、查看日志、确认任务状态。适合已经在用 OpenClaw 做自动化发布、数据收集、周报生成但被定时任务坑过的同学。读完你能拿到一套能直接抄的配置以及一套排错顺序不用再靠猜。OpenClaw 本身是一个可扩展的自动化代理框架定时任务只是它的一种触发方式。你可以把它理解成一个会按时间表干活的助手Crontab 负责叫醒它config.toml 告诉它用哪个模型、哪个 Key脚本负责具体动作。三者缺一任务就跑不通。2. TaoToken 前置统一 Key 接入与 config.toml 骨架在讲 Crontab 之前先把 Key 接入这块理清楚因为后面环境变量缺失的坑八成跟 Key 有关。OpenClaw 调用模型时需要 API Key如果你每个脚本里硬编码一个 Key维护起来会很痛苦。TaoToken 提供统一 Key 接入一个 Key 走通模型对话、编码任务等场景配置集中管理。官网地址https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址https://taotoken.net/api先在你的 OpenClaw 工作目录下准备 config.toml。下面是一个可复制的骨架重点看[llm]段和[schedule]段# ~/.openclaw/config.toml [llm] provider openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} # 从环境变量读取不要硬编码 model claude-sonnet-4-5 timeout 120 [schedule] enabled true log_dir ~/.openclaw/workspace/logs retry 2 retry_interval 300 # 秒 [publish] dry_run false targets [csdn, wechat]这里的关键点是api_key ${TAOTOKEN_API_KEY}。OpenClaw 支持从环境变量插值读取这样你的 Key 不会写死在文件里也方便在 Crontab 里统一注入。如果你还没生成 Key去控制台创建控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite API Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite生成后先别急着写进 Crontab先在 shell 里验证一次export TAOTOKEN_API_KEYsk-你的key echo $TAOTOKEN_API_KEY | head -c 8能打印出前 8 位说明环境变量生效。这一步很重要因为 Crontab 默认不加载你的.bashrc你在终端里 export 的变量cron 是看不到的。这就是后面环境变量缺失的根源。3. 可复制配置Crontab 表达式与脚本骨架3.1 Crontab 表达式怎么写才不出错Crontab 五个字段的顺序是分 时 日 月 周。很多人写错是因为把周和日搞混。记住一句话日和周是或的关系不是且。比如0 22 * * 0表示每周日 22:00而不是每月 0 号。下面这张表对照几个常用表达式需求表达式说明每天 7:000 7 * * *分0时7每天 22:000 22 * * *晚上十点每周日 22:000 22 * * 0周字段 0 表示周日每 30 分钟*/30 * * * *步长写法每月 1 号 9:000 9 1 * *日字段1编辑 Crontabcrontab -e加入下面三行注意用绝对路径并且显式注入环境变量# OpenClaw 定时任务 TAOTOKEN_API_KEYsk-你的key PATH/usr/local/bin:/usr/bin:/bin 0 7 * * * cd /home/youruser/.openclaw /bin/bash workspace/skills/ai-publisher/scripts/publish-daily.sh workspace/logs/cron.log 21 0 22 * * * cd /home/youruser/.openclaw /bin/bash workspace/skills/ai-publisher/scripts/fetch-metrics.sh workspace/logs/cron.log 21 0 22 * * 0 cd /home/youruser/.openclaw /bin/bash workspace/skills/ai-publisher/scripts/weekly-report.sh workspace/logs/cron.log 21注意几个细节第一TAOTOKEN_API_KEY和PATH写在 Crontab 顶部cron 会把它们作为环境变量传给后面的任务第二每条任务都cd到工作目录避免相对路径找不到文件第三 ... 21把标准输出和错误都重定向到日志否则 cron 出错你什么都看不到。3.2 脚本骨架手动可跑定时可复用脚本本身要保证手动能跑通否则定时一定失败。下面是一个发布脚本的骨架#!/bin/bash # ~/.openclaw/workspace/skills/ai-publisher/scripts/publish-daily.sh set -euo pipefail WORKDIR$HOME/.openclaw cd $WORKDIR # 检查 Key 是否存在 if [ -z ${TAOTOKEN_API_KEY:-} ]; then echo [ERROR] TAOTOKEN_API_KEY 未设置 2 exit 1 fi echo [INFO] $(date %F %T) 开始执行每日发布 python3 workspace/skills/ai-publisher/publish.py --config config.toml echo [INFO] $(date %F %T) 执行完成set -euo pipefail这行很关键任何一步出错就退出未定义变量报错管道错误也捕获。这样定时任务失败时你能第一时间从日志看到原因而不是静默跳过。给脚本加执行权限chmod x ~/.openclaw/workspace/skills/ai-publisher/scripts/*.sh4. 三步验证手动触发、查看日志、确认状态配置写完不代表跑通必须走完这三步。4.1 第一步手动触发先脱离 cron手动跑一次脚本确认逻辑本身没问题export TAOTOKEN_API_KEYsk-你的key cd ~/.openclaw bash workspace/skills/ai-publisher/scripts/publish-daily.sh如果这一步就报错先解决脚本问题别急着怀疑 cron。常见的是 Key 无效或 base_url 写错。你可以先用模型对话接口验证 Key 是否可用模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite4.2 第二步查看日志手动跑通后看日志确认输出符合预期tail -f ~/.openclaw/workspace/logs/cron.log正常日志长这样[INFO] 2026-03-13 07:00:01 开始执行每日发布 [INFO] 2026-03-13 07:00:03 读取文章 ai-originally-so-008.json [INFO] 2026-03-13 07:00:15 发布到 CSDN 成功 [INFO] 2026-03-13 07:00:16 执行完成如果日志里出现TAOTOKEN_API_KEY 未设置说明 cron 环境变量没注入成功回到第 3.1 节检查 Crontab 顶部的变量行。4.3 第三步确认任务状态查看当前 Crontab 里挂了哪些任务crontab -l确认 cron 服务本身在运行# Linux systemctl status cron # macOS sudo launchctl list | grep cron如果 cron 服务没起来任务永远不会触发。这一步经常被忽略尤其是容器环境里 cron 默认不启动。5. 本篇常见错排查5.1 任务未执行先看 cron 服务crontab -l能看到任务但到点没反应第一件事是确认 cron 服务在跑。容器里常见的情况是镜像没装 cron或者没启动守护进程。Linux 上systemctl status cron systemctl start cron5.2 脚本报错权限与路径Permission denied说明脚本没执行权限chmod x补上。No such file or directory多半是相对路径问题cron 的工作目录不是你的家目录所以脚本里要么用绝对路径要么先cd。5.3 发布失败Key 与网络日志里出现 401 或 403检查TAOTOKEN_API_KEY是否过期或写错。出现超时检查服务器出网是否正常。你可以用 curl 直接测一下 API 连通性curl -s -o /dev/null -w %{http_code}\n https://taotoken.net/api返回 200 或 401 都说明网络通返回 000 说明连不上。5.4 环境变量缺失cron 的经典坑这是最高频的问题。你在终端export的变量cron 完全看不到。解决办法有两个一是像第 3.1 节那样在 Crontab 顶部直接写变量二是在脚本开头source一个 env 文件# 脚本开头 set -a source $HOME/.openclaw/.env set a.env文件里写TAOTOKEN_API_KEYsk-xxx注意这个文件权限设成 600别让其他用户读到。5.5 日志为空重定向没写对如果cron.log一直是空的检查 Crontab 行末尾有没有 ... 21。没有重定向cron 的输出会进系统邮件你根本看不到。加上重定向后所有输出都会落到文件里。6. 长期跑定时任务Key 管理建议走 Coding Plan定时任务一旦稳定运行你会想加更多任务代码审查、依赖更新、Agent 自动提交。这时候单次调用模型的方式就不够经济了长期编码和 Agent 场景更适合走 Coding Plan统一额度、统一 Key省去每个脚本单独配 Key 的麻烦。Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite如果你用的是 Claude Code 这类工具配合 OpenClaw可以参考 Anthropic 兼容接入的配置方式Claude Code Anthropic 接入https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite最后留一个我踩过的坑Crontab 里千万别写~cron 不认这个符号一律用/home/youruser这种绝对路径。还有改完 Crontab 后crontab -l再确认一遍有时候编辑器保存失败你根本没察觉。把这两点记住OpenClaw 定时任务基本就能一次跑通了。