> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenClaw
> OpenClawをインストールし、MixRoute APIに接続して、セルフホストのAIアシスタントを構築します
## はじめに
OpenClawは、メッセージングアプリと自分のハードウェア上で実行するAIエージェントを接続する、オープンソースのセルフホスト型パーソナルAIアシスタントプラットフォームです。開発者や上級ユーザー向けに設計されており、データの管理権を手放すことなく、自分専用の自律型AIアシスタントを利用できます。
* **GitHub**：[https://github.com/openclaw/openclaw](https://github.com/openclaw/openclaw)
* **ドキュメント**：[https://docs.openclaw.ai](https://docs.openclaw.ai/)
* **公式サイト**：[https://openclaw.ai](https://openclaw.ai/)
OpenClawは完全にオープンソースです。[GitHub](https://github.com/openclaw/openclaw)でソースコードの閲覧、issueの投稿、貢献ができます。このガイドでは、インストール、設定、およびOpenClawをMixRoute APIに接続するための全手順を説明します。
## 🌟 主な機能
### マルチチャネル連携
* **Canvas UI**：インタラクティブなCanvasインターフェースを描画
* **音声対応**: macOS/iOS/Androidでの音声によるやり取りに対応します
* **単一のGateway**: 1つのGatewayプロセスですべてのチャネルを管理します
* **マルチチャネル連携**：プラグインを通じてTelegram、Discord、WhatsApp、iMessageなどをサポート
### セルフホストとデータセキュリティ
* **ローカルデータ**: コンテキストとスキルは、クラウドではなくローカルマシンに保存されます
* **オープンソース**: MITライセンス、完全に公開されたコードベース
* **完全セルフホスト型**: 自分のマシンまたはサーバー上で動作します
### インテリジェントエージェントの機能
* **ツール呼び出し**: ツール呼び出しとコード実行をネイティブにサポート
* **マルチエージェントルーティング**: 複数のエージェントが連携して動作
* **セッションの分離**：エージェント／ワークスペース／送信者ごとにセッションを分離
* **定期実行タスク**：cron形式のスケジュール設定をサポート
* **永続的な実行環境**: 永続メモリを備え、バックグラウンドで動作します
## 📦 前提条件
* Node.js 22以上
* 有効なMixRoute APIエンドポイント（通常は`/v1`で終わります）
* 有効なMixRoute APIキー
MixRoute APIを接続する前に、公式のセットアップ手順に従って、まずOpenClaw GatewayとControl UIを起動することをおすすめします。これにより、問題の原因がOpenClaw自体にあるのか、モデルプロバイダーの設定にあるのかを切り分けやすくなります。
### 1. OpenClawをインストール（macOS/Linux）
```bash theme={null}
curl -fsSL https://openclaw.ai/install.sh | bash
```
その他のインストール方法：[はじめに](https://docs.openclaw.ai/start/getting-started)。
### 2. 初期設定ウィザードを実行する
```bash theme={null}
openclaw onboard --install-daemon
```
ウィザードで基本的な認証、Gatewayの設定、および任意のチャネル初期化を完了します。まずOpenClawを動作させ、その後でデフォルトモデルをMixRoute APIに切り替えることを目指します。
### 3. GatewayとControl UIを確認
```bash theme={null}
openclaw gateway status
```
```bash theme={null}
openclaw dashboard
```
ブラウザーでControl UIが開けば、OpenClawは正常に動作しています。この段階では、Telegram、Discord、その他のチャネルを設定する必要はありません。
### 4. 設定ファイルを見つける
設定ファイルは通常`~/.openclaw/openclaw.json`にあります。ウィザードで生成した後に変更できます。
専用のサービスアカウントでOpenClawを実行する場合や、設定および状態のディレクトリをカスタマイズする場合は、`OPENCLAW_CONFIG_PATH`、`OPENCLAW_STATE_DIR`、`OPENCLAW_HOME`を使用してください。[環境変数](https://docs.openclaw.ai/help/environment)を参照してください。
## 🚀 MixRoute APIをモデルプロバイダーとして使用する
OpenClawは、`models.providers`を通じてカスタムまたはOpenAI互換のモデルゲートウェイに対応します。MixRoute APIでは、通常、カスタムプロバイダーとして追加し、デフォルトモデルを`mixroute/model-id`に設定します。
### セットアップの概要
1. `models.providers`の下に`mixroute`プロバイダーを宣言します
2. `baseUrl`をMixRouteのAPIアドレスに設定します（`/v1`を含めてください）
3. `api`を`openai-completions`に設定してください
4. `models`に使用するモデルIDを列挙してください
5. `agents.defaults.model.primary`を`mixroute/...`に設定してください
### 推奨：キーには環境変数を使用
シェル、サービス環境、またはOpenClawが読み取れる`.env`ファイルに、MixRoute APIキーを設定してください。
```bash theme={null}
export MIXROUTE_API_KEY="sk-your-mixroute-key"
```
続いて、`openclaw.json`内にこのセクションを追加するか、更新します。
```json theme={null}
{
"models": {
"mode": "merge",
"providers": {
"mixroute": {
"baseUrl": "https://api.mixroute.ai/v1",
"apiKey": "${MIXROUTE_API_KEY}",
"api": "openai-completions",
"models": [
{ "id": "gemini-3.5-flash", "name": "Gemini 3.5 Flash" },
{ "id": "kimi-k2.7-code", "name": "Kimi K2.7 Code" }
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "mixroute/gemini-3.5-flash",
"fallbacks": ["mixroute/kimi-k2.7-code"]
},
"models": {
"mixroute/gemini-3.5-flash": { "alias": "flash" },
"mixroute/kimi-k2.7-code": { "alias": "kimi" }
}
}
}
}
```
これはMixRoute APIへの接続に必要な最小限の設定です。プロバイダー名、モデルID、デフォルトモデルの参照が一致していれば、OpenClawはモデルの利用にMixRoute APIを使用します。
### 設定リファレンス
| 設定 | 説明 |
| - | - |
| `models.mode` | 組み込みプロバイダーを維持したまま`mixroute`を追加するには、`merge`に設定します。 |
| `models.providers.mixroute.baseUrl` | MixRoute APIエンドポイント。例：`https://api.mixroute.ai/v1`（`/v1`を含める） |
| `models.providers.mixroute.apiKey` | MixRoute APIキー。環境変数からの注入には`${MIXROUTE_API_KEY}`を使用します |
| `models.providers.mixroute.api` | MixRoute APIのようなOpenAI互換ゲートウェイには`openai-completions`を使用 |
| `models.providers.mixroute.models` | モデルIDは、MixRoute APIが公開するIDと一致する必要があります |
| `agents.defaults.model.primary` | デフォルトモデル。形式は`provider/model-id`である必要があります |
| `agents.defaults.model.fallbacks` | プライマリモデルが失敗した場合のフォールバックモデル |
| `agents.defaults.models` | 任意。UIやセッションで使いやすくするためのエイリアス |
### スマートルーティングの連携（任意）
スマートルーティングは、プラットフォームレベルでタスクの複雑さに応じて適切なモデルにインテリジェントに振り分けます。[スマートルーティングの認証情報と制約](/ja/api-reference/smart-routing)
スマートルーティングノードに接続するには、設定ファイルにプロバイダーを追加します。
```json theme={null}
{
"models": {
"mode": "merge",
"providers": {
"mixroute-smart-routing": {
"baseUrl": "https://api.mixroute.ai/v1",
"apiKey": "${SMART_ROUTING_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "auto",
"name": "Auto"
}
]
}
}
},
}
```
### 接続の確認
設定後、Control UIを開くか、再読み込みしてください。
```bash theme={null}
openclaw dashboard
```
会話を開始でき、デフォルトモデルに`mixroute/...`が表示されれば、設定は成功です。次のコマンドも実行できます。
```bash theme={null}
openclaw models list
```
を実行して、`mixroute/`プレフィックスの付いたモデルがリストに表示されることを確認します。
### トラブルシューティング
* **baseUrlに`/v1`がない**: 最もよくある設定エラーの1つです。
* **モデルIDが誤っている**：`primary`と`fallbacks`は、`models.providers.mixroute.models`内の`id`の値と一致する必要があります。
* **サービスからキーを利用できない**: Gatewayをサービスとして実行している場合は、`MIXROUTE_API_KEY`を読み取れることを確認してください。
* **フォアグラウンドでデバッグ**：`openclaw gateway --port 18789`を使用してフォアグラウンドで実行し、ログを確認してください。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.