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
- Pythonインストーラーをダウンロード
- インストーラーを実行 — 何よりも先に “Add Python to PATH” にチェックを入れてください。これをスキップすると、初心者が後でエラーに遭遇する最も一般的な原因になります
- 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 と入力して確認します。一連の指示が表示されれば成功です!

Macユーザー向けの特別な注意
インストール後に zsh: command not found: novitaclaw エラーが発生した場合は、以下の2つのコマンドを順番に実行して環境パスを修正してください:
source ~/.zshrc
echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc
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用)

返されたWeb UI URLを開き、Chat タブに移動してエージェントを使用します。Web Terminal URLを使用してサンドボックス内でターミナルセッションを開き、File Manager URLを使用してサンドボックスワークスペース内のファイルを参照および管理します。
モデルの設定
インスタンスはデフォルトでNovitaホストモデルが事前設定されています。
エージェントが使用するモデルを変更するには、Settings → Config に移動し、Raw をクリックしてRaw JSON5ビューに切り替え、次に “2 secrets redacted” の横にある reveal ボタンをクリックして完全な設定を表示します。以下の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"
]
}
}
}
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を作成
- Telegramを開き、@BotFather を検索
/newbotを送信し、プロンプトに従ってボットに名前を付けます- 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 AI は、ビルダーやスタートアップ向けのAIおよびエージェントクラウドです。1つのAPIで200以上のLLM、画像、動画、TTSモデルにアクセスできるほか、GPUインスタンスや数秒で起動するAgent Sandboxを提供しています。
