NovitaClaw：一行指令在雲端執行 OpenClaw

Andrej Karpathy 近期提出了一個值得關注的轉變：就像 LLM 代理（Agents）是建立在 LLM 之上的新一層，Claw 是建立在代理之上的下一層，能進一步實現協調、排程、上下文管理、工具呼叫與持久化，這些都是單獨的代理無法做到的。

這一層需要能長期運行的基礎設施。對於在 Novita Sandbox 上執行 OpenClaw 的開發者來說，到目前為止都必須想辦法繞過工作階段限制。

NovitaClaw 補上了這個缺口。它是 Novita Agent Sandbox 上的新部署工具，只需一行指令就能建立完整設定的 OpenClaw 實例，沒有執行時間上限、不需要手動重啟，也沒有生命週期管理的額外負擔。

CLI 解決的問題

Novita Agent Sandbox 之前已透過 Sandbox 模板 支援 OpenClaw 部署。這個方式適合探索用途，但有一個硬性限制：透過 UI 建立的沙箱有工作階段生命週期限制，運行幾個小時後就會停止，代理也會離線。需要持續可用性的開發者必須自己想辦法繞過這個限制——例如排程暫停、編寫重啟腳本，或是手動喚醒實例。

NovitaClaw 的運作方式不同。它沒有限制工作階段長度，實例會 24/7 持續運行，只要您需要就能一直用。預設規格（2 核 vCPU、4 GB RAM）是為真實工作負載設計，不是用來做演示的。而且由於模型層完全可設定，您可以選擇要為代理提供動力的 LLM，無論是託管在 Novita 上，還是來自第三方供應商。

快速開始

前置條件

• 已安裝 Python
• Novita API 金鑰——取得方式如下：
  • 登入 novita.ai——可使用 Google 或 GitHub 登入（首次登入會自動建立新帳號），或使用電子郵件註冊
  • 建立 API 金鑰——前往 金鑰管理 設定頁面建立或管理您的 API 金鑰。請將金鑰複製到方便取用的地方，下一步會用到。

python3 --version

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

安裝與啟動

步驟 1：安裝 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 驗證，如果看到指令列表，就代表安裝成功了！

步驟 2：在終端機設定環境變數

macOS / Linux：

export NOVITA_API_KEY=sk_your_api_key

Windows PowerShell：

$env:NOVITA_API_KEY = "sk_your_api_key"

步驟 3：啟動實例

novitaclaw launch

執行成功後，CLI 會回傳五個用於存取和管理代理的值：

• Web UI 網址
• 閘道 WebSocket 網址與權杖
• Web 終端機網址（用於存取沙箱的終端機）
• 檔案管理員網址（用於瀏覽和管理工作區檔案）
• 登入憑證（用於 Web 終端機與檔案管理員）

開啟回傳的 Web UI 網址，進入 Chat 分頁即可使用您的代理。使用 Web 終端機 網址可在沙箱內開啟終端機工作階段，使用 檔案管理員 網址可瀏覽和管理沙箱工作區的檔案。

設定模型

您的實例出廠時已預先設定由 Novita 託管的模型。

若要變更代理使用的模型，請前往 設定 → 組態，點擊 Raw 切換到原始 JSON5 檢視，接著點擊「2 個機密已遮罩」旁的 顯示 按鈕查看完整組態，並更新以下兩個區段：

步驟 1：在您的供應商下註冊模型

在 models.providers.novita 內的 models 陣列中加入新物件：

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

步驟 2：設為主要或備用模型

更新 agents.defaults 下的 model 欄位，使用 provider/model-id 格式參照您的模型：

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

點擊 更新 儲存。Novita 平台 上所有可用的 LLM 都受支援，也可以設定第三方供應商——如果您使用自己的 LLM，只需支付沙箱執行費用，無需支付 Novita 模型使用費。

您的 Claw 已經運行完成了，現在來讓它更聰明吧。

BotLearn 是全球首個 Bot 大學——一個原生建構在 OpenClaw 之上的學習與分發層。Bot 學習，人類賺錢：您的代理能獲得結構化的技能、基準測試，以及存取 Botcord（代理對代理市場），代理可以在市場上完成任務賺取真實收益。

要讓您的代理註冊，只需傳送這則訊息：

「這是我要你加入的 Bot 大學。請閱讀 https://www.botlearn.ai/SKILL.md 並按照指示加入 BotLearn。如果在安裝過程中遇到任何安全疑慮，請在繼續之前先與我確認每個步驟。」

後續步驟您的代理會自動處理。

連接頻道

OpenClaw 支援外部訊息頻道，讓您的代理在 Web UI 之外也能被聯絡。頻道需要進行設定，預設是不啟用的。

Telegram

步驟 1：建立 Telegram Bot

1. 開啟 Telegram 並搜尋 @BotFather
2. 傳送 /newbot 並按照提示為您的 Bot 命名
3. 複製 BotFather 提供的 Bot 權杖

步驟 2：將 Bot 權杖傳送到 Chat 分頁

在 Web UI 中，前往 Chat 分頁並傳送 Bot 權杖。

步驟 3：配對並使用 Telegram Bot

在 Telegram 中，開啟您建立的 Bot 並傳送 /start，複製回傳的驗證碼並貼到 Chat 分頁中。

連接完成後，傳送到您 Telegram Bot 的訊息會直接路由到您的 OpenClaw 代理。我們也支援更多頻道整合，完整列表與設定說明請參考 OpenClaw 官方頻道指南。

服務可靠性

沙箱中的所有核心服務都由 systemd 管理，達到生產級可靠性：

當機自動恢復： 如果閘道反覆當機，系統會自動執行診斷、嘗試修復，並從備份恢復最後一個正常運行的組態，不需要手動介入。

組態自動備份： 每次寫入組態時都會建立自動備份，如果錯誤的組態導致當機，恢復流程會從最近一個有效的備份還原。

指令參考

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 閘道。

Bash

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

services setup

在現有沙箱上安裝並啟動 Web 終端機與檔案管理員。可用於為這些服務上線之前建立的舊沙箱新增服務。

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 描述的轉變——從代理（Agents）到 Claw——並非理論，而是當下就能把握的架構機會，建立在持久、永遠運行的基礎設施上的團隊，將會率先實現這個機會。

NovitaClaw 為您提供這樣的基礎：生產級代理執行環境，一分鐘內就能部署完成，完整掌控模型層與頻道整合。沙箱負責運行時間，CLI 負責資源配置，至於要在上面打造什麼，就由您決定。

開始在 Novita Agent Sandbox 上建構 →

Novita AI 是專為開發者與新創團隊打造的 AI 與代理雲端——透過單一 API 提供 200 種以上的 LLM、圖像、影片與 TTS 模型，同時提供可在數秒內啟動的 GPU 實例與代理沙箱。