本文记录了过去10天使用 OpenClaw(AI自动化工具)过程中遇到的各种问题及解决方案,希望能帮助正在使用或准备使用的朋友避坑。
一、OpenClaw 是什么?
OpenClaw 是一个开源的 AI 自动化工具,可以让你配置定时任务、连接各种渠道(飞书、微信、Discord等)、调用 AI 模型完成自动化工作。
我主要用它来做:
•每天早上7点自动发送天气+新闻简报•每天10点、14点发送科技新闻•每天23点发送API使用成本报告
二、踩坑记录
坑1:定时任务执行超时
现象:设置了早安简报定时任务,到点执行但中途超时失败,或者显示成功但实际没发送内容。
排查过程:
1.查看日志发现任务执行了922秒后超时2.检查定时任务配置,发现使用的是默认超时时间3.查看执行记录,发现AI只是文字回复"任务完成",没有实际调用发送工具
根本原因:
•默认超时时间太短(只有600秒)•Prompt不够详细,AI没有正确执行发送逻辑
解决方案:
1.
增加超时时间:
{"timeoutSeconds": 1200}
在Prompt中明确要求使用工具:
⚠️ 必须调用 message 工具发送简报,不能只是文字回复!
调用 message 工具:
•action: send•channel: feishu•target: ou_873344ed10ac8da7b36349fa8ccd93d4•message: 简报内容
坑2:飞书消息发送失败
现象:定时任务显示执行成功,但飞书收不到消息。
排查过程:
1.查看执行日志,发现报错"无法确定正确的飞书目标ID"2.检查定时任务配置,发现delivery字段不完整3.对比成功的任务配置,发现缺少to字段
根本原因:delivery.to字段配置不正确,飞书插件不知道发给谁。
解决方案:
完整的delivery配置:
{"delivery": {"mode": "announce","channel": "feishu","to": "ou_873344ed10ac8da7b36349fa8ccd93d4"}}
坑3:API认证失败
现象:突然所有请求都返回401或403认证错误。
排查过程:
1.检查API Key没有过期2.查看网关日志发现Token刷新失败3.重启网关后恢复正常
解决方案:
重启OpenClaw网关:
openclaw gateway restart经验:90%的认证问题重启就能解决。
三、故障排查流程
遇到问题建议按以下顺序排查:
1. 检查网关状态
openclaw gateway status2. 查看定时任务
openclaw cron list3. 检查配置文件
openclaw config file# 检查 ~/.openclaw/openclaw.json
4. 重启网关
openclaw gateway restart5. 查看日志
openclaw logs四、定时任务配置最佳实践
经过多次调试,现在稳定的定时任务配置:
早安简报(每天7:00)
•获取成都天气•获取RSS新闻(15条)•过滤重复新闻•发送飞书消息•记录已发送内容
科技新闻(每天10:00、14:00)
•获取最新科技新闻•过滤7:00已发送的内容•发送简报•更新记录
成本报告(每天23:00)
•统计API使用情况•计算Token消耗•发送成本报告
五、关键经验总结
1. 重启大法好
遇到莫名其妙的问题,先重启网关,90%能解决。
2. 指令要明确
AI需要非常详细的步骤才会正确执行,不能指望它"理解意图"。
3. 配置要备份
~/.openclaw/openclaw.json是核心配置文件,修改前先备份。
4. Token别乱发
API Key、Token等敏感信息永远不要发在聊天里。
5. 日志要会看
出问题先看日志,大部分错误信息都很明确。
六、写在最后
折腾了10天,现在OpenClaw终于稳定运行了:
•✅ 早安简报:每天7点准时发送•✅ 科技新闻:每天10点、14点发送•✅ 成本报告:每天23点发送•✅ 飞书推送:正常接收
虽然踩了不少坑,但自动化真的香。希望这篇文章能帮助到正在使用或准备使用OpenClaw的朋友。
相关链接:
•OpenClaw官网:https://openclaw.ai[1]•GitHub仓库:https://github.com/openclaw/openclaw[2]
作者简介:程序员老登,AI工具爱好者,正在探索各种自动化工作流。
本文首发于微信公众号,转载请注明出处。
References
[1]: https://openclaw.ai[2]: https://github.com/openclaw/openclaw
夜雨聆风