> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# NovitaClaw

[Novita Agent Sandbox](https://novita.ai/sandbox) 上に永続的な OpenClaw エージェントを 1 つのコマンドでデプロイし、CLI、Web UI、または自動化スクリプトから管理できます。セッション上限はありません — インスタンスは必要な限り 24/7 稼働します。

## v1.6.0 の新機能

* **Gateway 設定の Export / Import** — サンドボックス間で OpenClaw 設定をバックアップ、復元、移行できます。stdout またはファイルへ export し、自動 JSON 検証と Gateway の再起動付きで import できます。サンドボックス間の移行ワークフローをサポートします。

```bash Bash icon="terminal" theme={"system"}
# Export config
novitaclaw gateway config export <sandbox_id> -o config.json
# Import into another sandbox
novitaclaw gateway config import <target_id> config.json
```

* **ClawHub Skill Install** — OpenClaw 拡張スキルを ClawHub からサンドボックスへ直接インストールできます。スキルは Gateway の再起動なしですぐに利用できます。

```bash Bash icon="terminal" theme={"system"}
novitaclaw skill install <sandbox_id> sonoscli
```

### 以前のリリース

* **Telegram Channel (CLI)** — エージェントを Telegram に接続するための Polling モードと Webhook モード。[セットアップガイド](/docs/ja/guides/novitaclaw-configuration#telegram)
* **Slack Channel** — エージェントを Slack に接続するための Socket モードと HTTP モード。[セットアップガイド](/docs/ja/guides/novitaclaw-configuration#slack)
* **Install Script の改善** — インストールディレクトリを `~/.novitaclaw-cli` に変更し、PEP 668 サポートと symlink 復旧を備えた `update` コマンドを改善
* **On-Demand Mode** — アイドル状態になるとサンドボックスが自動一時停止し、アクセス時に再開します。一時停止中の請求はありません。[詳細はこちら](/docs/ja/guides/novitaclaw-configuration#on-demand-mode)
* **Feishu Channel** — Webhook または Event モードでエージェントを Feishu (Lark) に接続します。[セットアップガイド](/docs/ja/guides/novitaclaw-configuration#feishu)
* **Web Terminal** — SSH 不要で、ブラウザからサンドボックスのターミナルにアクセス
* **File Manager** — ブラウザからワークスペースファイルを直接参照・管理
* **systemd Service Management** — Gateway、Web Terminal、File Manager は systemd によって完全に管理され、障害時に自動再起動します
* **Crash Auto-Recovery** — クラッシュが繰り返された際の自動診断、修復、サービス復元
* **Config Auto-Backup** — 設定を書き込むたびに自動バックアップを作成し、クラッシュ復旧時には最新の正常なバックアップから復元します

<Tip>
  新機能を使用するには、CLI をアップグレードしてください。

  ```bash macOS / Linux theme={"system"}
  curl -fsSL https://novitaclaw.novita.ai/install.sh | bash
  ```

  ```bash Windows (PowerShell) theme={"system"}
  irm https://novitaclaw.novita.ai/install.ps1 | iex
  ```
</Tip>

## はじめに

### 前提条件

* Python がインストールされていること
* Novita API キー（[Key Management](https://novita.ai/docs/guides/quickstart#2-manage-api-key) でキーを作成/manage）

<Accordion title="Python のインストール方法">
  **Windows**

  [Python インストーラーをダウンロード](https://www.python.org/downloads/)して実行します。Install Now をクリックする前に、必ず **"Add Python to PATH"** にチェックを入れてください — これを省略することが、初心者が後でエラーに遭遇する最も一般的な原因です。

  **macOS**

  Terminal を開いて実行します。

  ```bash Bash icon="terminal" theme={"system"}
  python3 --version
  ```

  Python 3.10 以上が表示されれば問題ありません。Terminal から Command Line Developer Tools のインストールを求められた場合は、Install をクリックして数分待ちます。

  **Linux (Ubuntu / Debian)**

  ```bash Bash icon="terminal" theme={"system"}
  sudo apt update && sudo apt install python3 python3-pip -y
  ```
</Accordion>

### Step 1: NovitaClaw をインストールする

<CodeGroup>
  ```bash macOS / Linux theme={"system"}
  sudo pip3 install novitaclaw
  ```

  ```bash Windows PowerShell theme={"system"}
  pip install novitaclaw
  ```
</CodeGroup>

インストール後、`novitaclaw --help` を実行して確認します。コマンド一覧が表示されれば準備完了です。

<Warning>
  **Mac ユーザー:** インストール後に `zsh: command not found: novitaclaw` が表示された場合は、次を実行してください。

  ```bash Bash icon="terminal" theme={"system"}
  echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```
</Warning>

### Step 2: API キーを設定する

<CodeGroup>
  ```bash macOS / Linux theme={"system"}
  export NOVITA_API_KEY=sk_your_api_key
  ```

  ```powershell Windows PowerShell theme={"system"}
  $env:NOVITA_API_KEY = "sk_your_api_key"
  ```
</CodeGroup>

### Step 3: インスタンスを起動する

```bash Bash icon="terminal" theme={"system"}
novitaclaw launch
```

成功すると、CLI は以下を返します。

* **Web UI URL** — エージェントとチャットするための URL
* **Gateway WebSocket URL & Token** — プログラムからアクセスするための情報
* **Web Terminal URL** — ブラウザでサンドボックスのターミナルにアクセスするための URL
* **File Manager URL** — ワークスペースファイルを参照・管理するための URL
* **ログイン認証情報** — Web Terminal と File Manager のユーザー名とパスワード

<Frame>
  <img src="https://mintcdn.com/novitaai/8g_eTjuhr6h9haCR/ja/guides/images/openclaw-cli/launch-result.png?fit=max&auto=format&n=8g_eTjuhr6h9haCR&q=85&s=0afce4eb1ee1b8c3c293b79eea21970c" alt="NovitaClaw の起動結果" width="1486" height="289" data-path="ja/guides/images/openclaw-cli/launch-result.png" />
</Frame>

返された **Web UI URL** を開き、`Chat` タブに移動してエージェントの使用を開始します。

### Web Terminal

Web Terminal は、ブラウザからサンドボックス環境のターミナルにアクセスする機能を提供します。起動コマンドで返された **Web Terminal URL** を開き、提供された認証情報でログインします。これにより、完全なシェルセッションを利用でき、パッケージのインストール、ログの確認、エージェントの直接デバッグが可能です。

### File Manager

File Manager では、Web インターフェースを通じてサンドボックスのワークスペース内のファイルを参照、アップロード、ダウンロード、管理できます。**File Manager URL** を開き、同じ認証情報でログインします。エージェントのワークスペースファイルの確認、設定の編集、CLI アクセスなしでのファイル転送に使用できます。

<Note>
  これらのサービスが利用可能になる前に起動された既存のサンドボックスについては、後から追加できます。

  ```bash Bash icon="terminal" theme={"system"}
  novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY
  ```
</Note>

## 料金

| 使用するもの             | 支払うもの                                              |
| ------------------ | -------------------------------------------------- |
| Sandbox runtime    | [Sandbox の料金](https://novita.ai/pricing?sandbox=1) |
| Novita-hosted LLMs | [Model の料金](https://novita.ai/pricing)             |
| Third-party LLMs   | Sandbox runtime のみ                                 |