OpenClaw のインストールと OmniProxy の設定

OpenClaw は、自分のコンピューターにインストールして使う AI アシスタントです。Telegram、Discord、WhatsApp、Feishu から直接会話でき、別のチャットウィンドウを常に開いておく必要はありません。会話と履歴はこのコンピューターに保存され、そのままローカル環境で後続の手順も実行できます。

インストール前の準備

OpenClaw には Node 24.16 以降が必要です。Node 26.1 以降も使用でき、Node 26 が推奨されています。Node は OpenClaw の実行に必要な基本環境です。

macOS、Linux、Windows にインストールできます。適切なバージョンの Node がコンピューターにない場合は、インストールスクリプトが自動的に準備します。macOS では Node 26、Linux では Node 24 LTS が準備されます。pnpm が必要になるのは、OpenClaw をソースからビルドする場合だけです。

コンピューターに古いバージョンの Node がインストールされていても、すぐにアンインストールする必要はありません。2026-10-09 のテストでは、このコンピューターのシステム Node は要件の 24.16 を下回る 24.2.0 でしたが、非対話型インストールスクリプトによって Node 24.21.0 が自動的に準備されました。

ウィンドウが必要

デスクトップコンパニオン

Windows では Hub インストーラー
macOS では GitHub の DMG
初回にローカル Gateway をインストール可能

公式推奨

インストールスクリプト

macOS Linux WSL2
Windows では PowerShell を使用
--no-onboard を追加可能

Node 導入済み

パッケージマネージャー

npm pnpm または bun
次に onboard を実行
Node のバージョンはインストールページを参照

ウィンドウが必要ならデスクトップコンパニオンをダウンロードします。ターミナルだけで使う場合は、公式インストールスクリプトを実行します。

インストールと初回起動

ウィンドウ付きのデスクトップコンパニオンをインストールする方法と、ターミナルから直接インストールする方法があります。Gateway は、メッセージを受け取り、モデルを呼び出して結果を返すローカルサービスです。デスクトップコンパニオンを初めて開くときに、そのまま準備できます。

ウィンドウを使用する場合

Windows：OpenClawCompanion-Setup-x64.exe または OpenClawCompanion-Setup-arm64.exe をダウンロードして実行します。インストーラーには署名があり、設定、トレイステータス、チャット、node モードが含まれています。
macOS：OpenClaw の GitHub releases から OpenClaw の .dmg をダウンロードします。dmg を優先して使用しますが、.zip も利用できます。インストール後に OpenClaw.app を開きます。このバージョンに macOS 用ファイルがない場合は、macOS アプリのページに従ってください。

初回起動時に、このコンピューター上で OpenClaw に Gateway を準備させることも、既存のリモート Gateway に接続することもできます。

ターミナルからインストールする場合

macOS、Linux、WSL2 では、次を使用します。

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

Windows PowerShell では、次を使用します。

iwr -useb https://openclaw.ai/install.ps1 | iex

スクリプトは現在のシステムを判別し、必要に応じて Node をインストールした後、OpenClaw をインストールして初期セットアップを開始します。案内に従って初回設定を完了してください。

初期セットアップを後回しにする場合、macOS、Linux、WSL2 では次を使用します。

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

Windows では、公式の -NoOnboard を使用します。

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Node を自分で管理している場合は、npm、pnpm、bun も使用できます。npm 12、および npm 11.16 以降では、次を実行します。

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

npm 11.15 以前では、--allow-scripts=openclaw を外す必要があります。pnpm を使用する場合は、--allow-build=openclaw を追加してください。具体的な違いについては、インストールページを確認してください。

インストールが完了したら、次の 3 つのコマンドを順番に実行します。

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version はバージョンの確認、openclaw doctor は一般的な環境問題の確認、openclaw gateway status は Gateway が実行中かどうかの確認に使用します。3 つのコマンドすべてで正常な出力が得られれば、基本的なインストールは完了です。

ターミナルで openclaw が見つからないと表示される場合、通常は npm のグローバル bin ディレクトリが PATH に追加されていません。PATH は、ターミナルがプログラムを検索する場所の一覧です。node -v、npm prefix -g、echo "$PATH" の結果を比較し、該当する bin ディレクトリを PATH に追加してから、ターミナルを開き直してください。

~/.openclaw に使用中の設定がすでにある場合、標準のインストールスクリプトはそのディレクトリを使用します。既存の設定を変更せずに別途インストールするには、非対話型スクリプトを実行して新しいディレクトリを指定します。

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard は、このスクリプトのデフォルト動作です。2026-10-09 にこのコマンドを使用し、OpenClaw 2026.9.9 をインストールしました。インストール後は、そのディレクトリの bin にある openclaw を実行する必要があります。

OmniProxy から接続情報を取得する

最初に OmniProxy が実行中であることを確認し、モデル一覧を開いて次の 3 項目を準備します。

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: 現在の OmniProxy モデル一覧から完全な ID をコピー

baseUrl は、OpenClaw がモデルへのリクエストを送信するアドレスです。末尾が /v1 になるように指定してください。OmniProxy に接続する場合、api には openai-completions を使用します。そのモデルが実際に /v1/responses 経由で動作する場合に限り、openai-responses に変更してください。

Model ID は、一覧に表示されるモデルの完全な識別子です。一覧に記載されたとおりにコピーし、スラッシュが含まれている場合はそのスラッシュも残してください。次の 2 つの名前は、2026-10-09 時点のプロバイダードキュメントに記載された参照例にすぎません。一覧にない場合は使用しないでください：claude-sonnet-5-5、gpt-6-luna。

