nemoclaw-user-manage-sandboxes

サンドボックスのライフサイクル管理

OpenClaw のクイックスタートを完了した後に、このガイドを使用してください（nemoclaw-user-get-started スキルを使用してください）。 サンドボックスの一覧表示、ヘルスチェック、ポートの管理、安全な再構築、アップグレード、アンインストールなど、運用開始後のサンドボックス操作について説明します。 ワークフローで低レベルの OpenShell CLI を使用する場合は、nemoclaw と openshell の使い分けについて CLI Selection Guide（nemoclaw-user-reference スキルを使用）を参照してください。

サンドボックスを一覧表示する

このホストに登録されているすべてのサンドボックスを一覧表示します。

$ nemoclaw list

一覧には、各サンドボックスのモデル、プロバイダー、ポリシープリセット、アクティブな SSH セッションのインジケーター、ダッシュボードのポートが記録されている場合はダッシュボード URL が表示されます。 スクリプトでは JSON 出力を使用します。

$ nemoclaw list --json

サンドボックスのヘルスを確認する

指定したサンドボックスのヘルス、推論ルート、アクティブな接続、現在のポリシー、更新状況、メッセージングチャネルの重複に関する警告を確認します。

$ nemoclaw my-assistant status

サンドボックスの一覧と、cloudflared などのホスト補助サービスの状態を確認するには、ホストレベルのステータスコマンドを使用します。

$ nemoclaw status

ログを確認する

サンドボックスの最近のログを表示します。

$ nemoclaw my-assistant logs

問題を再現しながらログをストリーミングします。

$ nemoclaw my-assistant logs --follow

ログコマンドは OpenClaw ゲートウェイの出力と OpenShell の監査イベントの両方を読み取るため、ポリシーによる拒否がゲートウェイログと並んで表示されます。

診断情報を収集する

バグ報告やサポートへの引き継ぎのために診断情報を収集します。

$ nemoclaw debug --sandbox my-assistant --output nemoclaw-debug.tar.gz

小さなローカルサマリーを作成するには、--quick を使用します。

$ nemoclaw debug --quick --sandbox my-assistant

デバッグコマンドは、システム情報、Docker の状態、ゲートウェイログ、サンドボックスの状態を収集します。

ダッシュボードのポートを管理する

ポートフォワードが停止した場合、またはインストーラーがアクティブなポートフォワードを検出できなかったと報告し、URL が読み込まれない場合は、インストール概要に表示されたポートを使って手動で再起動します。

$ openshell forward start --background <dashboard-port> my-gpt-claw

すべてのサンドボックスでアクティブなポートフォワードを一覧表示するには、次のコマンドを実行します。

$ openshell forward list

複数のサンドボックスを実行する

openshell forward は、別のサンドボックスがすでに使用しているポートへのバインドを拒否するため、各サンドボックスにはそれぞれ専用のダッシュボードポートが必要です。 デフォルトのポートが別のサンドボックスによってすでに使用されている場合、nemoclaw onboard はポート 18789 から 18799 をスキャンし、次に空いているポートを使用します。

$ nemoclaw onboard                                      # first sandbox uses 18789
$ nemoclaw onboard                                      # second sandbox uses the next free port, such as 18790

特定のポートを選択するには、--control-ui-port を渡します。

$ nemoclaw onboard --control-ui-port 19000

オンボーディングの前に CHAT_UI_URL または NEMOCLAW_DASHBOARD_PORT を設定することもできます。

$ CHAT_UI_URL=http://127.0.0.1:19000 nemoclaw onboard
$ NEMOCLAW_DASHBOARD_PORT=19000 nemoclaw onboard

ポートの競合と上書きの詳細については、Port already in use（nemoclaw-user-reference スキルを使用）を参照してください。

再設定または復旧する

オンボーディングウィザード全体を再実行したり、ワークスペースの状態を破棄したりせずに、設定に問題のあるサンドボックスを復旧します。

推論モデルまたは API を変更する

サンドボックスを再構築せずに、実行時にアクティブなモデルまたはプロバイダーを変更します。

$ nemoclaw inference set --model <model> --provider <provider>

プロバイダー固有のモデル ID と API の互換性に関する注意事項については、Switch Inference Providers（nemoclaw-user-configure-inference スキルを使用）を参照してください。

ゲートウェイとポートフォワードを再起動する

nemoclaw <name> status でサンドボックスは稼働中と報告されるものの、ゲートウェイが実行されていない場合は、シェルを開く代わりに復旧コマンドを実行します。

$ nemoclaw <sandbox-name> recover

