nemoclaw-user-manage-sandboxes

管理沙箱生命周期

完成 OpenClaw 快速入门后（使用 nemoclaw-user-get-started 技能），请参阅本指南。 本指南介绍沙箱的日常运维操作，例如列出沙箱、检查运行状况、管理端口、安全地重建、升级和卸载。 如果工作流使用底层 OpenShell CLI，请参阅 CLI 选择指南（使用 nemoclaw-user-reference 技能），了解 nemoclaw 和 openshell 之间的界限。

列出沙箱

列出此主机上注册的所有沙箱：

$ 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 审计事件，因此策略拒绝信息会与网关日志一同显示。

收集诊断信息

收集诊断信息，用于提交 Bug 报告或交接给支持人员：

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

使用 --quick 获取较小的本地摘要：

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

debug 命令会收集系统信息、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

有关端口冲突和覆盖设置的完整详情，请参阅端口已被占用（使用 nemoclaw-user-reference 技能）。

重新配置或恢复

无需重新运行完整的引导向导或销毁工作区状态，即可从配置错误的沙箱中恢复。

更改推理模型或 API

无需重建沙箱，即可在运行时更改当前模型或提供商：

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

有关特定提供商的模型 ID 和 API 兼容性说明，请参阅切换推理提供商（使用 nemoclaw-user-configure-inference 技能）。

重启网关和端口转发

如果 nemoclaw <name> status 报告沙箱仍在运行，但网关未运行，请运行恢复命令，而不是打开 shell。

$ 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，并检查现有沙盒是否使用了过时的 Agent／运行时版本。

更新 NemoClaw CLI

重新运行安装程序。 在开始任何入门流程之前，安装程序会自动调用 nemoclaw backup-all（使用 nemoclaw-user-reference 技能），将每个正在运行的沙盒快照保存到 ~/.nemoclaw/rebuild-backups/，以备不时之需。 如果现有网关使用的 OpenShell 版本早于 0.0.37，安装程序会在运行新的自动网关升级流程前征求确认。 仅当现有 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

升级 Agent 和运行时版本过时的沙盒

入门成功后，安装程序会检查已注册的沙盒，并对版本过时且正在运行的沙盒执行 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 是一个 CLI 封装命令，调用的安装程序流程与 curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash 相同。 如果你只想检查版本状态并查看维护的更新命令，请使用 nemoclaw update --check。

对于脚本化的手动重建，请使用 nemoclaw upgrade-sandboxes --auto 跳过确认提示。

如果升级后的沙盒需要还原其工作区状态，请将升级前的快照恢复到正在运行的沙盒中。 此操作只会恢复已保存的状态目录；不会降级沙盒镜像或 Agent／运行时：

$ 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

如需全面比较这两种方式，包括它们会获取什么、信任什么以及各自适用的情况，请参阅 nemoclaw uninstall 与托管的 uninstall.sh 对比（使用 nemoclaw-user-reference 技能）。

参考资料

• references/runtime-controls.md — 一页说明，介绍 NemoClaw 沙盒中哪些内容可以在运行时更改，哪些需要重新构建。
• 加载 references/backup-restore.md，当需要从沙盒下载工作区文件、将恢复的文件上传到新沙盒，或在重新构建期间保留沙盒状态时使用。它会在沙盒重新构建等破坏性操作前备份并恢复 OpenClaw 工作区文件。
• 加载 references/messaging-channels.md，当需要设置消息渠道、聊天界面或集成，且不依赖 nemoclaw tunnel start 为桥接服务启动隧道时使用。它介绍 Telegram、Discord、Slack、WeChat 和 WhatsApp 如何通过 OpenShell 管理的进程和 NemoClaw 渠道命令连接到沙盒中的 OpenClaw 和 Hermes Agent。
• 加载 references/workspace-files.md，当用户询问 SOUL.md、USER.md、IDENTITY.md、AGENTS.md 或其他工作区文件，或准备备份或恢复工作区状态时使用。它介绍工作区个性与配置文件的作用、存放位置，以及它们如何在沙盒重启后保留。
• 加载 references/lifecycle-details.md，当需要了解“重新构建期间会发生什么”的详细步骤时使用。

相关技能

• 设置消息渠道，用于连接 Telegram、Discord 或 Slack。
• 工作区文件，用于了解沙盒内持久保存的 OpenClaw 文件。
• 备份和恢复，用于快照和恢复工作流。
• nemoclaw-user-monitor-sandbox — 监控沙盒活动（使用 nemoclaw-user-monitor-sandbox 技能）以获取可观测性工具