​

openclaw devices

​

共通オプション

• --url <url>: Gateway WebSocket URL（設定時のデフォルトは gateway.remote.url）
• --token <token>: Gateway トークン（必要な場合）
• --password <password>: Gateway パスワード（パスワード認証）
• --timeout <ms>: RPC タイムアウト
• --json: JSON 出力（スクリプトでの使用を推奨）

​

コマンド

​

openclaw devices list

openclaw devices list
openclaw devices list --json

​

openclaw devices approve [requestId] [--latest]

openclaw devices approve
openclaw devices approve <requestId>
openclaw devices approve --latest

• デバイスがすでにペアリング済みで、より広いスコープまたはロールを要求した場合、OpenClaw は既存の承認を維持し、新しい保留中のアップグレード要求を作成します。承認する前に、openclaw devices list で Requested と Approved を比較するか、--latest でプレビューしてください。
• node ロールまたはその他の非オペレーターロールを承認するには、operator.admin が必要です。オペレーターデバイスの承認には operator.pairing で十分ですが、要求されたオペレータースコープが呼び出し元自身のスコープ内に収まる場合に限ります。オペレータースコープを参照してください。
• gateway.nodes.pairing.autoApproveCidrs が設定されている場合、一致するクライアント IP からの初回の role: node 要求は、この一覧に表示される前に自動承認されることがあります。デフォルトでは無効で、オペレーター／ブラウザークライアントやアップグレード要求には適用されません。
• gateway.nodes.pairing.sshVerify（デフォルトで有効）は、Gateway が SSH 経由で Node ホストのデバイス鍵を検証した場合、初回の role: node 要求を自動承認します。そのため、要求は表示された直後に承認済みになることがあります。SSH 検証を無効にするには sshVerify: false を設定してください。これは autoApproveCidrs とは独立しているため、手動のみのペアリングにするには、そちらも設定解除してください。

​

openclaw devices reject <requestId>

openclaw devices reject <requestId>

​

openclaw devices remove <deviceId>

openclaw devices remove <deviceId>
openclaw devices remove <deviceId> --json

​

openclaw devices rename --device <id> --name <label>

openclaw devices rename --device <deviceId> --name "Kitchen Mac"
openclaw devices rename --device <deviceId> --name "Kitchen Mac" --json

• --name は必須で、前後の空白が除去され、空ではなく、最大 64 文字に制限されます。
• 表示画面（CLI の一覧、Control UI のインベントリ）では、クライアントが報告した表示名よりオペレーターラベルが優先されます。
• 管理者ではないペアリング済みデバイスの呼び出し元は、自身のデバイスのみ名前を変更できます。別のデバイスの名前を変更するには operator.admin が必要です。

​

openclaw devices clear --yes [--pending]

openclaw devices clear --yes
openclaw devices clear --yes --pending
openclaw devices clear --yes --pending --json

​

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

openclaw devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write

• 対象ロールは、そのデバイスの承認済みペアリング契約にすでに存在している必要があります。ローテーションによって新しい未承認ロールを発行することはできません。
• --scope を省略すると、それ以降の再接続では保存済みトークンにキャッシュされた承認済みスコープが再利用されます。明示的な --scope 値を渡すと、以降のキャッシュ済みトークンによる再接続で使用される保存済みスコープセットが置き換えられます。
• 管理者ではないペアリング済みデバイスの呼び出し元は、自身のデバイストークンのみローテーションでき、対象スコープセットは呼び出し元自身のオペレータースコープ内に収まる必要があります。ローテーションによって、呼び出し元がすでに持つものより広いトークンを発行または維持することはできません。

​

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

openclaw devices revoke --device <deviceId> --role node

​

注意事項

• これらのコマンドには、operator.pairing（または operator.admin）スコープが必要です。オペレーター以外のデバイスロールには常に operator.admin が必要です。オペレータースコープを参照してください。
• トークンのローテーションと失効は、デバイスの承認済みペアリングロールセットおよびスコープの基準内に限定されます。孤立したキャッシュ済みトークンエントリによって、トークン管理の対象権限が付与されることはありません。
• ペアリング済みデバイストークンのセッションでは、デバイスをまたぐ管理（remove、rename、rotate、revoke）は、呼び出し元が operator.admin を持たない限り、自身のデバイスのみに制限されます。
• トークンのローテーションでは新しいトークン（機密情報）が返されます。シークレットとして扱ってください。
• local loopback でペアリングスコープが利用できず、明示的な --url が渡されていない場合、list/approve はローカルのペアリング状態にフォールバックできます。

​

トークンの不整合からの復旧チェックリスト

1. 現在の Gateway トークンの取得元を確認します。
   openclaw config get gateway.auth.token
   
2. ペアリング済みデバイスを一覧表示し、影響を受けるデバイス ID を特定します。
   openclaw devices list
   
3. 影響を受けるデバイスのオペレータートークンをローテーションします。
   openclaw devices rotate --device <deviceId> --role operator
   
4. ローテーションで解決しない場合は、古いペアリングを削除して再度承認します。
   openclaw devices remove <deviceId>
   openclaw devices list
   openclaw devices approve <requestId>
   
5. 現在の共有トークン／パスワードを使用して、クライアント接続を再試行します。

• 通常の再接続時の認証優先順位は、明示的な共有トークン／パスワード、明示的な deviceToken、保存済みデバイストークン、ブートストラップトークンの順です。
• 信頼済みの AUTH_TOKEN_MISMATCH 復旧では、1 回に限定された再試行のため、共有トークンと保存済みデバイストークンの両方を一時的に送信できます。
• AUTH_SCOPE_MISMATCH は、デバイストークンは認識されたものの、要求されたスコープセットを保持していないことを意味します。共有 Gateway 認証を変更する前に、ペアリング／スコープ承認の契約を修正してください。

• ダッシュボード認証のトラブルシューティング
• Gateway のトラブルシューティング

​

Paperclip / openclaw_gateway の初回実行時の承認

openclaw devices approve --latest

openclaw devices approve --latest --url <gateway-ws-url> --token <gateway-token>

{
  "adapterConfig": {
    "devicePrivateKeyPem": "<ed25519-private-key-pkcs8-pem>"
  }
}

​

関連項目

• CLI リファレンス
• Node