このコマンドは、サンドボックス内のゲートウェイを再起動し、ダッシュボードのポートフォワードを再確立します。 冪等であり、スクリプトから安全に実行できます。 詳細については、nemoclaw <name> recover（nemoclaw-user-reference スキルを使用）を参照してください。

保存済みの認証情報をリセットする

オンボーディング中にプロバイダーの認証情報を誤って入力した場合は、ゲートウェイに登録された値を消去し、次回のオンボーディング実行時に再入力します。

$ nemoclaw credentials list                # see which providers are registered
$ nemoclaw credentials reset <PROVIDER>    # clear a single provider, for example nvidia-prod
$ nemoclaw onboard                         # re-run to re-enter the cleared provider

認証情報コマンドの詳細については、nemoclaw credentials reset <PROVIDER>（nemoclaw-user-reference スキルを使用）を参照してください。

ワークスペースの状態を保持したままサンドボックスを再構築する

基盤となる Dockerfile を変更した場合、OpenClaw をアップグレードした場合、またはサンドボックスのワークスペースファイルを失わずに新しいベースイメージを取り込みたい場合は、破棄して作り直すのではなく、rebuild を使用してください。

$ nemoclaw <sandbox-name> rebuild

再構築では、マウントされたワークスペースと登録済みポリシーを保持したまま、コンテナを再作成します。 NemoClaw が指定された状態パスをアーカイブできない場合は、バックアップの失敗を報告し、元のサンドボックスを削除する前に処理を停止します。 フラグの詳細については、nemoclaw <name> rebuild（nemoclaw-user-reference スキルを使用）を参照してください。

オンボーディング後にネットワークプリセットを追加する

再オンボーディングせずに、Telegram や GitHub などの追加プリセットを実行中のサンドボックスに適用します。

$ nemoclaw <sandbox-name> policy-add

使い方とフラグの詳細については、nemoclaw <name> policy-add（nemoclaw-user-reference スキルを使用）を参照してください。

デフォルトの suggested ポリシーモードで非対話型の再オンボーディングを行う場合、この方法で追加したプリセットは保持されます。 再オンボーディングを適用内容の完全な指定として扱うには、NEMOCLAW_POLICY_MODE=custom を設定し、適用するリストを正確に指定した NEMOCLAW_POLICY_PRESETS を渡してください。オンボーディングでは、それ以外の項目がすべて削除されます。 全体の表については、NEMOCLAW_POLICY_MODE（nemoclaw-user-reference スキルを使用）を参照してください。

最新バージョンに更新する

新しい NemoClaw リリースが利用可能になったら、ホスト上の nemoclaw CLI を更新し、既存のサンドボックスでエージェントやランタイムのバージョンが古くなっていないか確認してください。

NemoClaw CLI を更新する

インストーラーを再実行してください。 インストーラーは、何かをオンボーディングする前に nemoclaw backup-all（nemoclaw-user-reference スキルを使用）を自動的に呼び出し、安全策として実行中の各サンドボックスのスナップショットを ~/.nemoclaw/rebuild-backups/ に保存します。 既存のゲートウェイが 0.0.37 より前の OpenShell の場合、新しい自動ゲートウェイアップグレードの実行前に、インストーラーが確認を求めます。 自動アップグレードは、既存の nemoclaw CLI が backup-all に対応している場合にのみ選択できます。古いインストールでは、ゲートウェイを廃止する前にサンドボックスの状態を手動で保持する必要があります。 無人インストールでは、NEMOCLAW_ACCEPT_EXPERIMENTAL_OPENSHELL_UPGRADE=1 を設定するか、手動で nemoclaw backup-all と openshell gateway destroy -g nemoclaw || openshell gateway destroy を実行してから、次のように再度インストーラーを実行してください：curl -fsSL https://www.nvidia.com/nemoclaw.sh | NEMOCLAW_OPENSHELL_UPGRADE_PREPARED=1 bash。

$ curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash

エージェントやランタイムのバージョンが古いサンドボックスをアップグレードする

インストーラーはオンボーディングの成功後、登録済みのサンドボックスを確認し、バージョンが古い実行中のサンドボックスに対して nemoclaw upgrade-sandboxes --auto を実行します。 結果を確認する場合、インストーラーやオンボーディングの手順を省略して再構築する場合、または停止中のサンドボックスやバージョンを確認できなかったサンドボックスに対処する場合は、upgrade-sandboxes を直接使用してください。 NemoClaw はマニフェストで定義されたワークスペースの状態を保持するため、アップグレードのフローはデフォルトで非破壊的です。ただし、メジャーアップグレードの前に手動でスナップショットを作成しておけば、状態を復元できるようになります。

