openclaw devices

管理设备 Pairing 请求和设备范围的 Token。

命令

openclaw devices list

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

openclaw devices list
openclaw devices list --json

openclaw devices approve <requestId>

批准待处理的设备 Pairing 请求。

openclaw devices approve <requestId>

openclaw devices reject <requestId>

拒绝待处理的设备 Pairing 请求。

openclaw devices reject <requestId>

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

为指定角色轮换设备 Token（可选择更新权限范围）。

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 地址（配置后默认使用 gateway.remote.url）。
• --token <token>：Gateway Token（如果需要）。
• --password <password>：Gateway 密码（密码认证方式）。
• --timeout <ms>：RPC 超时时间。
• --json：JSON 格式输出（推荐用于脚本）。

注意事项

• Token 轮换会返回新的 Token（敏感信息），请像对待密钥一样妥善保管。
• 这些命令需要 operator.pairing（或 operator.admin）权限范围。