OpenClawモバイルノードペアリング：iOSとAndroid接続ガイド

はじめに

OpenClaw はTelegram、WhatsAppなどのサードパーティプラットフォームを通じたAIインタラクションだけでなく、ネイティブのモバイル端末ペアリング機能も提供しています。iOSまたはAndroidデバイスをOpenClawサーバーとペアリングすることで、サードパーティアプリに依存せずにスマートフォンから直接AIアシスタントを利用できます。本記事では、モバイルノードのペアリングフローと一般的な設定を詳しく解説します。

モバイルノードの概要

OpenClaw のモバイルノード（Mobile Node）は軽量なクライアント接続方式です。スマートフォンはセキュアなWebSocket接続でOpenClawゲートウェイに接続し、他のチャンネルとまったく同じAIインタラクション能力を獲得すると同時に、ネイティブプッシュ通知やオフラインメッセージ同期を利用できます。

コアメリット

サードパーティアプリ不要：OpenClawモバイル版またはPWAで直接使用
エンドツーエンド暗号化：ペアリング過程で確立された鍵が通信の安全性を保護
オフライン同期：デバイスがオフラインの間のメッセージは再接続時に自動同期
マルチデバイスサポート：1人のユーザーが複数のデバイスをペアリング可能、セッションは自動同期
プッシュ通知：APNs（iOS）とFCM（Android）のプッシュをサポート

前提条件

ペアリングを始める前に、以下の条件を確認してください。

OpenClawサーバーが起動・稼働中で、バージョン >= 1.2.0
ゲートウェイが外部接続を許可するか、ポートフォワーディングが設定済み
スマートフォンとサーバーが同一ネットワーク上にあるか、サーバーが公開ネットワークからアクセス可能
サーバー側でモバイルノード機能が有効化済み

モバイルノードの有効化

openclaw.json で以下の設定を確認してください。

{
  "gateway": {
    "host": "0.0.0.0",
    "port": 18789
  },
  "channels": {
    "mobile": {
      "enabled": true,
      "maxDevices": 5,
      "pairingTimeout": 300,
      "pushNotifications": {
        "enabled": true,
        "apns": {
          "keyFile": "~/.openclaw/certs/apns-key.p8",
          "keyId": "YOUR_KEY_ID",
          "teamId": "YOUR_TEAM_ID"
        },
        "fcm": {
          "credentialsFile": "~/.openclaw/certs/fcm-credentials.json"
        }
      }
    }
  }
}

プッシュ通知の設定は任意です。プッシュを設定しなくてもモバイル端末は正常に動作しますが、アプリがバックグラウンドにある時に通知を受け取れません。

ペアリングフロー

ステップ1：ペアリングコードの生成

サーバー側で一時的なペアリングコードを生成します。

# ペアリングコードを生成、有効期限5分
openclaw mobile pair --generate

# 出力例：
# ペアリングコード: AXKF-9M2P-RTLQ
# 有効期限: 2026-03-14 15:05:00
# ペアリングリンク: https://your-server:18789/pair/AXKF-9M2P-RTLQ

Web Dashboardの「デバイス管理」ページで「ペアリングコード生成」ボタンをクリックすることもできます。

ステップ2：スマートフォンでペアリングコードを入力

iOSペアリング

App Storeで「OpenClaw」を検索してインストール（またはSafariでDashboardのPWA版を開く）
アプリを開き、「サーバーに接続」をタップ
サーバーアドレスを入力：your-server-ip:18789
ペアリングコードを入力：AXKF-9M2P-RTLQ
検証の完了を待つ

Androidペアリング

Google Playで「OpenClaw」を検索してインストール
アプリを開き、「サーバーを追加」をタップ
手動でアドレスとペアリングコードを入力するか、Dashboardに表示されるQRコードをスキャン
接続を確認

ステップ3：ペアリングの検証

ペアリング成功後、サーバー側に確認情報が表示されます。

[INFO] 新しいデバイスがペアリングされました: iPhone 15 Pro (iOS 19.0)
[INFO] デバイスID: mob_a3f2c1d8
[INFO] ユーザー識別子: mobile_user_001

スマートフォン側では、接続状態インジケーターが緑色に変わり、メッセージの送信を開始できるはずです。

