ペアリング

1. DM ペアリング (ボットとの会話を許可されるユーザー)
2. ノードのペアリング (ゲートウェイ ネットワークへの参加を許可されるデバイス/ノード)

​

1) DM ペアリング (インバウンド チャット アクセス)

• 8 文字、大文字、あいまいな文字は含まれません (0O1I)。
• 1 時間後に期限切れになります。ボットは、新しいリクエストが作成されたときにのみペアリング メッセージを送信します (送信者ごとに 1 時間に 1 回程度)。
• 保留中の DM ペアリング要求は、デフォルトで チャネルごとに 3 に制限されます。追加のリクエストは、期限が切れるか承認されるまで無視されます。

​

送信者を承認する

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

​

ステータスの保存場所

• 保留中のリクエスト: <channel>-pairing.json
• 承認された許可リスト ストア:
  • デフォルトのアカウント: <channel>-allowFrom.json
  • デフォルト以外のアカウント: <channel>-<accountId>-allowFrom.json

• デフォルト以外のアカウントは、スコープ指定された許可リスト ファイルのみを読み取り/書き込みします。
• デフォルト アカウントは、チャネル スコープの（スコープ指定されていない）許可リスト ファイルを使用します。

​

2) ノードデバイスのペアリング (iOS/Android/macOS/ヘッドレスノード)

​

Telegram 経由でペアリング (iOS の場合推奨)

1. Telegram で、ボットにメッセージを送信します: /pair
2. ボットは 2 つのメッセージで応答します。1 つは指示メッセージ、もう 1 つは個別の セットアップ コード メッセージ (Telegram で簡単にコピー/ペーストできます) です。
3. スマートフォンで、OpenClaw iOS アプリを開き、[Settings] → [Gateway] を選択します。
4. セットアップコードを貼り付けて接続します。
5. Telegram に戻り、/pair approve を送信します。

• url: ゲートウェイの WebSocket URL (ws://... または wss://...)
• token: 有効期間の短いペアリング トークン

​

ノードデバイスを承認する

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

​

ノードペアリング状態のストレージ

• pending.json (短命なリクエスト。保留中のリクエストは期限切れになります)
• paired.json (ペアリング済みデバイス + トークン)

​

注記

• 従来の node.pair.* API (CLI: openclaw nodes pending/approve) は、ゲートウェイが所有する別のペアリング ストアです。WS ノードでは引き続きデバイスのペアリングが必要です。

​

関連ドキュメント

• セキュリティ モデル + プロンプト インジェクション: セキュリティ
• 安全に更新 (openclaw doctor を実行): 更新
• チャネル構成:
  • Telegram: Telegram
  • WhatsApp: WhatsApp
  • Signal: Signal
  • BlueBubbles (iMessage): BlueBubbles
  • iMessage (レガシー): iMessage
  • Discord: Discord
  • Slack: Slack