$ nemoclaw <sandbox-name> snapshot create --name pre-upgrade   # optional, recommended
$ nemoclaw update --yes                                        # updates CLI through the maintained installer flow
$ nemoclaw upgrade-sandboxes --check                            # verify or list remaining stale/unknown sandboxes
$ nemoclaw upgrade-sandboxes                                    # manually rebuild remaining stale running sandboxes

nemoclaw update は、curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash と同じインストーラーパスを実行する CLI ラッパーです。 バージョン状態を確認し、維持されている更新コマンドを確認するだけの場合は、nemoclaw update --check を使用してください。

スクリプトから手動で再構築する場合は、確認プロンプトを省略するために nemoclaw upgrade-sandboxes --auto を使用してください。

アップグレードしたサンドボックスのワークスペース状態を元に戻す必要がある場合は、アップグレード前のスナップショットを実行中のサンドボックスに復元してください。 復元されるのは保存済みの状態ディレクトリのみです。サンドボックスのイメージやエージェント／ランタイムのダウングレードは行われません。

$ nemoclaw <sandbox-name> snapshot restore pre-upgrade

再構築時に変更される内容の詳細な手順については、references/lifecycle-details.md を参照してください。

アンインストール

NemoClaw とセットアップ中に作成されたすべてのリソースを削除するには、CLI に組み込まれているアンインストールコマンドを実行します。

nemoclaw uninstall

フラグ	動作
--yes	確認プロンプトをスキップします。
--keep-openshell	OpenShell のバイナリをインストールしたままにします。
--delete-models	NemoClaw が取得した Ollama モデルも削除します。

nemoclaw uninstall は、インストール済みの CLI に同梱されているバージョン固定の uninstall.sh を実行するため、アンインストール時にネットワーク経由で何かを取得することはありません。

nemoclaw CLI が見つからない場合や、正常に動作しない場合は、ホストされたスクリプトを使用してください。

curl -fsSL https://raw.githubusercontent.com/NVIDIA/NemoClaw/refs/heads/main/uninstall.sh | bash

上記の --yes、--keep-openshell、--delete-models フラグは、ホストされたスクリプトにも適用されます。bash -s -- の後に指定してください。

curl -fsSL https://raw.githubusercontent.com/NVIDIA/NemoClaw/refs/heads/main/uninstall.sh | bash -s -- --yes --delete-models

2 つの方法で取得するもの、信頼するもの、それぞれを選ぶべき状況を含む詳細な比較については、「nemoclaw uninstall とホストされた uninstall.sh の比較」を参照してください（nemoclaw-user-reference スキルを使用します）。

参考資料

• references/runtime-controls.md — NemoClaw サンドボックスで、実行時に変更できるものと再ビルドが必要なものを説明する一覧ページです。
• サンドボックスからワークスペースファイルをダウンロードする場合、新しいサンドボックスに復元済みファイルをアップロードする場合、または再ビルドをまたいでサンドボックスの状態を保持する場合は、references/backup-restore.md を読み込んでください。サンドボックスの再ビルドなどの破壊的な操作の前に、OpenClaw のワークスペースファイルをバックアップして復元します。
• nemoclaw tunnel start をブリッジに使用せずに、メッセージングチャネル、チャットインターフェース、インテグレーションを設定する場合は、references/messaging-channels.md を読み込んでください。OpenShell が管理するプロセスと NemoClaw のチャネルコマンドを通じて、Telegram、Discord、Slack、WeChat、WhatsApp がサンドボックス内の OpenClaw エージェントと Hermes エージェントに接続する方法を説明します。
• SOUL.md、USER.md、IDENTITY.md、AGENTS.md などのワークスペースファイルについて質問された場合、またはワークスペースの状態をバックアップもしくは復元する準備をする場合は、references/workspace-files.md を読み込んでください。ワークスペースの性格設定ファイルと構成ファイルの概要、それらの保存場所、サンドボックスの再起動後も維持される仕組みを説明します。
• 「再ビルド中に変わること」の詳しい手順が必要な場合は、references/lifecycle-details.md を読み込んでください。

関連スキル

• Telegram、Discord、Slack を接続するには、メッセージングチャネルを設定する を参照してください。
• サンドボックス内で OpenClaw ファイルを永続化するには、ワークスペースファイル を参照してください。
• スナップショットと復元のワークフローについては、バックアップと復元 を参照してください。
• nemoclaw-user-monitor-sandbox — サンドボックスアクティビティの監視（nemoclaw-user-monitor-sandbox スキルを使用）に使う可観測性ツール