乐于分享
好东西不私藏

使用 OpenClaw 10天踩坑全记录:从定时任务失败到飞书推送稳定

使用 OpenClaw 10天踩坑全记录:从定时任务失败到飞书推送稳定

本文记录了过去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}
2.

在Prompt中明确要求使用工具:

⚠️ 必须调用 message 工具发送简报,不能只是文字回复!

调用 message 工具:

action: sendchannel: feishutarget: ou_873344ed10ac8da7b36349fa8ccd93d4message: 简报内容


坑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 status

2. 查看定时任务

openclaw cron list

3. 检查配置文件

openclaw config file检查 ~/.openclaw/openclaw.json

4. 重启网关

openclaw gateway restart

5. 查看日志

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