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

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

🌟 主要機能

マルチチャネル統合

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

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

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

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

• 継続実行：バックグラウンドでの常駐実行をサポートし、永続的な記憶を持つ
• スケジュールタスク：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、飞书などのメッセージチャネルを先に設定する必要はありません。

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/モデルIDに切り替える

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

まず、現在のシェル、サービス環境、または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と一致している必要があります。
• キーが現在のターミナルでのみ有効：Gatewayがバックグラウンドサービスとして実行されている場合、サービスプロセスもNEWAPI_API_KEYを読み取れることを確認してください。
• フォアグラウンドでのトラブルシューティング：公式のフォアグラウンド実行方法openclaw gateway --port 18789を使用して、ログとエラーを確認できます。