ゲートウェイがキーを検証しない場合でも、apiKey には値を入力する必要があります。このコンピューターでのみ使用するプレースホルダー文字列を指定できます。実際のキーをリポジトリにコミットしないでください。

ツール設定を入力する

Provider は、OpenClaw がモデルサービスを見つけるために使用する一連の接続設定と考えることができます。ここでは Provider に omniproxy という名前を付けます。

ターミナルで次のコマンドを実行し、アドレス、キー、2 つのモデル ID を自分の値に置き換えてください。

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

このコマンドにより、Provider とモデル一覧が設定に書き込まれます。コマンドが成功した後、Gateway を再起動する必要はありません。

続いて、デフォルトモデルを指定します。モデル参照は omniproxy/ とモデル ID で構成されます。ID に元から含まれているスラッシュはすべて残してください。モデル一覧の ID が次の短い名前より長い場合は、一覧にある完全な値を使用します。

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

reasoning、input、cost、contextWindow、maxTokens は省略できます。指定しない場合、テキストモデルはデフォルトの方法で処理されます。

同じ設定を設定ファイルに直接書き込むこともできます。メイン設定の Provider は models.providers にあります。各 agent は独自の models.json を持つこともできます。agent は、実際にタスクを受け取り、モデルを呼び出すアシスタントインスタンスです。ファイルは ~/.openclaw/agents/ の下にある、該当 agent ディレクトリ内の agent/models.json に配置されます。

この models.json に空ではない baseUrl が指定されている場合、メイン設定のアドレスより優先されます。

インストール確認

3 つのコマンド

openclaw --version
openclaw doctor
gateway status

設定

models.providers

baseUrl は /v1 で終える
api には completions を使用
モデルには最低限 id を記述

選択

provider/モデル

primary にはこの参照を使用
キーには環境変数を優先して使用
一覧はゲートウェイに合わせる

最初にコマンドが認識されることを確認し、その後でアドレスとモデルを書き込みます。モデル参照には Provider 名を含める必要があります。

実際のタスクで検証する

通常のプロジェクトディレクトリに移動し、短いメッセージを送信します。コマンド内のモデル参照を、自分の完全な Model ID に置き換えてください。

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "一語で回答してください。"

--local は今回の agent タスクをローカル環境で実行することを示し、--model は今回使用するモデルを指定します。--timeout 300 は、最大 300 秒待機することを示します。

ターミナルにモデルからの応答が実際に表示される必要があります。2026-10-09 に、OpenClaw 2026.9.9 でこのコマンドを使用し、応答を受信しました。初回の呼び出しには 1～2 分かかる場合があります。

Request timed out before a response was generated という元のエラーが表示された場合は、まず --timeout を大きくしてから、もう一度送信してください。通常、これは待機時間が不足していることを示すもので、アドレスが必ず間違っているという意味ではありません。

短い応答が成功したら、次に指定したローカルファイルを読み取らせます。その後、OmniProxy の呼び出し履歴を開き、記録内の送信元とモデル ID を確認してください。バージョン番号や doctor の出力だけでは、モデル接続の設定が完了したとは判断できません。

インストール

コマンドが応答する

バージョン番号が表示される
doctor で処理を妨げる問題がない
Gateway の状態を確認できる

タスク

小さなタスクを 1 つ実行した

例：ローカルファイルを 1 つ読む
応答がエラーではない
モデル参照が正しく記述されている

記録

ゲートウェイで確認できる

送信元は OpenClaw
モデル ID が一致している
キーがリポジトリに入っていない

バージョンコマンドの出力を確認した後、実際の応答も 1 回受信する必要があります。

よくあるエラー

openclaw が見つからない：npm のグローバル bin を PATH に追加し、ターミナルを開き直してください。指定したディレクトリにインストールした場合は、そのディレクトリの bin にあるプログラムを実行します。
node -v が 24.16 未満：古いバージョンを先にアンインストールする必要はありません。インストールスクリプトが準備した Node を確認するか、インストールページに従って 24.16 以降または 26.1 以降を使用してください。Node 26 が推奨です。
モデルが表示されない：モデルは models.providers の models 配列に記述し、少なくとも同じ id を指定する必要があります。agents.defaults.models だけを記述しても、新しいモデルは個別に登録されません。
400 が返され、developer ロールについて言及される：アドレスのホストが api.openai.com ではない場合は、デフォルト設定のままにし、supportsDeveloperRole を true に設定しないでください。true に設定しても上書きされます。
すぐにタイムアウトする：--timeout を 300 秒より長く設定し、先にアドレスを変更しないでください。
gpt-6-luna を選択したがツール呼び出しに失敗する：このモデルは Chat Completions をサポートしています。Chat Completions での関数呼び出しは、reasoning_effort が none の場合にのみサポートされます。一覧の ID がこれと異なる場合は、一覧の値を優先してください。
アドレスに接続できない：OmniProxy が実行中であること、baseUrl の末尾が /v1 であること、設定に書き込んだアドレスへアクセスできることを確認してください。その他のプライベートネットワークアドレスは、別途アクセスを許可する必要があります。
設定後も別のアドレスへ接続される：該当 agent の models.json に別の baseUrl が指定されていないか確認してください。

公式リファレンス

インストール手順については OpenClaw install を参照してください。カスタム Provider の設定方法については、Custom providers と設定フィールドを参照してください。例で使用したモデル ID は、Claude モデル概要と GPT-6 Luna で確認できます。

プレースホルダーをすべて独自の設定値に置き換えてください。実際のキーを公開しないでください。

保存された結果や HTTP 200 だけでは完全なエージェント互換性が証明されません。OmniProxy の呼び出し記録でソースとモデルを確認してください。

公式ソース · OpenClaw ↗