QRコードによるクイックペアリング

手動でペアリングコードを入力する以外に、OpenClaw はより便利なQRコードペアリングもサポートしています。

# ターミナルでQRコードを生成（ターミナルがUnicodeをサポートしている必要があります）
openclaw mobile pair --qrcode

# Dashboardで生成
# Dashboard → デバイス管理 → QRコード生成

QRコードにはサーバーアドレス、ポート、ペアリングコードが符号化されており、スマートフォンでスキャンすると1ステップで接続が完了します。

デバイス管理

ペアリング済みデバイスの確認

openclaw mobile list

# 出力例：
# ID            デバイス名          プラットフォーム  最終アクティブ
# mob_a3f2c1d8  iPhone 15 Pro     iOS 19          2分前
# mob_b7e9f4a2  Pixel 9           Android         1時間前

デバイスの削除

# 指定デバイスの削除
openclaw mobile remove mob_a3f2c1d8

# すべてのデバイスの削除
openclaw mobile remove --all

デバイスを削除すると、そのデバイス上のOpenClawアプリは自動的に切断され、再度ペアリングしないと使用できなくなります。

モバイル端末専用の設定

モバイルチャンネルに対して独立した動作パラメータを設定できます。

{
  "channels": {
    "mobile": {
      "enabled": true,
      "sessionIsolation": true,
      "persona": {
        "systemPrompt": "あなたはユーザーのパーソナルAIアシスタントです。スマートフォンでの閲覧に適した簡潔な返信を心がけてください。",
        "tone": "casual"
      },
      "mediaSupport": {
        "image": true,
        "audio": true,
        "document": false
      },
      "offlineSync": {
        "enabled": true,
        "maxPendingMessages": 100,
        "syncOnConnect": true
      }
    }
  }
}

パラメータ説明

パラメータ	説明
`sessionIsolation`	モバイル端末のセッションを他のチャンネルから分離するか
`persona`	モバイル端末専用のAIペルソナ
`offlineSync`	オフラインメッセージ同期の設定
`maxPendingMessages`	最大待機同期メッセージ数

ネットワークとセキュリティの設定

LANペアリング

スマートフォンとサーバーが同じLAN上にある場合は、内部IPで直接接続できます。

サーバーアドレス: 192.168.1.100:18789

インターネット経由のペアリング

インターネット経由で接続する場合は、HTTPSの有効化を強く推奨します。

{
  "security": {
    "tls": {
      "enabled": true,
      "cert": "/path/to/cert.pem",
      "key": "/path/to/key.pem"
    }
  }
}

または、リバースプロキシ（Nginx、Caddyなど）でフロントエンドのTLS終端を提供します。

ペアリングのセキュリティメカニズム

OpenClaw のペアリングプロセスには多層のセキュリティ保護が組み込まれています。

ペアリングコードの有効期限はデフォルトで5分、期限切れで自動失効
各ペアリングコードは1回のみ使用可能
ペアリング成功後、デバイスとサーバー間にTLSベースの長期接続を確立
サーバー側からいつでもデバイスのアクセス権限を取り消し可能

よくある質問のトラブルシューティング

Q: ペアリングコードは正しいが接続に失敗する？

ファイアウォールが18789ポートを通過させているか確認し、host が "127.0.0.1" ではなく "0.0.0.0" に設定されていることを確認してください。

Q: プッシュ通知が動かない？

APNsまたはFCMの証明書設定が正しいことを確認してください。iOSには有効なAPNs Keyファイルが必要で、AndroidにはFirebaseプロジェクトのService Account認証情報が必要です。

Q: マルチデバイス間でメッセージが同期されない？

すべてのデバイスが同じAgentに接続されており、sessionIsolation が分離モードに設定されていないことを確認してください。

まとめ

OpenClaw のモバイルノードペアリング機能により、サードパーティプラットフォームへの依存から解放され、スマートフォンから直接AIアシスタントを利用できます。ペアリングプロセスはシンプルかつ安全で——ペアリングコードの生成、スキャンまたは入力、接続の確認——3ステップで完了します。プッシュ通知とオフライン同期を組み合わせることで、モバイル端末の体験はネイティブアプリと遜色ないものになります。