NovitaClaw:只需一条命令即可在云端运行 OpenClaw

novitaclaw

安德烈·卡帕西最近描述了一种值得关注的转变:正如 LLM 代理人作为一层新成员出现在……之上 LLMs,Claws 是代理之上的下一层,它将编排、调度、上下文、工具调用和持久性提升到代理本身无法企及的高度。

这一层需要持续运行的基础设施。对于在 Novita Sandbox 上运行 OpenClaw 的开发者来说,这意味着他们此前一直需要绕过会话限制。

NovitaClaw 填补了这一空白。它是一款全新的部署工具。 Novita 代理沙盒 只需一条命令即可配置一个完全配置好的 OpenClaw 实例,没有运行时间限制,无需手动重启,也没有生命周期管理开销。

CLI解决的问题

Novita Agent Sandbox 通过以下方式支持 OpenClaw 部署: 沙盒模板这条路径适合探索,但它存在一个硬性限制:通过用户界面启动的沙箱会话生命周期有限。几个小时后,沙箱就会停止运行,代理也会离线。需要持续可用性的开发人员不得不自行解决这个问题——例如安排暂停、编写重启脚本或手动恢复实例。

NovitaClaw 的工作方式不同。它没有会话上限。实例全天候运行,满足您的所有需求。默认配置(2 个 vCPU,4 GB 内存)专为实际工作负载而设计,而非演示。而且,由于模型层完全可配置,您可以选择…… LLM无论代理托管在 Novita 上还是来自第三方提供商,它都能为您的代理提供支持。

新会员入门指南

硬件需求

  • 安装了Python
  • Novita API 密钥——获取方法如下:
    • 使用您的FSUID和密码登录页面 novita.ai — 使用 Google 或 GitHub 帐户登录(首次登录时会自动创建一个新帐户),或者使用您的电子邮件地址注册
    • 创建 API 密钥 — 前往 密钥管理 设置页面用于创建或管理您的 API 密钥。请将其复制到方便取用的地方——下一步您将需要用到它。
如何安装 Python

Windows

  1. 下载 Python 安装程序
  2. 运行安装程序 — 勾选“将 Python 添加到 PATH” 在点击任何其他内容之前。跳过这一步是新手日后出错的最常见原因。
  3. 点击 立即安装 然后等待“设置成功”消息。
macos

