nemoclaw-user-deploy-remote

NemoClaw をリモート GPU インスタンスにデプロイする

注意事項

• nemoclaw deploy コマンドは非推奨です。
• Brev では、インストーラーがサンドボックスイメージをビルドするときに利用できるよう、起動可能な環境設定で CHAT_UI_URL を設定してください。

前提条件

• Brev CLI がインストールされ、認証済みであること。
• オンボーディング中に使用する推論バックエンドのプロバイダー認証情報。
• リモート vLLM または Hugging Face のワークフローでゲート付きモデルへのアクセスが必要な場合、HF_TOKEN または HUGGING_FACE_HUB_TOKEN がエクスポートされていること。
• 非推奨の nemoclaw deploy ラッパーを使用する場合は、NemoClaw がローカルにインストールされていること。それ以外の場合は、プロビジョニング後にリモートホストへ NemoClaw を直接インストールしてください。

Brev を通じて、リモート GPU インスタンス上で NemoClaw を実行します。 推奨される方法は、VM をプロビジョニングし、そのホストで標準の NemoClaw インストーラーを実行してから、nemoclaw onboard を実行することです。

クイックスタート

Brev インスタンスがすでに起動しており、サンドボックスでオンボーディングも完了している場合は、標準のサンドボックスチャットフローから始めます。

$ nemoclaw my-assistant connect
$ openclaw tui

まずサンドボックスのシェルに入り、すぐに OpenClaw チャット UI を開きます。 VM が新規の場合は、そのホストで標準のインストーラーを実行し、nemoclaw my-assistant connect を実行する前に nemoclaw onboard を実行してください。

ローカルマシンから接続していて、リモート VM のプロビジョニングがまだ必要な場合は、以下で説明するレガシー互換パスとして nemoclaw deploy <instance-name> を引き続き使用できます。

インスタンスをデプロイする

警告：

nemoclaw deploy コマンドは非推奨です。 リモートホストは個別にプロビジョニングし、そのホストで標準の NemoClaw インストーラーと nemoclaw onboard を実行する方法を推奨します。

Brev インスタンスを作成し、レガシー互換フローを実行します。

$ nemoclaw deploy <instance-name>

<instance-name> を、リモートインスタンスの名前に置き換えてください。たとえば my-gpu-box です。 リモート VM に作成されるサンドボックスでは、NEMOCLAW_SANDBOX_NAME が使用されます。この変数が設定されていない場合は my-assistant が使用されます。 サンドボックス名は小文字で、先頭は英字、使用できる文字は英字、数字、内部のハイフンのみで、末尾は英字または数字である必要があります。 デプロイラッパーは、Brev インスタンスのプロビジョニング、SSH の開始、リモートインストーラーの起動を行う前に、サンドボックス名を検証します。

レガシー互換フローでは、VM 上で次の手順を実行します。

1. GPU が存在する場合、Docker と NVIDIA Container Toolkit をインストールします。
2. OpenShell CLI をインストールします。
3. nemoclaw onboard（セットアップウィザード）を実行してゲートウェイを作成し、プロバイダーを登録して、サンドボックスを起動します。
4. cloudflared が利用可能な場合、オプションのホスト補助サービス（たとえば cloudflared トンネル）を起動します。チャンネルメッセージングはオンボーディング中に設定され、nemoclaw tunnel start ではなく、OpenShell 管理下のプロセスを通じて実行されます。

デフォルトでは、互換ラッパーは Brev に gcp でのプロビジョニングを要求します。別の Brev クラウドプロバイダーが必要な場合は、NEMOCLAW_BREV_PROVIDER で上書きしてください。 HF_TOKEN または HUGGING_FACE_HUB_TOKEN をエクスポートすると、ラッパーはその値を VM に転送し、リモートセットアップでゲート付きの Hugging Face モデルリポジトリを取得できるようにします。

リモートサンドボックスに接続する

デプロイが完了すると、deploy コマンドによってリモートサンドボックス内の対話型シェルが開きます。 セッションを閉じた後に再接続するには、コマンドをもう一度実行してください。

$ nemoclaw deploy <instance-name>

リモートサンドボックスを監視する

インスタンスに SSH 接続し、OpenShell TUI を実行してアクティビティを監視し、ネットワークリクエストを承認します。

$ ssh <instance-name> 'cd ~/nemoclaw && set -a && . .env && set +a && openshell term'

推論を検証する

リモートサンドボックス内でテスト用のエージェントプロンプトを実行します。

$ openclaw agent --agent main -m "Hello from the remote sandbox" --session-id test

リモートダッシュボードへのアクセス

NemoClaw ダッシュボードは、サンドボックスイメージのビルド時に組み込まれた許可リストを使って、ブラウザーのオリジンを検証します。デフォルトでは、許可リストには http://127.0.0.1:18789 のみが含まれています。リモートブラウザーからダッシュボードにアクセスする場合（たとえば、Brev の公開 URL や SSH ポートフォワーディングを使用する場合）は、セットアップを実行する前に、ブラウザーが使用するオリジンを CHAT_UI_URL に設定してください。

$ export CHAT_UI_URL="https://openclaw0-<id>.brevlab.com"
$ nemoclaw deploy <instance-name>

SSH ポートフォワーディングの場合、オリジンは通常 http://127.0.0.1:18789（デフォルト）なので、追加の設定は必要ありません。

警告：

