ali-instance-cli のポートフォワーディングまたはセッション接続を介して、ECS インスタンス上の OpenClaw にアクセスします。パブリック IP や開いているポートは必要ありません。
背景情報
ECS インスタンス上の OpenClaw の Web UI または TUI にアクセスするには、通常、パブリック IP と、セキュリティグループで開いているサービスポート (例:18789) が必要です。ali-instance-cli は、Alibaba Cloud 内部ネットワークを介して、暗号化された Session Manager チャネル経由ですべてのトラフィックをルーティングするため、ポートを公開する必要がありません。
2 つの接続方法が利用できます:
|
接続方法 |
説明 |
シナリオ |
|
OpenClaw ダッシュボードのポートをローカルマシンに転送し、ブラウザでアクセスします。 |
グラフィカルインターフェースを使用した日常的な利用。 |
|
|
Session Manager を介してインスタンスのターミナルに接続し、コマンドラインで TUI にアクセスします。 |
コマンドライン操作または直接的なターミナル操作。 |
前提条件
-
以下の準備が完了していること:
-
Session Manager が有効化されていること。
-
クラウドアシスタントエージェントがインスタンスにインストールされ、実行中であること。
-
-
ローカルマシンにSession Manager CLI がインストールされ、設定されていること。
-
OpenClaw が ECS インスタンスにデプロイされ、OpenClaw ゲートウェイが実行中であること。
Session Manager が有効になっていない場合、ali-instance-cli コマンドは session manager is disabled というエラーが返されます。
パブリック IP なしでの Web UI へのアクセス
ポートフォワーディングを介して OpenClaw ダッシュボードのポートをローカルマシンにマッピングし、ブラウザで Web UI にアクセスします。
ステップ 1:ゲートウェイのステータス確認
インスタンス上で、OpenClaw ゲートウェイのステータスを確認します:
openclaw gateway status
出力例:
Gateway: bind=lan (0.0.0.0), port=18789 (env/config)
...
RPC probe: ok
Listening: *:18789
RPC probe が ok を示し、Listening がポート番号を示している場合、ゲートウェイは正常に実行されています。
ステップ 2:ダッシュボード URL の取得
インスタンス上で、OpenClaw ダッシュボードの URL を取得します:
openclaw dashboard
出力例:
Dashboard URL: http://127.0.0.1:18789/#token=<TOKEN>
後の手順のために、ポート番号 (デフォルト:18789) とトークンの値をメモしておきます。
ステップ 3:ポートフォワーディングの実行
ローカルマシンで、インスタンスの OpenClaw ポートを転送します。コマンドは Linux、macOS、Windows で共通です。
./ali-instance-cli portforward --instance <INSTANCE_ID> --local-port 18789 --remote-port 18789
パラメーター:
-
--instance:ECS インスタンス ID。例:i-bp1xxxxxxxxxxxxx。 -
--local-port:ローカルのリッスンポート。リモートポートと異なっていても問題ありません。例:18789。 -
--remote-port:インスタンス上の OpenClaw サービスポート。デフォルト:18789。
出力例:
Port forwarding for SessionId: s-hz0xxxxx, local port 18789, remote port :18789
Waiting for connections...
ターミナルは開いたままにしてください。閉じるとセッションが切断されます。
ステップ 4:ダッシュボードへのアクセス
ブラウザで次の URL を開きます:
http://localhost:18789/#token=<TOKEN>
<TOKEN> をステップ 2 で取得したトークンに置き換えます。--local-port で異なるポートを使用している場合は、それに応じて URL を更新してください。
パブリック IP なしでの TUI へのログイン
Session Manager を介して ECS インスタンスのターミナルにログインし、OpenClaw TUI を起動します。
ステップ 1:バージョン要件の確認
ローカルの ali-instance-cli が最小バージョン要件を満たしていることを確認します:
|
オペレーティングシステム |
最小バージョン |
|
Linux |
1.2.0.82 |
|
Windows |
1.1.0.82 |
|
macOS |
1.3.0.82 |
現在のバージョンを確認します:
./ali-instance-cli version
ステップ 2:ゲートウェイのステータス確認
インスタンス上で、OpenClaw ゲートウェイのステータスを確認します:
openclaw gateway status
ステップ 3:ゲートウェイ認証トークンの取得
openclaw.json 設定ファイルから OpenClaw ゲートウェイの認証トークンを取得します。
-
Linux:
~/.openclaw/openclaw.json -
Windows:
C:\Users\<User name>\.openclaw\openclaw.json
トークンは gateway.auth.token フィールドにあります:
{
"gateway": {
"auth": {
"mode": "token",
"token": "<YOUR_TOKEN>"
}
}
}
次のコマンドの <TOKEN> は、この値を指します。
ステップ 4:TUI の起動
ターゲットインスタンスが Linux を実行している場合:
インスタンス ID、システムユーザー名、OpenClaw ゲートウェイの認証トークンを指定します。
./ali-instance-cli session --instance <INSTANCE_ID> --user-name <USER_NAME> --commandLine "openclaw tui --token <TOKEN>"
ターゲットインスタンスが Windows を実行している場合:
インスタンス ID、システムユーザー名、ユーザーパスワード、OpenClaw ゲートウェイの認証トークンを指定します。
./ali-instance-cli session --instance <INSTANCE_ID> --user-name <USER_NAME> --password <PASSWD> --commandLine "powershell -command openclaw tui --token <TOKEN>"
これらは基本的な例です。必要に応じて、他の openclaw tui パラメーターを追加してください。
よくある質問
OpenClaw は Docker コンテナにデプロイされています。ポートフォワーディング後に Web UI にアクセスできない
OpenClaw ゲートウェイが、Docker がアクセスできるネットワークインターフェースにバインドされていません。デフォルトでは、ゲートウェイはループバックアドレスにバインドされるため、Docker のポートマッピングによるトラフィックの転送が妨げられます。
解決策: OpenClaw ゲートウェイのバインドモードを LAN に変更し、コンテナを再起動します:
<CONTAINER_NAME> をお使いのコンテナ名に置き換えます:
docker exec <CONTAINER_NAME> openclaw config set gateway.bind lan
docker restart <CONTAINER_NAME>
Docker コマンド実行時の「Permission denied」エラー
デフォルトでは、ali-instance-cli のセッションは ecs-assist-user として実行されます。Docker コマンドを実行するには、sudo を使用してください。例:sudo docker exec openclaw openclaw dashboard。