> ## Documentation Index
> Fetch the complete documentation index at: https://cryptoclawdocs.termix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# devices

# `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。