NemoClaw

关于 NemoClaw

NemoClaw 是 OpenClaw 针对 NVIDIA OpenShell 的插件，将 OpenClaw 移入沙箱环境。

核心优势

典型用例

工作原理

NemoClaw 结合轻量级 CLI 插件和版本化蓝图，将 OpenClaw 移入受控沙箱。

蓝图生命周期

推理路由

保护层

快速开始

按照以下步骤启动您的第一个沙箱化 OpenClaw 代理。

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

──────────────────────────────────────────────────
Sandbox      my-assistant (Landlock + seccomp + netns)
Model        nvidia/nemotron-3-super-120b-a12b (NVIDIA Cloud API)
──────────────────────────────────────────────────
Run:         nemoclaw my-assistant connect
Status:      nemoclaw my-assistant status
Logs:        nemoclaw my-assistant logs --follow
──────────────────────────────────────────────────

[INFO]  === Installation complete ===

$ nemoclaw my-assistant connect

sandbox@my-assistant:~$ openclaw tui

sandbox@my-assistant:~$ openclaw agent --agent main --local -m "hello" --session-id test

推理配置

推理请求永远不会直接离开沙箱。OpenShell 拦截每个调用并路由到 NVIDIA 云提供者。

切换推理模型

在沙箱运行时更改活动推理模型，无需重启：

$ openshell inference set --provider nvidia-nim --model nvidia/nemotron-3-super-120b-a12b

网络策略

沙箱以严格的基线策略启动。仅允许策略中列出的端点。未知主机被阻止并显示给操作员审批。

操作员审批流程

打开 TUI 监控沙箱活动：

$ openshell term

$ nemoclaw onboard

$ openshell policy set <policy-file>

远程部署

通过 Brev 在远程 GPU 实例上运行 NemoClaw。

$ nemoclaw deploy <instance-name>

部署脚本在 VM 上执行以下步骤：

1. 安装 Docker 和 NVIDIA Container Toolkit（如果存在 GPU）
2. 安装 OpenShell CLI
3. 运行 nemoclaw 设置以创建网关、注册提供商并启动沙箱
4. 启动辅助服务（Telegram 桥接、cloudflared 隧道）

配置 GPU 类型：

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

Telegram 桥接

在 Telegram 机器人和沙箱内运行的 OpenClaw 代理之间转发消息。

$ export TELEGRAM_BOT_TOKEN=<your-bot-token>

$ nemoclaw start

$ export ALLOWED_CHAT_IDS="123456789,987654321"
$ nemoclaw start

监控

使用 NemoClaw 状态、日志和 TUI 工具检查沙箱健康状况、跟踪代理行为并诊断问题。

$ openclaw nemoclaw status

$ openclaw nemoclaw logs -f

$ openshell term

架构

NemoClaw 由 TypeScript 插件和 Python 蓝图两个主要组件构成。

nemoclaw/
├── src/
│   ├── index.ts          // 插件入口
│   ├── cli.ts            // 子命令接线
│   ├── commands/
│   │   ├── launch.ts     // 全新安装到 OpenShell
│   │   ├── connect.ts    // 交互式 shell
│   │   ├── status.ts     // 运行状态 + 健康状况
│   │   ├── logs.ts       // 流式日志
│   │   └── slash.ts      // /nemoclaw 聊天命令
│   └── blueprint/
│       ├── resolve.ts    // 版本解析
│       ├── fetch.ts      // 从 OCI 注册表下载
│       ├── verify.ts     // 摘要验证
│       ├── exec.ts       // 子进程执行
│       └── state.ts      // 持久状态
├── openclaw.plugin.json
└── package.json

nemoclaw-blueprint/
├── blueprint.yaml        // 清单
├── orchestrator/
│   └── runner.py         // CLI 运行器
└── policies/
    └── openclaw-sandbox.yaml  // 基线策略

命令参考

NemoClaw 提供插件命令（openclaw nemoclaw）和独立主机命令（nemoclaw）两个接口。

主机命令

插件命令

推理配置文件

NemoClaw 附带在 blueprint.yaml 中定义的推理配置文件。

$ openshell inference set --provider nvidia-nim --model <model-name>

网络策略参考

基线策略定义在 nemoclaw-blueprint/policies/openclaw-sandbox.yaml 中。

文件系统

默认允许的端点

所有端点使用 TLS 终止并在端口 443 强制执行。