跳到内容

OpenClaw 踩坑记:Gateway 配对问题与定时任务配置

记录在配置 OpenClaw Gateway 设备配对时遇到的问题,以及如何通过 openclaw devices approve 解决 cron 命令的 pairing required 错误。

作者hopes73 分钟openclaw, gateway, cron, 定时任务, devops, troubleshooting

起因

最近在玩 OpenClaw——一个可以把 AI 助手接到 Telegram、Discord 等聊天工具上的框架。整体体验挺丝滑的,但在配置定时任务的时候卡了好一阵子,这里把踩坑过程记录一下,希望能帮到后来人。

问题:pairing required

事情是这样的:我想让 bot 每天早上 9 点自动给我推送 AI 资讯日报,于是在聊天里让 bot 帮我创建一个 cron 任务。

bot 执行了 openclaw cron add 命令,结果报错:

gateway connect failed: GatewayClientRequestError: pairing required
Error: gateway closed (1008): pairing required

看起来是 CLI 和 Gateway 之间的连接没有完成配对。

第一个坑:错误的配对命令

说实话,第一反应是去查文档,然后我试了 openclaw gateway pair——看起来很合理对吧?结果并不管用。

正确的方式是通过 openclaw devices 相关命令来完成设备配对。具体操作:

# 先看一下帮助,了解有哪些子命令
openclaw devices --help

# 然后执行配对批准
openclaw devices approve

执行完 openclaw devices approve 之后,CLI 就能正常和 Gateway 通信了。

第二个坑:未配对时执行命令会导致 Gateway 断连

这个就比较疼了。在还没完成配对的时候,如果让 bot 尝试执行 openclaw cron add 之类的命令,不仅仅是命令失败那么简单——Gateway 会直接断连。

这意味着你的 bot 会掉线,需要重新连接。如果你正在通过聊天操作,这一下还挺搞心态的。

所以正确的顺序是:

  1. 先在终端完成设备配对:openclaw devices approve
  2. 然后再让 bot 创建定时任务

配对成功后:创建定时任务

配对搞定之后,创建定时任务就很顺了:

openclaw cron add \
  --name "AI日报" \
  --cron "0 9 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "搜索过去24小时内AI领域的最新资讯..." \
  --announce \
  --channel telegram \
  --to "你的chat_id"

几个关键参数说明:

  • --session isolated:独立会话运行,不会干扰主聊天
  • --announce:执行完成后把结果发送到指定频道
  • --cron + --tz:用 cron 表达式 + 时区指定执行时间
  • --channel telegram --to <id>:指定推送目标

模型选择

顺便提一句,我用的模型是 zai/glm-5-turbo(智谱 GLM-5 Turbo),整体体验还不错,响应速度快,中文理解能力强,做日常助手任务够用。

总结

问题 解决方案
pairing required 错误 运行 openclaw devices approve
openclaw gateway pair 无效 设备配对用 openclaw devices 而非 openclaw gateway
未配对执行命令导致断连 先完成配对,再执行 cron 等命令

OpenClaw 整体是个挺有意思的项目,但文档里关于设备配对的部分确实容易让人走弯路。希望这篇记录能帮你省点时间。

如果你也在折腾 OpenClaw,欢迎交流 🤝

#openclaw#gateway#cron#定时任务#devops#troubleshooting