OpenClaw - セルフホスト型AIアシスタントプラットフォーム

OpenClaw は完全にオープンソースであり、OpenClaw の GitHub リポジトリでソースコードを閲覧したり、Issueを提出したり、貢献したりできます。このチュートリアルでは、OpenClaw のインストール、設定、および New API との連携の完全な手順を説明します。

🌟 主要機能

マルチチャネル統合

• マルチチャネル統合：Telegram、Discord、WhatsApp、iMessage など、さまざまなメッセージングチャネルをサポートし、プラグインを通じてさらに多くのプラットフォームを拡張可能
• 単一ゲートウェイ：Gateway プロセスを通じてすべてのチャネルを一元管理
• 音声サポート：macOS/iOS/Android の音声インタラクションをサポート
• Canvas インターフェース：インタラクティブな Canvas インターフェースをレンダリング可能

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

• 完全セルフホスティング：自身のマシンまたはサーバー上で動作
• オープンソースの透明性：MIT オープンソースライセンス、コードは完全に透明
• データローカライゼーション：コンテキストとスキルはクラウドではなく、ローカルコンピューターに保存

AIエージェント機能

• 継続実行：バックグラウンドでの常駐実行をサポートし、永続的な記憶を持つ
• スケジュールタスク：cron 定期タスクをサポート
• セッション隔離：エージェント/ワークスペース/送信者ごとにセッションを隔離
• マルチエージェントルーティング：複数のエージェントの協調動作をサポート
• ツール呼び出し：ツール呼び出しとコード実行をネイティブでサポート

📦 導入前の準備

New API を導入する前に、OpenClaw の公式推奨手順に従って Gateway と Control UI を起動しておくことをお勧めします。これにより、後で問題が発生した場合に、OpenClaw 自体が起動していないのか、モデルプロバイダーの設定が誤っているのかを区別しやすくなります。

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

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

その他のインストール方法については、OpenClaw 公式ドキュメントのGetting Startedを参照してください。

2. オンボーディングウィザードの実行

openclaw onboard --install-daemon

このウィザードは、基本的な認証、Gateway の設定、およびオプションのチャネル初期化を完了します。ここでの目標は、まず OpenClaw を起動し、後でデフォルトモデルを New API に切り替えることです。

3. GatewayとControl UIの確認

openclaw gateway status

openclaw dashboard

ブラウザで Control UI を開くことができれば、OpenClaw の基本的な動作は正常です。この段階では、Telegram、Discord、Feishu などのメッセージングチャネルを設定する必要はありません。

4. 設定ファイルの特定

OpenClaw の設定ファイルは通常 ~/.openclaw/openclaw.json にあります。オンボーディングウィザードで生成されたものを基に、さらに変更を加えることができます。

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

OpenClaw は、models.providers を介してカスタムまたは OpenAI 互換インターフェースのモデルゲートウェイを接続することをサポートしています。New API の場合、最も一般的な方法は、それをカスタムプロバイダーとして設定に追加し、デフォルトモデルを newapi/モデルID に指定することです。

連携の考え方

1. models.providers の下に newapi プロバイダーを宣言します。
2. baseUrl を New API アドレスに指定し、/v1 が含まれていることを確認します。
3. api を openai-completions に設定します。
4. models に OpenClaw で使用したいモデルIDをリストします。
5. agents.defaults.model.primary でデフォルトモデルを newapi/... に切り替えます。

推奨される方法：環境変数でAPIキーを保存する

まず、現在のシェル、サービス環境、または OpenClaw が読み取れる .env に New API キーを提供します。

export NEWAPI_API_KEY="sk-your-newapi-key"

次に、openclaw.json に以下のスニペットを追加または変更します。

{
  models: {
    mode: "merge",
    providers: {
      newapi: {
        baseUrl: "https://<your-newapi-domain>/v1",
        apiKey: "${NEWAPI_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "kimi-k2.5", name: "Kimi K2.5" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "newapi/gemini-2.5-flash",
        fallbacks: ["newapi/kimi-k2.5"],
      },
      models: {
        "newapi/gemini-2.5-flash": { alias: "flash" },
        "newapi/kimi-k2.5": { alias: "kimi" },
      },
    },
  },
}

これはそのままコピーする必要がある完全な設定ではありませんが、New API を連携する上で最も重要な部分です。provider、モデルID、およびデフォルトモデルの参照が正しく対応していれば、OpenClaw は New API を介して公開されているモデルリソースを呼び出すことができます。

主要な設定項目

連携成功の確認

設定が完了したら、Control UI に戻るか、再度開きます。

openclaw dashboard

OpenClaw で正常に会話を開始でき、デフォルトモデルが newapi/... になっている場合、連携は成功です。また、以下を使用することもできます。

openclaw models list

newapi/ プレフィックスのモデルが利用可能なリストに表示されていることを確認します。

よくある質問

• baseUrl に /v1 が含まれていない：これは最も一般的な連携エラーの1つです。
• モデルIDの入力ミス：primary と fallbacks は models.providers.newapi.models 内の id と一致している必要があります。
• APIキーが現在のターミナルでのみ有効：Gateway がバックグラウンドサービスとして実行されている場合、サービスプロセスも NEWAPI_API_KEY を読み取れることを確認してください。
• フォアグラウンドでのトラブルシューティングを希望する場合：公式のフォアグラウンド実行方法 openclaw gateway --port 18789 を使用して、ログとエラーを監視できます。