配置 OpenClaw 的配对(Pairing)方法
Token 不匹配:确保节点运行时提供的 --token 与网关配置文件 ~/.openclaw/openclaw.json 中的 gateway.auth.token 完全一致。配置 OpenClaw 的配对(Pairing)主要分为两种情况:子节点(Node)配对和消息渠道(如 Telegram)配对。在网关端审批:在运行 OpenClaw 的终端里,输入上面的命令,将 <PAIRING_CO
配置 OpenClaw 的配对(Pairing)主要分为两种情况:子节点(Node)配对和消息渠道(如 Telegram)配对。两者的流程不同,下面分别说明:
1️⃣ 子节点(Node)配对流程
这是将你的笔记本、树莓派或其他服务器作为执行节点连接到网关的方式。
核心命令:
在网关端查看待批准节点:
bash
openclaw nodes pending
批准节点:
bash
openclaw nodes approve
(将 替换为实际ID)
操作流程:
节点发起连接:在子节点上运行 openclaw node run --host <网关IP> --port <端口> --token <令牌>。首次连接时,节点会自动生成密钥对并向网关发送配对请求。
网关审批:在网关机器上执行 openclaw nodes pending 查看待审批列表,记录显示的 request-id。
完成配对:执行 openclaw nodes approve 。批准后,节点即可自动重连并长期在线,无需再次配对 。
2️⃣ 消息渠道(如 Telegram)配对流程
这是让你的 Telegram 等聊天软件中的机器人能够与 OpenClaw 网关通信的方式。
核心命令:
bash
openclaw pairing approve telegram <PAIRING_CODE>
(将 <PAIRING_CODE> 替换为机器人发给你的验证码)
操作流程:
获取配对码:向你的 Telegram 机器人发送任意一条消息。机器人会自动回复一串数字/字母组合的配对码 。
在网关端审批:在运行 OpenClaw 的终端里,输入上面的命令,将 <PAIRING_CODE> 替换为机器人发给你的验证码。
验证成功:看到成功提示后,你的 Telegram 机器人就与网关配对成功了,之后可以直接对话 。
3️⃣ 移动设备(如 Android/iOS)配对
移动端 App 的连接方式与子节点类似。
核心命令:
bash
openclaw devices list # 查看待处理请求
openclaw devices approve # 批准请求
操作流程:
在手机上打开 OpenClaw App,输入网关地址和令牌。
在网关机器上运行 openclaw devices list,找到手机的请求 ID。
运行 openclaw devices approve 完成配对。
⚠️ 常见问题排查
nodes pending 看不到请求:可能是节点连接时的 setTimeout 未触发。建议将 OpenClaw 升级到最新版,或参考早期 issue #9174 手动打补丁 。
Headless 服务器(如 EC2)节点离线:对于没有图形界面的服务器,需要启用 systemd user lingering,以确保用户服务在无登录会话时持续运行:
bash
sudo loginctl enable-linger $USER
Token 不匹配:确保节点运行时提供的 --token 与网关配置文件 ~/.openclaw/openclaw.json 中的 gateway.auth.token 完全一致 。
更多推荐

所有评论(0)