NovitaClaw: 1つのコマンドでOpenClawをクラウド上で実行

NovitaClaw: 1つのコマンドでOpenClawをクラウド上で実行

Andrej Karpathy氏は最近、注目に値する変化を指摘しました。LLMエージェントがLLMの上に新しいレイヤーとして登場したように、Clawはエージェントの上に次のレイヤーとして位置づけられ、オーケストレーション、スケジューリング、コンテキスト、ツール呼び出し、永続性をエージェント単独では不可能なレベルまで拡張します。

そのレイヤーには、常時稼働するインフラが必要です。Novita Sandbox上でOpenClawを実行している開発者は、これまでセッション制限に対処する必要がありました。

NovitaClawはそのギャップを埋めます。これはNovita Agent Sandbox向けの新しいデプロイツールで、完全に構成されたOpenClawインスタンスを1つのコマンドでプロビジョニングします。ランタイム上限なし、手動再起動不要、ライフサイクル管理のオーバーヘッドもありません。

CLIが解決する問題

Novita Agent Sandboxは、Sandbox Templateを通じてOpenClawのデプロイをサポートしてきました。この方法は試用には適していますが、厳しい制約があります。UIから起動したサンドボックスにはセッションのライフサイクル制限があり、数時間後にサンドボックスが停止し、エージェントがオフラインになります。継続的な可用性が必要な開発者は、自分でスケジュールを調整したり、再起動をスクリプト化したり、手動でインスタンスを復活させたりする必要がありました。

NovitaClawは異なる動作をします。セッション上限はありません。インスタンスは必要な限り24時間365日稼働します。デフォルトのスペック(2 vCPU、4 GB RAM)はデモではなく実際のワークロード向けに設計されています。また、モデルレイヤーは完全に設定可能で、NovitaでホストされているLLMでも、サードパーティプロバイダーから調達したLLMでも、エージェントを動かすモデルを自由に選択できます。

はじめに

前提条件

  • Pythonがインストールされていること
  • Novita APIキー — 取得方法は以下の通りです:
    • novita.aiにログイン — GoogleまたはGitHubでサインイン(初回ログイン時に自動的に新しいアカウントが作成されます)、またはメールアドレスでサインアップ
    • APIキーを作成Key Management設定ページに移動してAPIキーを作成または管理します。次のステップで必要になるので、安全な場所にコピーしておいてください。
Pythonのインストール方法

Windows

  1. Pythonインストーラーをダウンロード
  2. インストーラーを実行 — 何よりも先に “Add Python to PATH” にチェックを入れてください。これをスキップすると、初心者が後でエラーに遭遇する最も一般的な原因になります
  3. Install Now をクリックし、“Setup was successful” のメッセージを待ちます
macOS

ターミナルを開き(Command + Space で “Terminal” を検索)、以下を実行します:

python3 --version

Python 3.10 以上と表示されれば準備完了です。バージョンが古い場合、またはターミナルがCommand Line Developer Toolsのインストールを促す場合は、Install をクリックし、数分待ってから続行してください。

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

以前のバージョンがインストールされている場合は、最新バージョンにアップグレードします:

Bash

pip3 install novitaclaw --upgrade

アップグレードが失敗した場合は、強制再インストールを試みてください:

Bash

pip3 install novitaclaw --upgrade --force-reinstall

インストール後、novitaclaw --help と入力して確認します。一連の指示が表示されれば成功です!

novitaclaw --help

Macユーザー向けの特別な注意

インストール後に zsh: command not found: novitaclaw エラーが発生した場合は、以下の2つのコマンドを順番に実行して環境パスを修正してください:

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 launch

成功すると、CLIはエージェントへのアクセスと管理に使用する3つの値を返します:

  • Web UI URL
  • Gateway WebSocket URL & Token
  • Web Terminal URL(サンドボックスへのターミナルアクセス用)
  • File Manager URL(ワークスペースファイルの参照と管理用)
  • ログイン認証情報(Web Terminal & File Manager用)

openclaw screenshoot

