nemoclaw-deploy

安装/onboard NemoClaw，并向 sandbox 部署一个或多个 OpenClaw agent。

快速开始

要求：Node.js >= 20。

1. 安装 CLI

npm install -g @advantech-axa/nemoclaw-deploy

2. 生成配置

nemoclaw-deploy init-onboard-config --output onboard.yaml
nemoclaw-deploy init-config --output deploy.yaml

会生成两份文件：

• onboard.yaml：安装 NemoClaw、创建或恢复 sandbox。
• deploy.yaml：向 sandbox 部署一个或多个 agent。

3. 修改配置

先确认两份文件使用同一个 sandbox 名称：

# onboard.yaml
onboard:
  sandbox:
    name: demo

# deploy.yaml
sandboxName: demo

然后在 deploy.yaml 中修改 agent 名称和内容目录：

agents:
  - name: my-agent
    agentContent:
      enabled: true
      hostDir: ./agent-content

不需要的功能直接设置 enabled: false。其他字段可以先保持模板默认值。

4. 执行

先查看计划：

nemoclaw-deploy up --dry-run

确认无误后执行：

nemoclaw-deploy up

如果部署目录里同时放了 onboard.yaml、deploy.yaml 和 install-and-up.sh，也可以直接用脚本启动。脚本会先检查 Node.js，缺少满足要求的版本时用 nvm 安装，再安装 @advantech-axa/nemoclaw-deploy 并执行 up：

chmod +x install-and-up.sh
./install-and-up.sh

预览计划：

./install-and-up.sh --dry-run

首次运行时，如果本机没有 NemoClaw，CLI 会执行官方安装命令并进入官方 onboard 向导：

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

按照向导选择 provider、model 等配置即可。完成后 CLI 会继续部署 deploy.yaml 中的 agents。

部署多个 agent

在 deploy.yaml 的 agents 下增加条目：

agents:
  - name: research-agent
    workspace: ""
    agentContent:
      enabled: true
      hostDir: ./agents/research
      conflictStrategy: ask
    skill:
      enabled: true
      hostDir: ./agents/research-skills

  - name: operations-agent
    workspace: ""
    agentContent:
      enabled: true
      hostDir: ./agents/operations
      conflictStrategy: ask
    skill:
      enabled: true
      hostDir: ./agents/operations-skills

每个 agent 应使用不同的 name、workspace 和 hostDir。workspace 留空时自动生成。

agents[] 下的 skill、agentContent、env 和 dependencies 属于单个 agent；shared 下的 plugins、tools、channel 和 network policy 对所有 agents 共享，只执行一次；gateway 也只在最后重启一次。

配置文件里的相对路径按 deploy.yaml 所在目录解析，除非显式写绝对路径。

常用命令

# 完整流程：安装/onboard + 部署 agents
nemoclaw-deploy up

# 指定配置文件
nemoclaw-deploy up \
  --onboard-config onboard.yaml \
  --deploy-config deploy.yaml

# 只安装/onboard，确保 sandbox 可用
nemoclaw-deploy bootstrap --config onboard.yaml

# 只部署 agents，不执行安装和 onboard
nemoclaw-deploy deploy --config deploy.yaml

# 检查环境和 sandbox
nemoclaw-deploy doctor
nemoclaw-deploy doctor --sandbox demo

onboard 恢复

修改 onboard.yaml 中的 mode：

onboard:
  mode: ensure

• ensure：sandbox 可用就跳过，否则正常 onboard。默认推荐。
• resume：继续上次未完成的 onboard。
• fresh：放弃上次进度，重新 onboard。
• recreate：明确重建已有 sandbox，请谨慎使用。

非交互运行

在 onboard.yaml 中填写 provider，并接受第三方软件声明：

onboard:
  inference:
    provider: ollama

  options:
    acceptThirdPartySoftware: true

然后执行：

nemoclaw-deploy up --non-interactive

安全提示

• 不要把 API key、token 或 password 写入 YAML。
• Secret 请通过环境变量或官方 onboard 安全输入提示提供。
• agentContent.conflictStrategy: ask 在非交互模式下会自动按 fail 处理。
• --dry-run 不会执行安装、onboard 或部署命令。
• 旧版单 agent deploy.yaml 仍可使用，但建议迁移到 agents 列表。

配置字段的详细说明直接查看生成的 onboard.yaml 和 deploy.yaml 模板。Python workspace 说明见 docs/PYTHON_WORKSPACE.md。