Skip to main content
OpenClaw.app は、SSH トンネルを利用してリモートホスト上のゲートウェイに接続できます。本ガイドではその設定手順を説明します。

概要図

クイックセットアップ

ステップ 1: SSH 設定の追加

~/.ssh/config を編集して以下の内容を追加します:
<リモートIP><リモートユーザー名> は自身の環境に合わせて置き換えてください。

ステップ 2: SSH 公開鍵のコピー

公開鍵をリモートマシンにコピーします(初回のみパスワード入力が必要です):

ステップ 3: ゲートウェイトークンの設定

クライアント(Mac)側でトークンを環境変数として設定します:

ステップ 4: SSH トンネルの開始

ステップ 5: OpenClaw.app の再起動

これで、アプリは SSH トンネルを通じてリモートゲートウェイへ接続されるようになります。

ログイン時のトンネル自動開始設定

Mac へのログイン時に SSH トンネルを自動で開始させるには、Launch Agent を作成します。

PLIST ファイルの作成

以下の内容を ~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist として保存してください:

Launch Agent のロード

これにより、トンネルは以下の挙動となります:
  • ログイン時に自動起動。
  • クラッシュした場合に自動再起動。
  • バックグラウンドで常時稼働。
以前の設定(com.openclaw.ssh-tunnel など)が残っている場合は、あらかじめ削除しておいてください。

トラブルシューティング

トンネルが動いているか確認する:
トンネルを再起動する:
トンネルを停止する:

仕組みの解説

OpenClaw.app は自身のマシンの ws://127.0.0.1:18789 へ接続を試みます。SSH トンネルがその通信を受け取り、実際にゲートウェイが動作しているリモートマシンの 18789 ポートへと転送します。