Skip to main content

openclaw devices

管理设备配对请求和设备范围的 token。

命令​

openclaw devices list​

列出待处理的配对请求和已配对的设备。

openclaw devices list
openclaw devices list --json

openclaw devices approve <requestId>​

批准待处理的设备配对请求。

openclaw devices approve <requestId>

openclaw devices reject <requestId>​

拒绝待处理的设备配对请求。

openclaw devices reject <requestId>

openclaw devices rotate --device <id> --role <role> [--scope <scope...>]​

为特定角色轮换设备 token（可选更新 scope）。

openclaw devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write

openclaw devices revoke --device <id> --role <role>​

为特定角色撤销设备 token。

openclaw devices revoke --device <deviceId> --role node

通用选项​

  • --url <url>：Gateway 网关 WebSocket URL（配置后默认使用 gateway.remote.url）。
  • --token <token>：Gateway 网关 token（如需要）。
  • --password <password>：Gateway 网关密码（密码认证）。
  • --timeout <ms>：RPC 超时。
  • --json：JSON 输出（推荐用于脚本）。

注意事项​

  • Token 轮换会返回新 token（敏感信息）。请像对待密钥一样对待它。
  • 这些命令需要 operator.pairing（或 operator.admin）scope。