nemoclaw-user-get-started

使用 OpenClaw 快速入门 NemoClaw

按照以下步骤开始使用 NemoClaw，并创建你的第一个沙盒化 OpenClaw Agent。

注意：

请先完成先决条件中的检查，再按照本指南操作。

安装 NemoClaw 并引导设置 OpenClaw Agent

下载并运行安装脚本。 如果尚未安装 Node.js，脚本会先安装它，然后运行引导式设置向导来创建沙盒、配置推理并应用安全策略。

注意：

在引导设置过程中，NemoClaw 会在沙盒内创建一个全新的 OpenClaw 实例。

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

通过管道运行的安装程序会在终端中提示你操作。在无头脚本或 CI 中， 请向管道的 bash 端传入明确的接受参数：

$ curl -fsSL https://www.nvidia.com/nemoclaw.sh | NEMOCLAW_NON_INTERACTIVE=1 NEMOCLAW_ACCEPT_THIRD_PARTY_SOFTWARE=1 bash

如果你使用 nvm 或 fnm 管理 Node.js，安装程序可能不会更新当前 shell 的 PATH。 如果安装后找不到 nemoclaw，请运行 source ~/.bashrc（如果使用 zsh，则运行 source ~/.zshrc），或打开一个新终端。

在 Linux 上，安装 NemoClaw 前，安装程序会先检查 Docker。 如果缺少 Docker，安装程序会下载官方 Docker 便捷脚本，提示输入 sudo 密码，安装 Docker，并在 systemd 可用时启动 Docker 服务。 如果已安装 Docker，但当前 shell 还无法使用 Docker 套接字，安装程序会根据需要将你的用户添加到 docker 组，然后退出并提供恢复命令。

在 macOS 上，安装程序会通过 Docker Desktop 或 Colima 使用 Docker 驱动的 OpenShell 网关路径。

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

在 DGX Spark、DGX Station 和 Windows WSL 上，交互式安装程序会在你接受第三方软件声明后提供快速安装选项。 快速安装会将引导设置切换为非交互模式，允许为所需的主机更改提示输入 sudo 密码，并为该平台选择托管本地推理路径。 除非设置了 NEMOCLAW_POLICY_TIER，否则默认情况下，它会以 suggested 模式和 balanced 层级应用沙盒策略，并使用基础沙盒策略以及受支持的软件包、模型、网页搜索和本地推理预设。 在 WSL 上，快速安装会选择 Windows 主机 Ollama 设置路径。 设置 NEMOCLAW_NO_EXPRESS=1 可跳过快速安装提示；如果你想自行选择提供商，请在启动安装程序前设置 NEMOCLAW_PROVIDER。

如果安装程序能找到刚安装的二进制文件，就会自动启动 nemoclaw onboard。 如果找不到该二进制文件，或主机预检中存在阻止继续的问题，则不会自动启动向导。 在这种情况下，安装程序会输出相关诊断信息，以及包含明确 nemoclaw onboard 命令的 To finish setup, run: 代码块。

注意：

引导设置流程会使用 NEMOCLAW_DISABLE_DEVICE_AUTH=1 构建沙盒映像，以便在设置期间立即使用仪表板。 这是构建时写入沙盒映像的设置，不是运行时开关。 如果在引导设置完成后导出 NEMOCLAW_DISABLE_DEVICE_AUTH，对现有沙盒不会产生任何影响。

在构建沙盒前检查配置

输入沙盒名称后，向导会打印配置摘要，并要求你进行最终确认，然后才注册提供商、提示你配置可选集成并构建沙盒映像。 例如，如果你选择了兼容 OpenAI 的端点，摘要如下所示：

  ──────────────────────────────────────────────────
  Review configuration
  ──────────────────────────────────────────────────
  Provider:      compatible-endpoint
  Model:         openai/openai/gpt-5.5
  API key:       COMPATIBLE_API_KEY (staged for OpenShell gateway registration)
  Web search:    disabled
  Messaging:     none
  Sandbox name:  my-gpt-claw
  Note:          Sandbox build typically takes 5–15 minutes on this host.
  ──────────────────────────────────────────────────
  Web search and messaging channels will be prompted next.
  Apply this configuration? [Y/n]:

默认值为 Y，因此按一次 Enter 即可继续。回答 n 可正常中止操作、修正条目，然后重新运行 nemoclaw onboard。

非交互式运行（NEMOCLAW_NON_INTERACTIVE=1）会打印摘要以便在日志中查看，但会跳过提示。

配置网页搜索和消息渠道

确认摘要后，NemoClaw 会向 OpenShell 网关注册所选提供商，并设置 inference.local 路由。 随后，向导会询问是否启用 Brave Web Search。 如果启用，请在提示时输入 Brave Search API 密钥。

