openclaw devices
管理设备配对请求和设备作用域令牌。
命令
openclaw devices list
列出待处理的配对请求和已配对的设备。
openclaw devices remove <deviceId>
移除一个已配对的设备条目。
openclaw devices clear --yes [--pending]
批量清除已配对的设备。
openclaw devices approve [requestId] [--latest]
批准待处理的设备配对请求。如果省略了 requestId，OpenClaw 将自动批准最近的待处理请求。
注意：如果设备使用更改的身份验证详细信息（角色/作用域/公钥）重试配对，OpenClaw 将取代先前的待处理条目并颁发一个新的 requestId。请在批准之前运行 openclaw devices list 以使用当前 ID。
openclaw devices reject <requestId>
拒绝待处理的设备配对请求。
openclaw devices rotate --device <id> --role <role> [--scope <scope...>]
轮换特定角色的设备令牌（可选择更新作用域）。
openclaw devices revoke --device <id> --role <role>
撤销特定角色的设备令牌。
常用选项
--url <url>：Gateway(网关) WebSocket URL（配置时默认为gateway.remote.url）。--token <token>：Gateway(网关) 令牌（如果需要）。--password <password>：Gateway(网关) 密码（密码身份验证）。--timeout <ms>：RPC 超时。--json：JSON 输出（建议用于脚本编写）。
--url 时，CLI 不会回退到配置或环境凭据。显式传递 --token 或 --password。缺少显式凭据将报错。
注意
- 令牌轮换返回一个新令牌（敏感）。请将其视为机密。
- 这些命令需要
operator.pairing（或operator.admin）作用域。 devices clear受--yes的有意限制。- 如果在 local loopback 上无法使用配对作用域（且未传递显式
--url），列表/批准可以使用本地配对回退。
令牌漂移恢复检查清单
当控制 UI 或其他客户端持续因AUTH_TOKEN_MISMATCH 或 AUTH_DEVICE_TOKEN_MISMATCH 失败时，请使用此方法。
- 确认当前的网关令牌来源：
- 列出已配对的设备并识别受影响的设备 ID：
- 轮换受影响设备的操作员令牌：
- 如果轮换不够，请移除过时的配对并再次批准：
- 使用当前的共享令牌/密码重试客户端连接。
本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。