Pairing
「ペアリング」は、OpenClaw における明示的な オーナー承認 の手順です。 次の 2 つの場面で使用されます。 以下の2箇所で使用されます。- DM ペアリング（どの送信者がボットと会話できるか）
- ノード ペアリング（どのデバイス／ノードが ゲートウェイ ネットワークに参加できるか）
1. DM ペアリング（受信チャットのアクセス）
チャンネルが DM ポリシーpairing で設定されている場合、未承認の送信者には短いコードが発行され、承認するまでメッセージは 処理されません。
既定の DM ポリシーは次に記載されています： Security
ペアリングコード：
- 8 文字、英大文字、紛らわしい文字は含みません（
0O1I）。 - 1時間後に有効期限が切れます 1 時間後に失効 します。ボットは、新しいリクエストが作成されたときにのみペアリングメッセージを送信します（送信者あたり概ね 1 時間に 1 回）。
- 保留中の DM ペアリングリクエストは、既定で チャンネルあたり 3 件 に制限されます。いずれかが失効または承認されるまで、追加のリクエストは無視されます。
送信者を承認する
telegram、whatsapp、signal、imessage、discord、slack。
国家の居住地
~/.openclaw/credentials/ の配下に保存されます：
- 保留中のリクエスト：
<channel>-pairing.json - 承認済みの許可リスト ストア：
<channel>-allowFrom.json
2. ノード デバイスのペアリング（iOS／Android／macOS／ヘッドレス ノード）
ノードは、role: node を用いた デバイス として Gateway（ゲートウェイ）に接続します。Gateway（ゲートウェイ）は、承認が必要なデバイス ペアリング リクエストを作成します。 ゲートウェイ
は、承認が必要なデバイスペアリングリクエストを作成します。 ゲートウェイ
は、承認が必要なデバイスペアリングリクエストを作成します。
Telegram 経由でペアリング（iOS では推奨）
device-pair プラグインを使用している場合、初回のデバイスペアリングを Telegram だけで完結できます。
- Telegram でボットにメッセージを送信します:
/pair - ボットは 2 つのメッセージで返信します。1 つは手順の説明、もう 1 つは別送の セットアップコード メッセージ（Telegram で簡単にコピー／ペーストできます）。
- スマートフォンで OpenClaw iOS アプリを開き → 設定 → Gateway を選択します。
- セットアップコードを貼り付けて接続します。
- Telegram に戻って:
/pair approve
url: Gateway の WebSocket URL（ws://...またはwss://...）token: 短期間有効なペアリングトークン
ノード デバイスを承認する
ノード ペアリングの状態保存
~/.openclaw/devices/ の配下に保存されます：
pending.json（短期間のみ有効；保留中のリクエストは失効します）paired.json（ペアリング済みデバイス＋トークン）
注記
- レガシーの
node.pair.*API（CLI：openclaw nodes pending/approve）は、ゲートウェイ所有の別個のペアリング ストアです。WS ノードでは、引き続きデバイス ペアリングが必要です。 WSノードでは、デバイスのペアリングが必要です。 WSノードでは、デバイスのペアリングが必要です。