返されたWeb UI URLを開き、Chat タブに移動してエージェントを使用します。Web Terminal URLを使用してサンドボックス内でターミナルセッションを開き、File Manager URLを使用してサンドボックスワークスペース内のファイルを参照および管理します。

モデルの設定

インスタンスはデフォルトでNovitaホストモデルが事前設定されています。

エージェントが使用するモデルを変更するには、Settings → Config に移動し、Raw をクリックしてRaw JSON5ビューに切り替え、次に “2 secrets redacted” の横にある reveal ボタンをクリックして完全な設定を表示します。以下の2つのセクションを更新します:

openclaw model configure

ステップ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"
      ]
    }
  }
}

Update をクリックして保存します。Novitaプラットフォームで利用可能なすべてのLLMがサポートされています。サードパーティのプロバイダーも設定可能です。独自のLLMを使用する場合、サンドボックスのランタイムのみが課金され、Novitaモデルの使用料は発生しません。

Clawが稼働しています。次は、よりスマートにしましょう。

BotLearn は世界初のBot Universityです。OpenClaw上にネイティブに構築された学習と配信のレイヤーです。ボットが学び、人間が稼ぐ:エージェントは構造化されたスキル、ベンチマーク、そしてエージェントがタスクを完了して実際のお金を稼ぐAgent-to-AgentマーケットプレイスであるBotcordにアクセスできます。

エージェントを登録するには、次のメッセージを送信するだけです:

“これはあなたに参加してほしいBot Universityです。https://www.botlearn.ai/SKILL.md を読み、指示に従ってBotLearnに参加してください。インストール中にセキュリティ上の懸念が生じた場合は、各ステップを私に確認してから進めてください。”

エージェントが残りを処理します。

チャンネルの接続

OpenClawは外部メッセージングチャンネルをサポートしており、エージェントがWeb UIの外でもアクセス可能になります。チャンネルは設定が必要です。デフォルトでは有効になっていません。

Telegram

ステップ1: Telegram Botを作成

  1. Telegramを開き、@BotFather を検索
  2. /newbot を送信し、プロンプトに従ってボットに名前を付けます
  3. BotFatherが提供するボットトークンをコピー

ステップ2: Chatタブにボットトークンを送信

Web UIで Chat タブに移動し、ボットトークンを送信します。

ステップ3: Telegram Botをペアリングして使用

Telegramで、作成したボットを開き、/start を送信します。コードをコピーし、Chat タブに貼り付けます。

接続されると、Telegramボットに送信されたメッセージは直接OpenClawエージェントにルーティングされます。さらに多くのチャンネル統合がサポートされています。完全なリストと設定手順については、公式OpenClawチャンネルガイドを参照してください。

サービスの信頼性

サンドボックス内のすべてのコアサービスは、本番環境向けの信頼性を備えたsystemdで管理されています:

サービス 説明 自動再起動
OpenClaw Gateway エージェントランタイムとWebSocketサーバー
Web Terminal (ttyd) ブラウザベースのターミナルアクセス
File Manager (gohttpserver) Webベースのファイル管理

クラッシュ自動復旧: Gatewayが繰り返しクラッシュした場合、システムは自動的に診断を実行し、修復を試み、バックアップから最後に正常だった設定を復元します。手動介入は不要です。

設定自動バックアップ: 設定が書き込まれるたびに自動バックアップが作成されます。不良な設定がクラッシュを引き起こした場合、復旧プロセスは最新の有効なバックアップから復元します。

コマンドリファレンス

launch

新しいサンドボックスインスタンスを作成します。

Bash

