openclaw devices

查看和管理与 OpenClaw 实例配对的设备，包括设备列表、配对状态和设备撤销。

命令签名

openclaw devices <子命令> [选项]

子命令

子命令	说明
list	列出所有已连接设备（默认）
remove	移除指定设备
revoke	撤销设备的访问权限

openclaw devices list

列出所有已配对和已连接的设备。

openclaw devices list [选项]

选项	类型	说明
--status <status>	string	按状态过滤：paired、active、revoked
--json	boolean	JSON 格式输出

输出示例：

DEVICE ID       NAME              STATUS    PAIRED AT           LAST SEEN
dev_a1b2c3      iPhone 15         active    2024-01-10 14:30    2m ago
dev_d4e5f6      MacBook Pro       active    2024-01-08 09:15    just now
dev_g7h8i9      Android Phone     paired    2024-01-12 16:45    3d ago

openclaw devices remove

移除一个已配对的设备。

openclaw devices remove <device-id> [--force]

选项	类型	说明
--force	boolean	跳过确认提示

openclaw devices revoke

撤销设备的访问权限，但保留配对记录。

openclaw devices revoke <device-id>

示例

# 列出所有设备
openclaw devices list

# 仅显示活跃设备
openclaw devices list --status active

# JSON 格式输出
openclaw devices list --json

# 移除设备
openclaw devices remove dev_g7h8i9

# 强制移除（不确认）
openclaw devices remove dev_g7h8i9 --force

# 撤销设备权限
openclaw devices revoke dev_a1b2c3

WARNING

移除设备后，该设备需要重新配对才能再次连接。撤销操作则仅暂停访问权限，保留配对信息。

另请参阅

• openclaw channels — 渠道管理
• openclaw config — 配置管理
• openclaw health — 健康检查