Brev では、インストーラーがサンドボックスイメージをビルドするときに利用できるよう、起動可能な環境設定で CHAT_UI_URL を設定してください。ヘッドレスホストで CHAT_UI_URL が設定されていない場合、互換性ラッパーが警告を表示します。

NEMOCLAW_DISABLE_DEVICE_AUTH もイメージのビルド時に評価されます。 CHAT_UI_URL がループバック以外のオリジンを指している場合、ブラウザーのみを使用するリモートユーザーはターミナルベースのペアリングを完了できないため、NemoClaw は生成されるサンドボックス設定で OpenClaw のデバイスペアリングを無効にします。 設定されたダッシュボードのオリジンにアクセスできるデバイスは、ペアリングなしで接続できるため、そのオリジンをインターネットからアクセス可能な環境や共有ネットワーク環境で公開しないでください。

初回実行時の準備時間の目安

リモート GPU ホストでは、最初の nemoclaw onboard がライフサイクルの中で通常、最も時間のかかる処理を行います。サンドボックスイメージがローカルでビルドされ、OpenShell ゲートウェイにアップロードされます。準備完了の待機が始まる前に、VM のネットワークを介して数百 MiB が転送されることがあります。 作成後の準備完了待機時間は、デフォルトで 180 秒（NEMOCLAW_SANDBOX_READY_TIMEOUT）です。これは、キャッシュが温まったワークステーションクラスのオンボーディングを想定した設定であり、次のような場合は超過することがあります。

• 大規模な量子化モデル（70B 以上のパラメーター規模、NVFP4 重み）を使用する DGX Station の初回実行。
• ローカルのイメージビルドキャッシュが空で、アップロードをパブリックネットワーク経由で行うクラウド VM。
• 初回実行時に Brave Web Search プリセットをオンボーディングするホスト（外向き通信ポリシーのスタックによって起動時の処理が増加します）。

再度オンボーディングを実行する前に、時間の上限を引き上げてください。

$ export NEMOCLAW_SANDBOX_READY_TIMEOUT=600
$ nemoclaw onboard

オンボーディングが Sandbox '<name>' was created but did not become ready within 180s で終了した場合、オンボーディングは最初に作成途中のサンドボックスを削除します。そのため、時間の上限を引き上げて次の試行を行うと、クリーンな状態から開始できます。 オンボーディングの前段階で実行される推論プローブの時間の上限については、NEMOCLAW_LOCAL_INFERENCE_TIMEOUT を参照してください（nemoclaw-user-configure-inference スキルを使用してください）。

プロキシ設定

NemoClaw は、デフォルトで 10.200.0.1:3128 に設定されるゲートウェイプロキシ経由で、サンドボックスのトラフィックをルーティングします。 ネットワークで別のプロキシが必要な場合は、オンボーディングの前に NEMOCLAW_PROXY_HOST と NEMOCLAW_PROXY_PORT を設定してください。

$ export NEMOCLAW_PROXY_HOST=proxy.example.com
$ export NEMOCLAW_PROXY_PORT=8080
$ nemoclaw onboard

これらの値は、サンドボックスイメージのビルド時に組み込まれます。 サンドボックスの作成時には、実行時コンテナーにも転送されるため、/tmp/nemoclaw-proxy-env.sh ではイメージのビルド時と同じホストおよびポートが使用されます。 ホストに使用できるのは、英数字、ドット、ハイフン、コロンのみです。 ポートは数値（0～65535）である必要があります。 オンボーディング後にプロキシを変更するには、nemoclaw onboard を再実行する必要があります。

GPU 設定

デプロイスクリプトでは、GPU の種類を選択するために NEMOCLAW_GPU 環境変数を使用します。 別の GPU 設定を使用するには、nemoclaw deploy を実行する前にこの変数を設定してください。

$ export NEMOCLAW_GPU="a2-highgpu-1g:nvidia-tesla-a100:2"
$ nemoclaw deploy <instance-name>

参考資料

• ユーザーが NemoClaw で OpenClaw プラグインをインストール、ビルド、または設定する方法を尋ねた場合は、references/install-openclaw-plugins.md を読み込みます。OpenClaw プラグインとエージェントスキルの違いを説明し、Dockerfile ベースのワークフローを使ってプラグインを NemoClaw サンドボックスに組み込む現在の方法を紹介します。
• ユーザーが CLI をインストールせずに NemoClaw を試したい場合や、Brev での始め方を尋ねた場合は、references/brev-web-ui.md を読み込みます。Brev のウェブ UI を使って NemoClaw をデプロイする方法を案内します。
• サンドボックスイメージのセキュリティ制御を確認する場合、ケイパビリティの削除を監査する場合、または実行時のリソース制限を調べる場合は、references/sandbox-hardening.md を読み込みます。Docker のケイパビリティとプロセス制限を含む、サンドボックスコンテナイメージの強化に関するリファレンスです。

関連スキル

• nemoclaw-user-manage-sandboxes — メッセージングチャネルの設定（nemoclaw-user-manage-sandboxes スキルを使用）により、OpenShell 管理のチャネルメッセージングを通じて Telegram、Discord、または Slack に接続します
• nemoclaw-user-monitor-sandbox — サンドボックスアクティビティの監視（nemoclaw-user-monitor-sandbox スキルを使用）では、サンドボックスの監視ツールを利用できます
• nemoclaw-user-reference — コマンド（nemoclaw-user-reference スキルを使用）では、deploy コマンドの全リファレンスを確認できます