打开终端(Command + Space搜索“终端”,然后运行:

python3 --version

如果你看到 Python 3.10 如果版本较低,或者终端提示您安装命令行开发者工具,请点击 安装 稍等几分钟后再继续。

Linux(Ubuntu/Debian)

如果你使用的是基于 Debian 的发行版,请运行:

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

安装并启动

步骤 1:安装 NovitaClaw

macOS / Linux:

sudo pip3 install novitaclaw

Windows PowerShell:

pip install novitaclaw

如果您已安装旧版本,请升级到最新版本:

pip3 install novitaclaw --upgrade

如果升级失败,请尝试强制重新安装:

pip3 install novitaclaw --upgrade --force-reinstall

安装完成后,请键入以下命令进行验证 novitaclaw --help如果看到操作说明列表,说明你成功了!

novitaclaw --帮助
Mac 用户特别说明

如果你得到一个 zsh: command not found: novitaclaw 安装后出现错误,请运行以下两条命令来修复环境变量路径:

source ~/.zshrc

echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc

步骤 2:在终端中设置环境变量

macOS / Linux:

export NOVITA_API_KEY=sk_your_api_key

Windows PowerShell:

$env:NOVITA_API_KEY = "sk_your_api_key"

步骤 3:启动实例

novitaclaw 上市

成功后,CLI 将返回三个值,您可以使用这些值来访问和管理您的代理:

  • Web UI URL
  • 网关 WebSocket URL 和令牌
  • Web终端URL(用于终端访问沙箱)
  • 文件管理器 URL(用于浏览和管理工作区文件)
  • 登录凭证(用于 Web 终端和文件管理器)
OpenClaw 屏幕截图

打开返回的 Web UI URL 并转到该 URL。 Chat 使用选项卡来使用您的代理。使用 网络终端 用于在沙箱内打开终端会话的 URL,以及 文件管理器 用于浏览和管理沙盒工作区中文件的 URL。

配置模型

您的实例已预先配置了 Novita 托管模型。

要更改代理使用的模型,请导航至 设置 → 配置,单击“ 要切换到原始 JSON5 视图,请单击 揭示 点击“已隐藏 2 个密钥”旁边的按钮,即可显示完整配置。请更新以下两个部分:

OpenClaw 模型配置

步骤 1:在您的服务提供商处注册模型

向……添加一个新对象 models 数组内部 models.providers.novita:

"models": [ { "id": "模型 ID", "name": "显示名称", "reasoning": true, "input": ["文本"], "contextWindow": 200000, "maxTokens": 50000 } ]

步骤 2:将其设置为主要或备用

更新 model 场下 agents.defaults 使用以下方式引用您的模型 provider/model-id 格式。

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

点击 更新 为了节省。每一个 LLM 可用 Novita平台 支持。也可以配置第三方供应商——当您自带设备时。 LLM您只需为沙盒运行时付费,无需为 Novita 模型的使用付费。

你的机械爪正在运行。现在让它更智能。

BotLearn 是全球首个机器人大学——一个基于 OpenClaw 原生构建的学习和分发层。机器人学习,人类赚钱:您的代理获得结构化技能、基准测试,并可访问 Botcord,这是一个代理对代理市场,代理可以通过完成任务赚取真金白银。

要注册您的代理人,只需向其发送此消息:

这就是我希望你加入的机器人大学。阅读 https://www.botlearn.ai/SKILL.md 请按照说明加入 BotLearn。如果在安装过程中遇到任何安全问题,请在继续操作前与我确认每个步骤。

剩下的事情由您的经纪人处理。

连接通道

OpenClaw 支持外部消息通道,因此您的代理程序可以通过 Web UI 以外的方式访问。消息通道需要配置,默认情况下未启用。

Telegram

第一步:创建 Telegram 机器人

  1. 打开 Telegram 并搜索 @机器人之父
  2. 发送 /newbot 然后按照提示为你的机器人命名。
  3. 复制 BotFather 提供的机器人令牌

步骤 2:将机器人令牌发送到聊天选项卡

在 Web 用户界面中,转到 在线聊天 按下按钮并发送机器人令牌。

步骤 3:配对并使用 Telegram 机器人

在 Telegram 中,打开你创建的机器人并发送 /start复制代码并粘贴到 在线聊天 标签。

连接成功后,发送到 Telegram 机器人的消息将直接路由到您的 OpenClaw 代理。我们还支持更多渠道集成——请参阅…… OpenClaw 官方频道指南 完整列表和设置说明请见此处。


服务可靠性

沙箱中的所有核心服务均由 systemd 管理,以确保生产级别的可靠性:

Service描述自动重启
OpenClaw 网关代理运行时和 WebSocket 服务器
网络终端(ttyd)基于浏览器的终端访问
文件管理器(gohttpserver)基于Web的文件管理

崩溃自动恢复: 如果网关反复崩溃,系统会自动运行诊断程序,尝试修复,并从备份中恢复上次已知的良好配置——无需人工干预。

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

命令参考

launch

创建一个新的沙盒实例。

novitaclaw 启动 [选项]
附加选项描述
--api-keyNovita API 密钥
--gateway-token自定义网关令牌(可选,默认自动生成)
--timeout创建超时时间(秒)(默认值: 60)

list

列出所有活动的沙箱实例。

novitaclaw list --api-key YOUR_API_KEY
附加选项描述
--api-keyNovita API 密钥
--quiet-q仅打印沙箱 ID,每行一个(便于编写脚本)

status

检查沙箱实例状态。

novitaclaw 状态--api-key 您的 API 密钥

stop

终止沙箱实例。

novitaclaw 停止--api-key 您的 API 密钥
附加选项描述
--api-keyNovita API 密钥
--yes-y跳过确认提示

tui

通过终端界面连接到沙箱。

novitaclaw tui --token

doctor

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

novitaclaw 医生--api-key 您的 API 密钥
附加选项描述
--api-keyNovita API 密钥
--deep扫描系统服务,查找额外的网关安装。
--fix应用推荐的维修方案(别名) --repair)
--force执行彻底修复(覆盖自定义服务配置)
--generate-gateway-token生成并配置网关令牌
--no-workspace-suggestions禁用工作区内存系统建议
--repair无需提示即可应用建议的维修方案。
--yes接受默认设置,无需提示。

