OpenClaw - セルフホスト型AIアシスタントプラットフォーム
OpenClaw チュートリアル — OpenClawのインストール、88APIとの連携、セルフホスト型AIアシスタントの迅速な構築。オープンソースプロジェクトで、Telegram、Discord、WhatsAppなどのマルチチャネル統合をサポートしています。
プロジェクト紹介
OpenClaw は、オープンソースでセルフホスト型の個人AI アシスタントプラットフォームであり、メッセージングアプリを自身のハードウェアで動作するAI エージェントに接続します。開発者や上級ユーザー向けに設計されており、データ制御を手放すことなく、自律的なAIアシスタントを所有できます。
- 公式ホームページ:https://openclaw.ai
- プロジェクトドキュメント:https://docs.openclaw.ai
- GitHub:https://github.com/openclaw/openclaw
OpenClaw は完全にオープンソースであり、OpenClaw の GitHub リポジトリでソースコードを閲覧したり、Issueを提出したり、貢献したりできます。このチュートリアルでは、OpenClaw のインストール、設定、および 88API との連携の完全な手順を説明します。
🌟 主要機能
マルチチャネル統合
- マルチチャネル統合:Telegram、Discord、WhatsApp、iMessage など、さまざまなメッセージングチャネルをサポートし、プラグインを通じてさらに多くのプラットフォームを拡張可能
- 単一ゲートウェイ:Gateway プロセスを通じてすべてのチャネルを一元管理
- 音声サポート:macOS/iOS/Android の音声インタラクションをサポート
- Canvas インターフェース:インタラクティブな Canvas インターフェースをレンダリング可能
セルフホスティングとデータセキュリティ
- 完全セルフホスティング:自身のマシンまたはサーバー上で動作
- オープンソースの透明性:MIT オープンソースライセンス、コードは完全に透明
- データローカライゼーション:コンテキストとスキルはクラウドではなく、ローカルコンピューターに保存
AIエージェント機能
- 継続実行:バックグラウンドでの常駐実行をサポートし、永続的な記憶を持つ
- スケジュールタスク:cron 定期タスクをサポート
- セッション隔離:エージェント/ワークスペース/送信者ごとにセッションを隔離
- マルチエージェントルーティング:複数のエージェントの協調動作をサポート
- ツール呼び出し:ツール呼び出しとコード実行をネイティブでサポート
📦 導入前の準備
準備情報
- Node.js 24.16 以上または 26.1 以上(公式推奨は Node 26。Node 22、23、25 はサポート対象外。公式のインストールスクリプトは Node 環境を自動で準備します)
- 88API のエンドポイント:
https://api.88api.ai/v1 - 88API コンソールで作成した API キー
- API キーは大切に保管し、出所の不明なアプリやページに貼り付けないでください。
88API を導入する前に、OpenClaw の公式推奨手順に従って Gateway と Control UI を起動しておくことをお勧めします。これにより、後で問題が発生した場合に、OpenClaw 自体が起動していないのか、モデルプロバイダーの設定が誤っているのかを区別しやすくなります。
1. OpenClawのインストール
macOS/Linux:
curl -fsSL https://openclaw.ai/install.sh | bashWindows(PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iexその他のインストール方法については、OpenClaw 公式ドキュメントのGetting Startedを参照してください。
2. オンボーディングウィザードの実行
openclaw onboard --install-daemonこのウィザードは、基本的な認証、Gateway の設定、およびオプションのチャネル初期化を完了します。ここでの目標は、まず OpenClaw を起動し、後でデフォルトモデルを 88API に切り替えることです。
公式のインストールスクリプトは終了時にこのウィザードを自動的に起動します。インストール時にウィザードを完了済みであれば、この手順は省略できます。ウィザードを完了するには、利用可能なモデルを先に接続する必要があります。88API キーしかない場合は、モデルプロバイダー一覧で More… → Custom Provider を選択し、Base URL に https://api.88api.ai/v1(/v1 が必須)を入力し、互換タイプ(Compatibility)はデフォルトの openai のまま、Model ID に gpt-6.1-sol を入力して 88API キーを貼り付けます。ウィザードは実際にリクエストを 1 回送信し、検証に成功した場合のみ保存します。ウィザードが作成するプロバイダー名は custom-api-88api-ai のようになり、後述の手動で追加する api88 と共存できます。
Skip for now は選択しないでください。そのまま終了して Gateway が起動されないため、次の手順の確認が失敗します。
3. GatewayとControl UIの確認
openclaw gateway statusopenclaw dashboardブラウザで Control UI を開くことができれば、OpenClaw の基本的な動作は正常です。この段階では、Telegram、Discord、Feishu などのメッセージングチャネルを設定する必要はありません。
4. 設定ファイルの特定
OpenClaw の設定ファイルは通常 ~/.openclaw/openclaw.json にあります。オンボーディングウィザードで生成されたものを基に、さらに変更を加えることができます。
パス関連の環境変数
OpenClaw を専用サービスアカウントで実行する場合、または設定/ステータスディレクトリをカスタマイズしたい場合は、以下を使用できます。
OPENCLAW_HOMEOPENCLAW_STATE_DIROPENCLAW_CONFIG_PATH
詳細については、公式の環境変数ドキュメント:Environment Variablesを参照してください。
🚀 88APIをモデルプロバイダーとして使用する
OpenClaw は、models.providers を介してカスタムまたは OpenAI 互換インターフェースのモデルゲートウェイを接続することをサポートしています。88API の場合、最も一般的な方法は、それをカスタムプロバイダーとして設定に追加し、デフォルトモデルを api88/モデルID に指定することです。
連携の考え方
models.providersの下にapi88プロバイダーを宣言します。baseUrlをhttps://api.88api.ai/v1に設定します(/v1が必須です)。apiをopenai-completionsに設定します。modelsに OpenClaw で使用したいモデルIDをリストします。agents.defaults.model.primaryでデフォルトモデルをapi88/...に切り替えます。
推奨される方法:環境変数でAPIキーを保存する
Gateway がバックグラウンドサービスとして動作している場合(手順 2 の --install-daemon)、ターミナルで export した変数は読み取れません。キーは OpenClaw 公式推奨のグローバル環境ファイル ~/.openclaw/.env(OPENCLAW_STATE_DIR を設定している場合はそのディレクトリ内の .env)に書き込み、Gateway を再起動してください。
macOS/Linux:
echo 'API88_API_KEY=sk-your-88api-key' >> ~/.openclaw/.env
openclaw gateway restartWindows(PowerShell):
Add-Content -Path "$HOME\.openclaw\.env" -Value 'API88_API_KEY=sk-your-88api-key' -Encoding ascii
openclaw gateway restart次に、openclaw.json に以下のスニペットを追加または変更します。
{
models: {
mode: "merge",
providers: {
api88: {
baseUrl: "https://api.88api.ai/v1",
apiKey: "${API88_API_KEY}",
api: "openai-completions",
models: [
{ id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
{ id: "kimi-k3", name: "Kimi K3" },
],
},
},
},
agents: {
defaults: {
model: {
primary: "api88/gemini-3.5-flash",
fallbacks: ["api88/kimi-k3"],
},
models: {
"api88/gemini-3.5-flash": { alias: "flash" },
"api88/kimi-k3": { alias: "kimi" },
},
},
},
}これはそのままコピーする必要がある完全な設定ではありませんが、88API を連携する上で最も重要な部分です。provider、モデルID、およびデフォルトモデルの参照が正しく対応していれば、OpenClaw は 88API を通じて対応するモデルを呼び出せます。
主要な設定項目
| 設定項目 | 説明 |
|---|---|
models.mode | merge に設定することをお勧めします。これにより、OpenClaw の組み込みプロバイダーを保持しつつ、api88 を追加できます。 |
models.providers.api88.baseUrl | 88API のエンドポイント https://api.88api.ai/v1。/v1 が必須です。 |
models.providers.api88.apiKey | 88API キー。${API88_API_KEY} を介して注入することをお勧めします。 |
models.providers.api88.api | 88API のような OpenAI 互換ゲートウェイの場合、openai-completions を使用します。 |
models.providers.api88.models | ここにリストされているモデルIDは、88API が実際に提供しているモデル名と一致している必要があります。 |
agents.defaults.model.primary | デフォルトのプライマリモデル。形式は provider/model-id である必要があります。 |
agents.defaults.model.fallbacks | フォールバックモデルのリスト。プライマリモデルが失敗した場合に自動的に切り替わります。 |
agents.defaults.models | オプション。モデルにエイリアスを付けるために使用し、UI やセッションで参照しやすくします。 |
連携成功の確認
設定が完了したら、Control UI に戻るか、再度開きます。
openclaw dashboardOpenClaw で正常に会話を開始でき、デフォルトモデルが api88/... になっている場合、連携は成功です。また、以下を使用することもできます。
openclaw models listapi88/ プレフィックスのモデルが利用可能なリストに表示されていることを確認します。
よくある質問
baseUrlに/v1が含まれていない:これは最も一般的な連携エラーの1つです。- モデルIDの入力ミス:
primaryとfallbacksはmodels.providers.api88.models内のidと一致している必要があります。 - APIキーが現在のターミナルでのみ有効:バックグラウンドサービスはターミナルで export した変数を引き継ぎません。
~/.openclaw/.envに書き込んでからopenclaw gateway restartを実行してください。 - フォアグラウンドでのトラブルシューティングを希望する場合:公式のフォアグラウンド実行方法
openclaw gateway --port 18789を使用して、ログとエラーを監視できます。