novitaclaw launch [OPTIONS]
オプション 説明
--api-key Novita APIキー
--gateway-token カスタムゲートウェイトークン(オプション、デフォルトで自動生成)
--timeout 作成タイムアウト(秒単位、デフォルト: 60

list

アクティブなサンドボックスインスタンスを一覧表示します。

Bash

novitaclaw list --api-key YOUR_API_KEY
オプション 説明
--api-key Novita APIキー
--quiet, -q サンドボックスIDのみを1行に1つ表示(スクリプトに便利)

status

サンドボックスインスタンスのステータスを確認します。

Bash

novitaclaw status <SANDBOX_ID> --api-key YOUR_API_KEY

stop

サンドボックスインスタンスを終了します。

Bash

novitaclaw stop <SANDBOX_ID> --api-key YOUR_API_KEY
オプション 説明
--api-key Novita APIキー
--yes, -y 確認プロンプトをスキップ

tui

ターミナルUIを介してサンドボックスに接続します。

Bash

novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

doctor

サンドボックスインスタンスの診断と修復チェックを実行します。

Bash

novitaclaw doctor <SANDBOX_ID> --api-key YOUR_API_KEY
オプション 説明
--api-key Novita APIキー
--deep 追加のゲートウェイインストールのためにシステムサービスをスキャン
--fix 推奨される修復を適用(--repair のエイリアス)
--force 強力な修復を適用(カスタムサービス設定を上書き)
--generate-gateway-token ゲートウェイトークンを生成して設定
--no-workspace-suggestions ワークスペースメモリシステムの提案を無効化
--repair プロンプトなしで推奨される修復を適用
--yes プロンプトなしでデフォルトを受け入れる

gateway update

サンドボックス内のOpenClawを最新バージョンに更新します。

Bash

novitaclaw gateway update <SANDBOX_ID> --api-key YOUR_API_KEY
オプション 説明
--api-key Novita APIキー
--restart 更新後にゲートウェイを再起動

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

環境変数

変数 説明
NOVITA_API_KEY APIキー。--api-key フラグを不要にします
OPENCLAW_GATEWAY_TOKEN プリセットゲートウェイトークン

料金

使用するもの 支払うもの
サンドボックスランタイム サンドボックス料金
NovitaホストLLM モデル料金
サードパーティLLM サンドボックスランタイムのみ

トラブルシューティング

コマンドが見つからない

以下のいずれかを試してください:

Bash

# フルパスを使用(Linux)
~/.local/bin/novitaclaw launch

# 一般的なmacOSユーザーパス
~/Library/Python/3.x/bin/novitaclaw launch

接続タイムアウト

起動タイムアウトを増やします:

Bash

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

よくある質問

問題 原因 対処法
“Command not found” / “Not recognized” Pythonインストール時に “Add to PATH” にチェックを入れなかった。 Pythonをアンインストールし、PATHにチェックを入れて再インストールしてください!
“Permission Denied” 権限が不足している。 Windows: ターミナル/PowerShellを右クリックし、“管理者として実行”。Mac: コマンドの前にsudoを追加。
“Invalid API Key” キーが正しくコピーされていない。 sk_ 文字列の前後に余分なスペースがないか確認するか、新しいキーを生成してください。
サンドボックスが停止しない サンドボックスを停止するとすべてのファイルが削除され、確認が必要。 確認プロンプトが表示されたら、ターミナルで “y” と入力して削除を確認してください。
Mac: pip command not found Macでは古いバージョンと区別するためにpip3を使用する。 pip ではなく pip3 install novitaclaw を使用してください。

次のレイヤーを構築する

Karpathy氏が説明するシフト — エージェントからClawへ — は理論上のものではありません。これは今すぐ利用可能なアーキテクチャ上の機会であり、永続的で常時稼働するインフラ上に構築するチームこそがそれを実現するでしょう。

NovitaClawはその基盤を提供します:本番環境向けのエージェントランタイム、1分未満でデプロイ、モデルレイヤーとチャンネル統合を完全に制御可能。サンドボックスがアップタイムを処理し、CLIがプロビジョニングを処理します。その上に何を構築するかはあなた次第です。

Novita Agent Sandboxで構築を始める →

Novita AI は、ビルダーやスタートアップ向けのAIおよびエージェントクラウドです。1つのAPIで200以上のLLM、画像、動画、TTSモデルにアクセスできるほか、GPUインスタンスや数秒で起動するAgent Sandboxを提供しています。