Skip to main content

​
openclaw devices

管理设备配对请求和设备范围令牌。

​
命令

​
openclaw devices list

列出待处理的配对请求和已配对设备。 
openclaw devices list
openclaw devices list --json

​
openclaw devices remove <deviceId>

移除一个已配对的设备条目。 
openclaw devices remove <deviceId>
openclaw devices remove <deviceId> --json

​
openclaw devices clear --yes [--pending]

批量清除已配对的设备。 
openclaw devices clear --yes
openclaw devices clear --yes --pending
openclaw devices clear --yes --pending --json

​
openclaw devices approve [requestId] [--latest]

批准一个待处理的设备配对请求。如果省略 requestId，OpenClaw 会自动批准最新的待处理请求。 
openclaw devices approve
openclaw devices approve <requestId>
openclaw devices approve --latest

​
openclaw devices reject <requestId>

拒绝一个待处理的设备配对请求。 
openclaw devices reject <requestId>

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

为特定角色轮换设备令牌（可选更新作用域）。 
openclaw devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write

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

撤销特定角色的设备令牌。 
openclaw devices revoke --device <deviceId> --role node

​
通用选项

  • --url <url>：网关 WebSocket URL（配置时默认为 gateway.remote.url）。
  • --token <token>：网关令牌（如果需要）。
  • --password <password>：网关密码（密码认证）。
  • --timeout <ms>：RPC 超时时间。
  • --json：JSON 格式输出（推荐用于脚本处理）。
注意：当您设置了 --url 后，CLI 不会回退使用配置或环境中的凭据，需显式传入 --token 或 --password。缺少显式凭据会报错。

​
备注

  • 令牌轮换会返回一个新的令牌（敏感信息），请妥善保管。
  • 这些命令需要 operator.pairing（或 operator.admin）权限作用域。
  • devices clear 命令必须使用 --yes 参数以防误操作。
  • 若本地回环接口无配对作用域（且未显式传入 --url），list 和 approve 命令可以使用本地配对回退机制。