OpenClaw

はじめに

OpenClawは、メッセージングアプリと自分のハードウェア上で実行するAIエージェントを接続する、オープンソースのセルフホスト型パーソナルAIアシスタントプラットフォームです。開発者や上級ユーザー向けに設計されており、データの管理権を手放すことなく、自分専用の自律型AIアシスタントを利用できます。

GitHub：https://github.com/openclaw/openclaw
ドキュメント：https://docs.openclaw.ai
公式サイト：https://openclaw.ai

OpenClawは完全にオープンソースです。GitHubでソースコードの閲覧、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）

curl -fsSL https://openclaw.ai/install.sh | bash

その他のインストール方法：はじめに。

2. 初期設定ウィザードを実行する

openclaw onboard --install-daemon

ウィザードで基本的な認証、Gatewayの設定、および任意のチャネル初期化を完了します。まずOpenClawを動作させ、その後でデフォルトモデルをMixRoute APIに切り替えることを目指します。

3. GatewayとControl UIを確認

openclaw gateway status

openclaw dashboard

ブラウザーでControl UIが開けば、OpenClawは正常に動作しています。この段階では、Telegram、Discord、その他のチャネルを設定する必要はありません。

4. 設定ファイルを見つける

設定ファイルは通常~/.openclaw/openclaw.jsonにあります。ウィザードで生成した後に変更できます。

専用のサービスアカウントでOpenClawを実行する場合や、設定および状態のディレクトリをカスタマイズする場合は、OPENCLAW_CONFIG_PATH、OPENCLAW_STATE_DIR、OPENCLAW_HOMEを使用してください。環境変数を参照してください。

🚀 MixRoute APIをモデルプロバイダーとして使用する

OpenClawは、models.providersを通じてカスタムまたはOpenAI互換のモデルゲートウェイに対応します。MixRoute APIでは、通常、カスタムプロバイダーとして追加し、デフォルトモデルをmixroute/model-idに設定します。

セットアップの概要

models.providersの下にmixrouteプロバイダーを宣言します
baseUrlをMixRouteのAPIアドレスに設定します（/v1を含めてください）
apiをopenai-completionsに設定してください
modelsに使用するモデルIDを列挙してください
agents.defaults.model.primaryをmixroute/...に設定してください

推奨：キーには環境変数を使用

シェル、サービス環境、またはOpenClawが読み取れる.envファイルに、MixRoute APIキーを設定してください。

export MIXROUTE_API_KEY="sk-your-mixroute-key"

続いて、openclaw.json内にこのセクションを追加するか、更新します。

{
  "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やセッションで使いやすくするためのエイリアス

スマートルーティングの連携（任意）

スマートルーティングは、プラットフォームレベルでタスクの複雑さに応じて適切なモデルにインテリジェントに振り分けます。スマートルーティングの認証情報と制約

スマートルーティングノードに接続するには、設定ファイルにプロバイダーを追加します。

{
    "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を開くか、再読み込みしてください。

openclaw dashboard

会話を開始でき、デフォルトモデルにmixroute/...が表示されれば、設定は成功です。次のコマンドも実行できます。

openclaw models list

を実行して、mixroute/プレフィックスの付いたモデルがリストに表示されることを確認します。

トラブルシューティング

baseUrlに/v1がない: 最もよくある設定エラーの1つです。
モデルIDが誤っている：primaryとfallbacksは、models.providers.mixroute.models内のidの値と一致する必要があります。
サービスからキーを利用できない: Gatewayをサービスとして実行している場合は、MIXROUTE_API_KEYを読み取れることを確認してください。
フォアグラウンドでデバッグ：openclaw gateway --port 18789を使用してフォアグラウンドで実行し、ログを確認してください。

対話型AI

プログラミング

エンジニアリング

翻訳

はじめに

🌟 主な機能

マルチチャネル連携

セルフホストとデータセキュリティ

インテリジェントエージェントの機能

📦 前提条件

要件

1. OpenClawをインストール（macOS/Linux）

2. 初期設定ウィザードを実行する

3. GatewayとControl UIを確認

4. 設定ファイルを見つける

🚀 MixRoute APIをモデルプロバイダーとして使用する

セットアップの概要

推奨：キーには環境変数を使用

設定リファレンス

スマートルーティングの連携（任意）

接続の確認

トラブルシューティング

​はじめに

​🌟 主な機能

​マルチチャネル連携

​セルフホストとデータセキュリティ

​インテリジェントエージェントの機能

​📦 前提条件

要件

​1. OpenClawをインストール（macOS/Linux）

​2. 初期設定ウィザードを実行する

​3. GatewayとControl UIを確認

​4. 設定ファイルを見つける

​🚀 MixRoute APIをモデルプロバイダーとして使用する

​セットアップの概要

​推奨：キーには環境変数を使用

​設定リファレンス

​スマートルーティングの連携（任意）

​接続の確認

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

はじめに

🌟 主な機能

マルチチャネル連携

セルフホストとデータセキュリティ

インテリジェントエージェントの機能

📦 前提条件

1. OpenClawをインストール（macOS/Linux）

2. 初期設定ウィザードを実行する

3. GatewayとControl UIを確認

4. 設定ファイルを見つける

🚀 MixRoute APIをモデルプロバイダーとして使用する

セットアップの概要

推奨：キーには環境変数を使用

設定リファレンス

スマートルーティングの連携（任意）

接続の確認

トラブルシューティング