Remote access

リモート Gateway のセットアップ

リモート Gateway で OpenClaw.app を実行する

OpenClaw.app は SSH トンネル経由でリモート Gateway に接続します。SSH の LocalForward により、ローカルポートがリモートホスト上の Gateway WebSocket ポートにマッピングされます。

flowchart TB
    subgraph Client["クライアントマシン"]
        direction TB
        A["OpenClaw.app"]
        B["ws://127.0.0.1:18789\n(ローカルポート)"]
        T["SSH トンネル"]

        A --> B
        B --> T
    end
    subgraph Remote["リモートマシン"]
        direction TB
        C["Gateway WebSocket"]
        D["ws://127.0.0.1:18789"]

        C --> D
    end
    T --> C

セットアップ

  1. LocalForward 18789 127.0.0.1:18789 を指定した SSH 設定エントリを追加します(設定ブロック全体については、リモートアクセスを参照してください)。
  2. ssh-copy-id を使用して、SSH 鍵をリモートホストにコピーします。
  3. openclaw config set gateway.remote.token "<your-token>" を使用して、gateway.remote.token(または gateway.remote.password)を設定します。
  4. トンネルを開始します:ssh -N remote-gateway &
  5. OpenClaw.app を終了し、再度開きます。

再起動後も維持され、自動的に再接続するトンネルを使用するには、手動の ssh -N の代わりに、リモートアクセスページにある LaunchAgent のセットアップを使用してください。

仕組み

コンポーネント 動作
LocalForward 18789 127.0.0.1:18789 ローカルポート 18789 をリモートポート 18789 に転送する
ssh -N リモートコマンドを実行せずに SSH を使用する(ポート転送のみ)
KeepAlive トンネルがクラッシュした場合に自動的に再起動する(LaunchAgent)
RunAtLoad LaunchAgent の読み込み時にトンネルを開始する(LaunchAgent)

OpenClaw.app はクライアント上の ws://127.0.0.1:18789 に接続します。トンネルは、その接続を Gateway が実行されているリモートホストのポート 18789 に転送します。

関連項目

Was this useful?
On this page

On this page