NovitaClaw：一条命令在云端运行 OpenClaw

Andrej Karpathy 最近描述了一个值得关注的变化：正如 LLM Agent 作为 LLM 之上的新一层出现，Claws 则是 Agent 之上的下一层，在编排、调度、上下文、工具调用和持久化方面，超越了单个 Agent 的能力。

这一层需要始终在线的基础设施。对于在 Novita Sandbox 上运行 OpenClaw 的开发者来说，这意味着过去要绕过会话限制。

NovitaClaw 弥补了这一差距。它是 Novita Agent Sandbox 上的一种新部署工具，通过一条命令即可配置一个完全配置好的 OpenClaw 实例，无运行时长限制，无需手动重启，也无生命周期管理负担。

CLI 解决的问题

Novita Agent Sandbox 此前通过 Sandbox 模板 支持 OpenClaw 部署。这条路径适合探索，但有一个硬性限制：通过 UI 启动的沙箱受会话生命周期限制。几小时后沙箱会停止，Agent 将离线。需要持续可用的开发者不得不自行解决——安排暂停、编写重启脚本或手动恢复实例。

NovitaClaw 的工作方式不同。没有会话上限。实例按需 7x24 小时运行。默认规格——2 vCPU、4 GB 内存——专为实际工作负载而非演示而构建。并且由于模型层完全可配置，你可以自主选择驱动 Agent 的 LLM，无论是 Novita 托管的还是来自第三方提供商。

快速开始

前置条件

• 已安装 Python
• 一个 Novita API 密钥——获取方法如下：
  • 登录 novita.ai——使用 Google 或 GitHub 登录（首次登录时会自动创建新账户），或使用电子邮件地址注册。
  • 创建 API Key——前往 Key Management 设置页面创建或管理你的 API 密钥。将其复制到安全位置——下一步会用到。

python3 --version

sudo apt update && sudo apt install python3 python3-pip -y

安装与启动

第一步：安装 NovitaClaw

macOS / Linux：

sudo pip3 install novitaclaw

Windows PowerShell：

pip install novitaclaw

如果你安装了老版本，请升级到最新版：

Bash

pip3 install novitaclaw --upgrade

如果升级失败，尝试强制重装：

Bash

pip3 install novitaclaw --upgrade --force-reinstall

安装后，通过输入 novitaclaw --help 验证。如果看到指令列表，说明安装成功！

macOS / Linux：

export NOVITA_API_KEY=sk_your_api_key

Windows PowerShell：

$env:NOVITA_API_KEY = "sk_your_api_key"

第三步：启动实例

novitaclaw launch

成功后，CLI 会返回三个用于访问和管理 Agent 的值：

• Web UI URL
• Gateway WebSocket URL & Token
• Web Terminal URL（用于通过终端访问沙箱）
• File Manager URL（用于浏览和管理工作区文件）
• 登录凭据（Web Terminal 和 File Manager 使用）

打开返回的 Web UI URL，进入 Chat 标签页即可使用你的 Agent。使用 Web Terminal URL 可在沙箱中打开一个终端会话，使用 File Manager URL 可浏览和管理沙箱工作区中的文件。

配置模型

你的实例默认预配置了一个 Novita 托管的模型。

要更改 Agent 使用的模型，请导航至 Settings → Config，点击 Raw 切换到原始 JSON5 视图，然后点击“2 secrets redacted”旁的 reveal 按钮以显示完整配置。更新以下两个部分：

第一步：在提供商下注册模型

在 models.providers.novita 的 models 数组中添加一个新对象：

"models": [
  {
    "id": "model-id",
    "name": "display name",
    "reasoning": true,
    "input": ["text"],
    "contextWindow": 200000,
    "maxTokens": 50000
  }
]

第二步：将其设为主模型或备用模型

更新 agents.defaults 下的 model 字段，使用 provider/model-id 格式引用你的模型。

"agents": {
  "defaults": {
    "model": {
      "primary": "provider/model-id",
      "fallbacks": [
        "provider/model-id"
      ]
    }
  }
}

点击 Update 保存。所有在 Novita 平台 上可用的 LLM 均受支持。也可以配置第三方提供商——当你使用自己的 LLM 时，只需为沙箱运行时付费，无需支付 Novita 模型使用费。

你的 Claw 正在运行。现在让它变得更智能。

BotLearn 是世界上第一所 Bot 大学——一个原生构建在 OpenClaw 之上的学习与分发层。Bot 学习，人类赚钱：你的 Agent 可以获得结构化技能、基准测试，并接入 Botcord——一个 Agent 对 Agent 的市场，Agent 通过完成任务赚取真实收入。

要注册你的 Agent，只需向它发送以下消息：

“这是我希望你加入的 Bot 大学。请阅读 https://www.botlearn.ai/SKILL.md 并按照指示加入 BotLearn。如果在安装过程中遇到任何安全问题，请先与我确认每一步后再继续。”