gateway update

在沙盒环境中将 OpenClaw 更新到最新版本。

novitaclaw 网关更新--api-key 您的 API 密钥
附加选项描述
--api-keyNovita API 密钥
--restart更新后重启网关

gateway restart

在沙箱环境中重启 OpenClaw 网关。

novitaclaw 网关重启--api-key 您的 API 密钥

services setup

在现有沙箱中安装并启动 Web 终端和文件管理器。使用此功能可将服务添加到在这些服务包含在内之前启动的旧沙箱中。

novitaclaw 服务设置--api-key 您的 API 密钥

pair list

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

novitaclaw 配对列表 - 渠道--api-key 您的 API 密钥

pair approve

批准通道的配对请求。

novitaclaw 一对批准 - 渠道 - 代码--api-key 您的 API 密钥

update

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

novitaclaw 更新

程序化使用

使用 JSON 输出进行自动化:

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" } }

环境变量

请按需咨询描述
NOVITA_API_KEYAPI密钥,无需 --api-key
OPENCLAW_GATEWAY_TOKEN预设网关令牌

定价

你使用什么你的付款
沙盒运行时沙盒利率
Novita主办 LLMs模型利率
第三方 LLMs仅限沙盒运行时

故障排除

没有找到指令

尝试以下方法之一:

# 使用完整路径(Linux)~/.local/bin/novitaclaw launch # 典型的 macOS 用户路径 ~/Library/Python/3.x/bin/novitaclaw launch

连接超时

增加启动超时时间:

novitaclaw 启动 --timeout 180 --api-key YOUR_API_KEY

常見問題解答

市场问题为什么会这样呢?该怎么办
“未找到命令”/“无法识别”在安装 Python 时,您没有勾选“添加到 PATH”。卸载 Python 并重新安装,务必勾选 PATH 复选框!
“没有权限”你没有足够的权限。Windows 系统:右键单击“终端/PowerShell”,然后选择“以管理员身份运行”。Mac 系统:在命令前添加 sudo。
“无效的 API 密钥”密钥复制错误。检查 sk_ 字符串前后是否有多余的空格,如果有,则生成一个新的空格。
沙盒不会停止停止沙盒会删除所有文件,并且需要确认。当终端提示确认删除时,输入“y”。
Mac:未找到 pip 命令Mac 使用 pip3 来区别于旧版本。请使用 pip3 install novitaclaw 而不是 pip。

构建下一层

卡帕西所描述的转变——从从 ts 到 Claws——这并非纸上谈兵。这是一个现成的架构机遇,而那些构建持久化、始终在线基础设施的团队将会实现这一机遇。

NovitaClaw 为您提供这样的基础:一个生产级的代理运行时环境,部署只需不到一分钟,并可完全控制模型层和通道集成。沙箱负责正常运行时间,CLI 负责配置。至于在此基础上构建什么,则完全取决于您。

开始在 Novita Agent Sandbox 上构建 →

Novita AI 是一个面向开发者和初创公司的AI和智能体云平台,提供对200多个人工智能和智能体的访问权限。 LLM通过一个 API 即可支持图像、视频和 TTS 模型,以及其他功能。 GPU 实例和代理沙箱可在几秒钟内启动。


探索 Novita 的更多内容

订阅即可将最新帖子发送到您的电子邮箱。

发表评论

滚动到顶部

探索 Novita 的更多内容

立即订阅以继续阅读并访问完整档案。

继续阅读