向导还提供 Telegram、Discord、Slack、微信和 WhatsApp 等消息渠道。 按渠道编号切换，然后按 Enter 继续。 如果选择某个渠道，NemoClaw 会验证令牌格式，然后将该渠道配置写入沙箱。 例如，Slack 机器人令牌必须以 xoxb- 开头。 微信和 WhatsApp 处于实验阶段。 启用前，请查看 Messaging Channels（使用 nemoclaw-user-manage-sandboxes 技能）。

选择网络策略预设

沙箱映像构建完成且 OpenClaw 在沙箱内启动后，NemoClaw 会询问要应用哪个网络策略层级。 默认的 Balanced 层级包含常见开发预设，例如 npm、PyPI、Hugging Face、Homebrew，以及在所选 Agent 支持网页搜索时提供的 Brave Search。 使用方向键或 j 和 k 移动，按空格键选择，然后按 Enter 确认。

预设选择器允许你添加更多目标，例如 GitHub、Jira、Slack、Telegram 或本地推理。 如果预设支持这两种模式，按 r 可在只读和读写模式之间切换所选预设。

安装完成后，摘要会确认运行环境。 打印摘要前，NemoClaw 会验证沙箱网关和仪表板端口转发是否可访问。 如果推理路由和消息桥接检查还需要更多时间或额外配置，系统会将其列为警告。 Model 和提供商这一行会显示你在引导过程中选择的推理选项。 以下示例展示了在引导过程中选择兼容 OpenAI 的端点时的结果。

──────────────────────────────────────────────────
NemoClaw is ready

Sandbox:  my-gpt-claw
Model:    openai/openai/gpt-5.5 (Other OpenAI-compatible endpoint)

Start chatting

  Browser:
    http://127.0.0.1:18789/

  Terminal:
    nemoclaw my-gpt-claw connect
    then run: openclaw tui

Authenticated dashboard URL, if needed:
  nemoclaw my-gpt-claw dashboard-url --quiet

Manage later

  Status:      nemoclaw my-gpt-claw status
  Logs:        nemoclaw my-gpt-claw logs --follow
  Model:       nemoclaw inference set --model <model> --provider <provider> --sandbox my-gpt-claw
  Policies:    nemoclaw my-gpt-claw policy-add
  Credentials: nemoclaw credentials reset <KEY> && nemoclaw onboard
──────────────────────────────────────────────────

[INFO]  === Installation complete ===

如果选择了其他选项，Model 行会显示相应提供商的模型和标签。例如，你可能会看到 gpt-5.4 (OpenAI)、claude-sonnet-4-6 (Anthropic)、gemini-2.5-flash (Google Gemini)、llama3.1:8b (Local Ollama)、nvidia-routed (Model Router) 或 <your-model> (Other OpenAI-compatible endpoint)。

加载 references/quickstart-details.md，查看 Respond to the Onboard Wizard 的详细步骤。

运行你的第一个 Agent 提示词

你可以通过终端或浏览器与 Agent 聊天。

在浏览器中打开 OpenClaw UI，与 Agent 聊天

引导向导会启动指向沙箱仪表板的后台端口转发，然后在安装摘要中打印仪表板 URL。 默认主机端口为 18789。 如果该端口已被占用，NemoClaw 会使用下一个空闲的仪表板端口（例如 18790），并在最终 URL 中打印该端口。 如果所选端口在沙箱构建开始后被占用，引导过程会回滚新建的沙箱并要求你重试，而不会打印无法访问的仪表板 URL。 安装记录不会打印网关令牌。 如果浏览器需要身份验证，请使用 dashboard-url --quiet 命令显式打印完整 URL。

nemoclaw my-gpt-claw dashboard-url --quiet

在浏览器中打开仪表板 URL。 如果浏览器要求身份验证，请运行 nemoclaw my-gpt-claw dashboard-url --quiet 并打开返回的 URL。 请将经过身份验证的 URL 视同密码妥善保管。

在终端中与 Agent 聊天

连接到沙箱并使用 OpenClaw CLI。

nemoclaw my-assistant connect
# inside the sandbox:
openclaw tui

参考资料

• 在用户询问 Hermes 设置、NemoHermes 入门或在 OpenShell 中运行 Hermes 时，加载 references/quickstart-hermes.md。 安装 NemoClaw，选择 Hermes Agent，并启动沙盒化的 Hermes API 端点。
• 在安装前核实前置条件时，加载 references/prerequisites.md。 列出运行 NemoClaw 所需的硬件、软件和容器运行时要求。
• 在为 NemoClaw 准备 Windows 设备、启用 WSL 2、配置适用于 Windows 的 Docker Desktop，或排查 Windows 特有的安装错误时，加载 references/windows-preparation.md。 介绍 Quickstart 前必须完成的 Windows 专属准备步骤。
• 需要了解 Respond to the Onboard Wizard 的详细步骤时，加载 references/quickstart-details.md。

相关技能

• nemoclaw-user-overview — NemoClaw 概览（使用 nemoclaw-user-overview 技能）以了解 NemoClaw 是什么及其功能