devices

这个工具就像一个遥控器，专门用来管理想和你电脑（或者服务器）连接的其他设备。这些设备就像想进门的小朋友，需要你的同意。你可以用这个工具看看谁在排队，谁已经是朋友了，还可以给它们发“通行证”或者收回“通行证”。

首先，你需要打开一个叫“终端”或“命令行”的窗口，就像打开一个对讲机，然后才能输入下面的命令。

1. 看看有哪些设备朋友 这个命令是让你看看，有哪些设备在等着和你做朋友，以及哪些已经是朋友了。

   • 要做什么：输入 openclaw devices list。
   • 怎么做：直接输入这行字，然后按回车。如果你想看到更整齐、电脑能看懂的结果，可以加上 --json。

2. 让一个设备朋友离开 如果你不想和某个设备做朋友了，可以用这个命令请它离开。

   • 要做什么：输入 openclaw devices remove，后面还要加上那个设备的“名字”（就是 <deviceId>）。
   • 怎么做：比如，你想让一个叫 abc123 的设备离开，就输入 openclaw devices remove abc123。同样，加 --json 可以让结果更整齐。

3. 请走很多设备朋友 如果你想一次请走很多设备朋友，可以用这个命令。它有个安全锁，就是 --yes，你必须加上它，命令才会真的执行，这是为了防止你不小心按错了。

   • 要做什么：输入 openclaw devices clear --yes。
   • 怎么做：直接输入这行字，就会请走所有已经是朋友的设备。如果你只想请走那些还在排队等着的设备，就再加上 --pending。

4. 同意一个设备和你做朋友 当有设备想和你做朋友时，你需要同意才行。

   • 要做什么：输入 openclaw devices approve。
   • 怎么做：最简单的方法是直接输入这个命令，它会自动同意最近一个在排队的请求。你也可以指定同意某个具体的请求，在后面加上它的“号码”（就是 <requestId>）。或者用 --latest，意思也是同意最新的一个。

5. 拒绝一个设备和你做朋友 如果你不想同意某个设备的请求，可以拒绝它。

   • 要做什么：输入 openclaw devices reject，后面必须加上你想拒绝的那个请求的“号码”（就是 <requestId>）。
   • 怎么做：比如，你想拒绝号码是 req789 的请求，就输入 openclaw devices reject req789。

6. 给设备朋友换一个新的“通行证” 已经是你朋友的设备，会有一个“通行证”（叫token）。有时候你需要给它换一个新的，或者改变它能做的事情（这叫scope，就是“活动范围”）。

   • 要做什么：输入 openclaw devices rotate。
   • 怎么做：你必须告诉它给哪个设备换（用 --device <设备名>），以及换什么类型的通行证（用 --role <角色名>，比如 operator）。你还可以改变它的“活动范围”，用 --scope，后面写上它能做的新事情，比如 operator.read（可以读）。

7. 收回一个设备朋友的“通行证” 如果你不想让某个设备再用某个“通行证”了，可以把它收回来。

   • 要做什么：输入 openclaw devices revoke。
   • 怎么做：你必须告诉它收回哪个设备的（用 --device <设备名>），以及收回哪种类型的通行证（用 --role <角色名>，比如 node）。

一些重要的提醒和小秘密：

• 怎么告诉工具去哪里找你的电脑？ 你可以用 --url 后面加一个地址，就像告诉它门牌号。如果你不告诉它，它会试着去你之前可能设置过的地方找。
• 怎么证明你是主人？ 有时候需要密码或钥匙。你可以用 --token 后面加一串秘密字符，或者用 --password 后面加你的密码。
• 要小心哦！ 用 rotate 命令换出来的新“通行证”是个大秘密，不能给别人看，要像藏糖果一样藏好！
• 你需要有权限：想使用这些命令，你自己必须先有一个能管理朋友的“通行证”，这个通行证需要有 operator.pairing 或者 operator.admin 这样的能力。
• 安全锁：devices clear 命令必须加上 --yes 这个安全锁才会工作，这是为了防止你一不小心把朋友们都赶走了。
• 一个小窍门：如果你就在自己的电脑上操作（这叫本地回环），有时候即使没有 --url 指定的地址，list 和 approve 命令也能找到一个特别的方法来工作。