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

# OpenClaw

[OpenClaw](https://openclaw.ai/) は、お使いのデバイス上で直接動作するパーソナル AI アシスタントです。WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat といった普段お使いのメッセージングプラットフォームに加え、BlueBubbles、Matrix、Zalo、Zalo Personal などの拡張チャネルからも応答します。macOS、iOS、Android では音声での対話が可能で、ユーザーが管理するライブでインタラクティブな Canvas を表示することもできます。Gateway はあくまで制御レイヤーであり、本当のプロダクトはアシスタントそのものです。

## 前提条件

作業を始める前に、以下の環境を準備してください。

* 無料の [SambaCloud](https://cloud.sambanova.ai/?utm_source=openclaw\&utm_medium=external\&utm_campaign=cloud_signup) アカウントと API キー
* [Node.js](https://nodejs.org/en/download) 22.22.3 以上、24.15 以上、25.9 以上、または 26 (推奨)。Node が未インストールの場合は、インストーラースクリプトが自動的にセットアップします。

Node.js のバージョンを確認します。

```bash theme={}
node --version
```

```text theme={}
# Expected output
v26.x.x
```

## セットアップ

<Steps>
  <Step title="OpenClaw のインストール">
    ```bash theme={}
    npm install -g openclaw@latest
    ```

    インストールを確認します。

    ```bash theme={}
    openclaw --version
    ```

    ```text theme={}
    # Expected output
    OpenClaw <version>
    ```

    <Note>
      npm 12 はデフォルトでパッケージのライフサイクルスクリプトをブロックするため、OpenClaw の `preinstall` と `postinstall` の処理がスキップされます。インストール時にスクリプトのブロックが報告された場合は、明示的に許可してください。

      ```bash theme={}
      npm install -g openclaw@latest --allow-scripts openclaw
      ```
    </Note>
  </Step>

  <Step title="OpenClaw の起動">
    ```bash theme={}
    openclaw onboard --install-daemon
    ```

    オンボーディングウィザードが一度だけ実行され、Gateway をバックグラウンドサービスとしてインストールし、ブラウザで Control UI を開きます。クイックスタートの案内に従い、デフォルト設定のまま進めてください。
  </Step>

  <Step title="Control UI の表示">
    Control UI はデフォルトで [http://127.0.0.1:18789](http://127.0.0.1:18789) で提供されます。後で再度開くには、以下を実行します。

    ```bash theme={}
    openclaw dashboard
    ```

    Gateway が稼働していることを確認します。

    ```bash theme={}
    openclaw gateway status
    ```

    出力に `Runtime: running` と `Connectivity probe: ok` が表示されていれば正常です。
  </Step>
</Steps>

## SambaNova をプロバイダーとして追加

<Steps>
  <Step title="SambaNova プロバイダー設定の追加">
    テキストエディタで `~/.openclaw/openclaw.json` を開き、トップレベルのオブジェクトに以下のキーを追加します。`<YOUR-API-KEY>` は、[SambaCloud ポータル](https://cloud.sambanova.ai/apis) で取得した SambaCloud の API キーに置き換えてください。

    ```json theme={}
    "models": {
      "providers": {
        "sambanova": {
          "baseUrl": "https://api.sambanova.ai/v1",
          "apiKey": "<YOUR-API-KEY>",
          "auth": "api-key",
          "api": "openai-completions",
          "models": [
            {
              "id": "MiniMax-M2.7",
              "name": "MiniMax-M2.7",
              "reasoning": true,
              "input": ["text"],
              "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
              "contextWindow": 192000,
              "maxTokens": 16000,
              "compat": { "maxTokensField": "max_tokens" }
            }
          ]
        }
      }
    },
    "agents": {
      "defaults": {
        "model": {
          "primary": "sambanova/MiniMax-M2.7"
        }
      }
    },
    ```

    <Note>
      `~/.openclaw/openclaw.json` は JSON5 形式のため、コメントと末尾カンマが使用できます。設定に `agents` キーがすでに存在する場合は、キーを重複して追加するのではなく、`defaults.model.primary` の値を既存のキーにマージしてください。
    </Note>
  </Step>

  <Step title="設定の検証">
    再起動する前に、ファイルに構文エラーがないことを確認します。

    ```bash theme={}
    openclaw config validate
    ```

    ```text theme={}
    # Expected output
    Config valid: <path>
    ```

    検証に失敗した場合は、ファイルを開いて報告された行を修正してください。よくあるミスは、トップレベルのキー間のカンマ抜けや、波括弧の不一致です。
  </Step>

  <Step title="Gateway の再起動">
    ```bash theme={}
    openclaw gateway restart
    ```
  </Step>

  <Step title="モデル登録の確認">
    ```bash theme={}
    openclaw models list
    ```

    一覧に `sambanova/MiniMax-M2.7` が表示され、Tags 列に `default,configured` と表示されます。
  </Step>

  <Step title="SambaNova モデルの利用開始">
    Control UI の左上のサイドバーからチャットに戻り、メッセージを送信します。チャットで `/model sambanova/MiniMax-M2.7` を実行してモデルを切り替えることもできます。

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/R6yzm_ZM-x1BtCKs/images/docs/integrations/openclaw/openclaw3.png?fit=max&auto=format&n=R6yzm_ZM-x1BtCKs&q=85&s=613f6fa6c757555f22901b471c8ff995" alt="SambaNova のモデルを使用している OpenClaw のチャットインターフェース" style={{ maxWidth:"100%" }} width="2932" height="1690" data-path="images/docs/integrations/openclaw/openclaw3.png" />
    </Frame>
  </Step>
</Steps>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="openclaw.json の編集後に設定の検証が失敗する">
    `openclaw config validate` を実行して、具体的なエラーを確認してください。最も多い原因は、トップレベルの JSON キー間のカンマ抜け、波括弧・角括弧の不一致、編集箇所付近に紛れ込んだ文字です。このファイルは JSON5 形式のため、オブジェクトや配列の内部の末尾カンマは許容されます。問題になるのは通常、トップレベルの兄弟キー間のカンマ抜けです。
  </Accordion>

  <Accordion title="「Model override is not allowed」と表示される">
    `agents.defaults.modelPolicy.allow` が設定されている場合、すべてのモデル選択に対する許可リスト (allowlist) として機能します。このリストに `sambanova/MiniMax-M2.7` またはワイルドカード `sambanova/*` を追加するか、リスト自体を削除して任意のモデルを許可してください。
  </Accordion>

  <Accordion title="「Model not found」と表示される">
    OpenClaw のモデル参照は `provider/model` 形式のため、常に `sambanova/MiniMax-M2.7` を使用してください。`openclaw models list` を実行し、フラグ列に `configured` が付いた状態でモデルが表示されることを確認します。表示されない場合は、`models.providers.sambanova` ブロックが正しく追加されていること、および編集後に `openclaw gateway restart` を実行したことを確認してください。
  </Accordion>

  <Accordion title="SambaNova からの認証エラー">
    `~/.openclaw/openclaw.json` の `models.providers.sambanova` 配下の `apiKey` に、[SambaCloud ポータル](https://cloud.sambanova.ai/apis) で取得した有効なキーが設定されていることを確認してください。設定を編集したら、`openclaw config validate` を実行してから `openclaw gateway restart` を実行し、`openclaw models status` で確認します。
  </Accordion>

  <Accordion title="npm がライフサイクルスクリプトのブロックを報告する">
    npm 12 はデフォルトでパッケージのライフサイクルスクリプトをブロックするため、OpenClaw の `preinstall` と `postinstall` の処理がスキップされます。`npm install -g openclaw@latest --allow-scripts openclaw` で再インストールしてください。
  </Accordion>

  <Accordion title="Control UI が開かない">
    `openclaw dashboard` を実行して再度開くか、ブラウザで [http://127.0.0.1:18789](http://127.0.0.1:18789) に直接アクセスしてください。`openclaw gateway status` で Gateway が稼働していることを確認し、設定に問題がある場合は `openclaw doctor` を実行してください。
  </Accordion>
</AccordionGroup>

## 参考情報

* [OpenClaw ドキュメント](https://docs.openclaw.ai/)
* [OpenClaw のモデルプロバイダー](https://docs.openclaw.ai/concepts/model-providers)
* [OpenClaw の設定リファレンス](https://docs.openclaw.ai/gateway/configuration-reference)
* [SambaCloud のモデル](/docs/ja/models/sambacloud-models)
* [SambaCloud API リファレンス](/docs/ja/api-reference/overview)