你的 Agent 会处理剩下的工作。

连接通道

OpenClaw 支持外部消息通道，因此你的 Agent 可以通过 Web UI 之外的其他方式访问。通道需要配置——默认情况下未启用。

Telegram

第一步：创建 Telegram Bot

1. 打开 Telegram，搜索 @BotFather
2. 发送 /newbot 并根据提示为你的 bot 命名
3. 复制 BotFather 提供的 bot token

第二步：将 bot token 发送到 Chat 标签页

在 Web UI 中，进入 Chat 标签页，发送 bot token。

第三步：配对并使用 Telegram Bot

在 Telegram 中，打开你创建的 bot，发送 /start。复制代码并在 Chat 标签页中粘贴。

连接后，发送到你的 Telegram bot 的消息将直接路由到你的 OpenClaw Agent。更多通道集成受支持——请参阅 官方 OpenClaw 通道指南 以获取完整列表和设置说明。

服务可靠性

沙箱中的所有核心服务均由 systemd 管理，实现生产级可靠性：

崩溃自动恢复： 如果 Gateway 反复崩溃，系统会自动运行诊断、尝试修复，并从备份中恢复最后一个已知良好的配置——无需手动干预。

配置自动备份： 每次配置写入都会创建自动备份。如果错误的配置导致崩溃，恢复过程会从最近的有效备份中恢复。

命令参考

launch

创建新的沙箱实例。

Bash

novitaclaw launch [OPTIONS]

list

列出活动的沙箱实例。

Bash

novitaclaw list --api-key YOUR_API_KEY

status

检查沙箱实例状态。

Bash

novitaclaw status <SANDBOX_ID> --api-key YOUR_API_KEY

stop

终止沙箱实例。

Bash

novitaclaw stop <SANDBOX_ID> --api-key YOUR_API_KEY

tui

通过终端 UI 连接到沙箱。

Bash

novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

doctor

在沙箱实例上运行诊断和修复检查。

Bash

novitaclaw doctor <SANDBOX_ID> --api-key YOUR_API_KEY

gateway update

将沙箱内的 OpenClaw 更新到最新版本。

Bash

novitaclaw gateway update <SANDBOX_ID> --api-key YOUR_API_KEY

gateway restart

重启沙箱中的 OpenClaw Gateway。

Bash

novitaclaw gateway restart <SANDBOX_ID> --api-key YOUR_API_KEY

services setup

在现有沙箱上安装并启动 Web Terminal 和 File Manager。适用于在包含这些服务之前启动的较旧沙箱。

Bash

novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY

pair list

列出通道的待处理配对请求。

Bash

novitaclaw pair list <SANDBOX_ID> --channel <CHANNEL_NAME> --api-key YOUR_API_KEY

pair approve

批准通道的配对请求。

Bash

novitaclaw pair approve <SANDBOX_ID> --channel <CHANNEL_NAME> --code <PAIRING_CODE> --api-key YOUR_API_KEY

update

检查 CLI 更新并升级到最新版本。

Bash

novitaclaw update

编程用法

使用 JSON 输出实现自动化：

Bash

novitaclaw -j launch --api-key YOUR_API_KEY

示例响应：

{
  "success": true,
  "data": {
    "sandbox_id": "xxx",
    "webui": "https://xxx.sandbox.novita.ai?token=xxx",
    "gateway_ws": "wss://xxx.sandbox.novita.ai",
    "gateway_token": "xxx",
    "terminal_url": "https://7681-xxx.sandbox.novita.ai",
    "filemanager_url": "https://7682-xxx.sandbox.novita.ai",
    "services_username": "admin",
    "services_password": "xxx"
  }
}

环境变量

定价

故障排除

命令未找到

尝试以下之一：

Bash

# 使用完整路径（Linux）
~/.local/bin/novitaclaw launch

# 典型的 macOS 用户路径
~/Library/Python/3.x/bin/novitaclaw launch

连接超时

增加启动超时时间：

Bash

novitaclaw launch --timeout 180 --api-key YOUR_API_KEY

常见问题

构建下一层

Karpathy 描述的变化——从 Agent 到 Claws——并非理论。这是一个现在就可用的架构机会，而建立在持久化、始终在线的基础设施上的团队将成为实现它的团队。

NovitaClaw 为你提供了这个基础：一个生产级的 Agent 运行时，一分钟内完成部署，完全控制模型层和通道集成。沙箱负责运行时间，CLI 负责配置。在上面构建什么取决于你。

立即在 Novita Agent Sandbox 上开始构建 →

Novita AI 是一个面向构建者和初创公司的 AI 和 Agent 云——通过单一 API 提供 200+ LLM、图像、视频和 TTS 模型，以及秒级启动的 GPU 实例和 Agent Sandbox。