OpenClaw Windows ネイティブインストールとデプロイ

OpenClaw Windows ネイティブインストール・デプロイ

本ページの概要

OpenClaw Windows ネイティブインストール・デプロイと4All API集約中継によるClaude apikey接続設定チュートリアル

OpenClaw（旧称 Clawdbot / MoltBot）は、オープンソースのローカルファーストAI Agentゲートウェイです。大規模言語モデルをローカルシステムやメッセージングプラットフォーム（Telegram、WhatsApp、Discord、飛書、企業微信など）へ接続し、24時間365日稼働する個人AIアシスタントを実現します。

このチュートリアルでは、基盤環境の構築から大規模言語モデルAPIの接続、最終的に自動化ボットとして飛書ワークベンチへデプロイするまでの一連の流れを、Claude apikey 接続（カスタム Base URL + API Key）まで含めて解説します。

一、インストール前の準備

1.1 システム要件

Windows 10 / Windows 11
Node.js 22+ LTS
Git
2GB以上の空きディスク容量
4All APIのAPIKey取得

1.2 Node.js のインストール

[Node.js 公式サイト] https://nodejs.org にアクセスし、Node.js 22 LTS の Windows インストーラー（.msi）をダウンロードします。
インストーラーを実行し、“Automatically install the necessary tools” にチェックを入れます。
インストール完了後、PowerShell を閉じて再度開き、インストールを確認します。

node --version   # v22.x.x が表示されるはずです
npm --version    # バージョン番号が表示されるはずです

ヒント: node が認識されない場合は、C:\Program Files\nodejs\ をシステムの PATH 環境変数に手動で追加するか、PC を再起動してください。

1.3 Git のインストール

PowerShell で以下のコマンドを実行します。

winget install Git.Git

（または [Git 公式サイト] https://git-scm.com からインストールしてください。手順は、PC のアーキテクチャ（例: Windows x64）に合ったインストーラーをダウンロードし、一般ユーザーであれば高度な設定に悩む必要はありません。基本はデフォルトのままでインストールを完了し、インストール時は “Use Git from the command line and also from 3rd-party software” を選択します。）

インストール後、PowerShell を閉じて再度開き、確認します。

git --version

二、Windows ネイティブ PowerShell で OpenClaw をインストール

2.1 PowerShell 環境の設定

管理者として PowerShell を開き（スタートメニューを右クリック → Windows PowerShell (管理者)）、以下のコマンドを順番に実行します。

# スクリプトの実行を許可
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# npm のグローバルインストール先を変更（権限衝突を回避）
npm config set prefix "C:\npm"
npm config set cache "C:\npm-cache"

# 新しいディレクトリをユーザー PATH に追加
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\npm", "User")

実行後、PowerShell を閉じて新しいウィンドウを開きます（PATH を反映させるためです）。

2.2 OpenClaw のインストール

方法は2つあります。まずは方法1を試すのがおすすめです。

方法1：ワンクリックスクリプト

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

方法2：手動で npm インストール（ワンクリックスクリプトでエラーが出る場合）

npm install -g openclaw

よくあるエラーの対処:

node.exe アプリケーションエラー：一時的に Windows Defender のリアルタイム保護をオフにしてから再試行します。
spawn git ENOENT：Git が未インストール、または PowerShell を再起動していません。先に Git を入れてからウィンドウを開き直してください。
権限エラー：PowerShell を管理者として実行してください。

2.3 ガイドウィザードの実行

ガイドウィザードでは、以下の内容が順に確認されます。

セキュリティ確認：方向キーで “Yes” を選択します（OpenClaw にシステムアクセス権があることを理解していることの確認です）。
インストールモード： “QuickStart” を選んで基本設定を素早く完了します。
LLM プロバイダーの選択：ここでは適当に1つ選ぶか、スキップしても構いません。後で手動で4All APIのapikeyサービスを設定します。
メッセージングプラットフォームの設定（任意）：Telegram / WhatsApp / Discord / 钉钉 / 飛書 / 企業微信 / QQ などは後から設定できます。
Shell 補完（任意）：Yes を推奨します。コマンド入力が速くなります。
パッケージマネージャー：npm を選択します。
その後の項目はすべて “No/Default” で問題ありません。

ヒント: ガイド中に API を設定したい場合は、LLM の選択をいったんスキップし、インストール完了後に設定ファイルを手動編集すると柔軟です（次章参照）。

2.4 インストール確認

ブラウザで http://127.0.0.1:18789/ にアクセスします。 “unauthorized” と表示される場合は、コマンドラインで openclaw dashboard を実行すると、?token=... を含むリンクが表示されます。そのリンクを開いてください。

注意: Gateway のバックグラウンドサービス化に失敗した場合（管理者権限が必要）、フロントエンドモードで手動起動できます: openclaw gateway --port 18789

三、4All APIプロキシ経由でClaude APIkeyを取得し、大規模言語モデルサービスを呼び出す設定

4All APIプロキシ（API Proxy / Relay）経由で Claude に接続するには、次の2つが必要です。

Base URL：4All APIサービスが提供するAPIアドレス
API Key：4All APIサービスから提供されるキー

3.1 中継サービス情報の確認

項目	例	説明
Base URL	https://sg.4All API.com	プロキシサービスのAPIアドレス
API Key	sk-xxxxxxxxxxxxxxxx	中継サービスから提供されるキー
対応モデル	claude-sonnet-4-5-20250929、GPT-5、Gemini-3-Pro など	4All APIのモデル広場で対応状況を確認できます

重要: 4All API集約サービスは、Anthropicのネイティブ形式（anthropic-messages）と OpenAI 互換形式（openai-completions）の両方に対応しています。

3.2 OpenClaw の設定ファイルを編集する

OpenClaw の設定ファイルは既定で C:\Users\あなたのユーザー名\.openclaw\openclaw.json にあります。メモ帳、VS Code、その他のテキストエディタで開いてください。

3.3 設定案 A：4All APIサービスが Anthropic ネイティブ形式に対応している場合（推奨）

Anthropic のネイティブ API（/v1/messages エンドポイント）をサポートしている場合は、anthropic-messages 形式を使います。これは Claude の高度な機能をすべて使える推奨構成です。openclaw.json に以下の内容を追加または修正してください。

openclaw.json を空にし、"name": "Claude Sonnet 4.5" を含む完成版コードをそのまま貼り付けます。

{
  "models": {
    "providers": {
      "4All API": {
        "api": "anthropic-messages",
        "baseUrl": "https://sg.4All API.com",
        "apiKey": "sk-在这里填入你在4All API生成的真实密钥",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "Claude Sonnet 4.5",
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": true
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "4All API/claude-sonnet-4-5-20250929"
      }
    }
  }
}

（改めて注意: sk-... のキーを必ずあなたの実際のものに置き換えてください。）

保存して閉じたら、PowerShell に戻って次を再度実行します。

第一歩: ローカルモードを再設定する PowerShell で次のコマンドを実行します。

openclaw config set gateway.mode local

第二歩: ゲートウェイを再起動する続けて起動コマンドを実行します。

openclaw gateway --port 18789

このウィンドウは閉じずにそのままにして、ブラウザに切り替えて Dashboard ページ（http://127.0.0.1:18789）を更新し、Claude に最初のメッセージを送ってテストしてみましょう。

注意点:

baseUrl の末尾に /v1 を付けないでください。OpenClaw はこの形式を使うと自動的に /v1/messages を連結します。URL にすでに /v1 が含まれていると、最終的に /v1/v1/messages となり、404 エラーになります。
"api": "anthropic-messages" を必ず設定してください。設定しない場合、既定で OpenAI 互換モードになります。
headers の anthropic-version は通常 "2023-06-01" に設定する必要があります。
モデル id は中継サービスが実際に対応しているものと一致していなければなりません。
中継サービスが thinking/reasoning 機能と互換でない場合は、headers の anthropic-beta を空文字列にして無効化できます。

3.4 設定案 B：4All APIサービスが OpenAI 形式に対応している場合

OpenClaw 2026 の最新版では、要求される「入れ子」構造に厳密に従って記述する必要があります。さらに、新版で必須となった name フィールドとルーティング設定も補完しなければなりません。

以下は、OpenAI 互換形式に最適化した完成版です。そのままコピーして使えます。

{
  "gateway": {
    "mode": "local"
  },
  "models": {
    "providers": {
      "4All API": {
        "api": "openai-completions",
        "baseUrl": "https://sg.4All API.com/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxx",
        "models": [
          {
            "id": "gpt-4.1",
            "name": "GPT-4.1",
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "4All API/gpt-4.1"
      }
    }
  }
}

💡 新版 json コードの主な最適化ポイント

最新版アーキテクチャに完全対応：api、baseUrl、apiKey をすべて models.providers.4All API ノード配下にまとめ、Unrecognized keys エラーを完全に回避します。
/v1 サフィックスを維持：Anthropic ネイティブ形式と異なり、OpenAI 互換インターフェースの標準パスは /v1 で終わります。そのため "baseUrl": "https://sg.4All API.com/v1" は正しい標準記法です。
必須フィールドを補完："name": "GPT-4.1" を追加しています。これがないと、Dashboard コントロールパネルで表示名を読み取れず received undefined エラーが発生します。
コンテキスト関連パラメータを追加：汎用の contextWindow（コンテキストウィンドウ）と maxTokens（最大出力）を補い、ゲートウェイが記憶長をより正確に制御できるようにします。
メインモデルのルーティングを有効化：agents.defaults で既定の呼び出しモデルを 4All API/gpt-4.1 に明示し、メッセージ送信時に確実にモデルへ流れるようにします。

3.5 2つの形式の比較早見表

比較項目	anthropic-messages（推奨）	openai-completions
api フィールド	”anthropic-messages"	"openai-completions”
baseUrl の末尾	`/v1` を付けない	`/v1` を付ける
Prompt Caching	対応	非対応
Extended Thinking	対応	非対応
Tool Calling の安定性	より良い（ネイティブ形式）	互換性の問題が出る場合あり
適用シーン	中継が Anthropic ネイティブ API をサポート	中継が OpenAI ネイティブ इंटरーフェースをサポート

おすすめ: どちらも使えるなら、まずは anthropic-messages を優先してください。

四、anthropic主力・予備モデル自動切り替え設定ファイル例

これは 2026 年最新版 OpenClaw に完全対応した openclaw.json の完成版です。主力モデルと予備モデルの自動切り替えに対応し、すべての形式検証要件も修正済みです。

そのまま1回でコピーして、ファイル内の既存内容をすべて上書きしてください。

{
  "gateway": {
    "mode": "local"
  },
  "models": {
    "providers": {
      "4All API": {
        "api": "anthropic-messages",
        "baseUrl": "https://sg.4All API.com",
        "apiKey": "sk-请替换为你的4All API真实密钥",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "Claude Sonnet 4.5",
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": true
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "contextWindow": 200000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "4All API/claude-sonnet-4-5-20250929",
        "fallbacks": [
          "4All API/claude-opus-4-6"
        ]
      }
    }
  }
}

⚠️ 重要な注意: 貼り付け後、10行目の sk-请替换为你的4All API真实密钥 を、実際に生成した Key に必ず置き換えてください。

五、Claude と GPT を組み合わせた「デュアルエンジン」設定ファイル例

Claude と GPT を組み合わせるのは、4All API のような集約中継プラットフォームならではの最強の使い方です。AI アシスタントに「デュアルエンジン」を持たせることで、複雑なタスクにも対応でき、非常に高い安定性も確保できます。

特に重要なポイント: Claude（Anthropic プロトコル、/v1 なし）と GPT（OpenAI プロトコル、/v1 あり）は、内部の通信形式がまったく異なります。OpenClaw 2026 の最新版では、これらを同じ枠に入れることはできません。必ず2つの独立した「プロバイダー（providers）」に分ける必要があります。

以下は、丁寧に調整した「Claude + GPT デュアルエンジン完成版」の openclaw.json 設定です。知乎チュートリアルにそのまま載せて、高度な活用例（応用編）として読者に提示できます。

{
  "gateway": {
    "mode": "local"
  },
  "models": {
    "providers": {
      "4All API-claude": {
        "api": "anthropic-messages",
        "baseUrl": "https://sg.4All API.com",
        "apiKey": "sk-请替换为你的4All API真实密钥",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "Claude Sonnet 4.5",
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": true
          }
        ]
      },
      "4All API-gpt": {
        "api": "openai-completions",
        "baseUrl": "https://sg.4All API.com/v1",
        "apiKey": "sk-请替换为你的4All API真实密钥",
        "models": [
          {
            "id": "gpt-4.1",
            "name": "GPT-4.1",
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "4All API-claude/claude-sonnet-4-5-20250929",
        "fallbacks": [
          "4All API-gpt/gpt-4.1"
        ]
      }
    }
  }
}

（改めて注意: sk-... のキーを必ず置き換えてください。）

保存して閉じたら、PowerShell に戻って次を再度実行します。

第一歩: ローカルモードを再設定する PowerShell で次のコマンドを実行します。

openclaw config set gateway.mode local

第二歩: ゲートウェイを再起動する続けて起動コマンドを実行します。

openclaw gateway --port 18789

💡デュアルエンジン設定の重要ポイント

このコードを読者に説明する際は、次のような魅力的な「強み」を抽出できます。

プロトコル分離で干渉なし：providers 下に 4All API-claude と 4All API-gpt という2つの独立した経路を定義しています。ひとつはネイティブの Anthropic プロトコルで最高性能を、もうひとつは標準の OpenAI 互換プロトコルで動作します。
予算を共用し、接続もシームレス：2つの経路に分かれていても、どちらも sg.4All API.com を指し、同じ apiKey を使うため、同一アカウントの利用枠を消費します。管理がとても楽です。
エンタープライズ級の「災害対策」戦略：最下部の agents.defaults では、コード作成とロジックに強い Claude Sonnet 4.5 を絶対的な主力（primary）に設定しています。同時に GPT-4.1 を予備プール（fallbacks）に入れています。万が一 Claude のインターフェースに大規模なネットワーク変動が発生しても、システムはミリ秒単位で GPT-4.1 にシームレス切り替えし、引き続き応答します。飛書ボットを24時間絶対に止めないための設計です。

⚙️ 主要設定フィールドの対照説明

1. ゲートウェイの基本設定（gateway）

"mode": "local"：OpenClaw を「ローカルモード」で動作させることを明示します。インストール直後によく出る Gateway start blocked（ゲートウェイ起動ブロック）を解決する重要なスイッチです。

2. プロバイダーとネットワーク経路（providers.4All API）

ローカルゲートウェイと 4All API 中継サービスをつなぐ橋渡しです。

"4All API"：設定内で定義したサービスプロバイダー名の接頭辞です。後でモデルを呼び出す際に使います。
"api": "anthropic-messages"：通信プロトコル形式を指定します。Anthropic のネイティブプロトコルを使うことで、Claude の Prompt Caching などの高度な機能をフルに利用できます。
"baseUrl"：4All API のサーバー API アドレスです。末尾に /v1 を付けない点に注意してください。システムが自動で連結します。
"apiKey"：認証に使う専用キー（プラットフォームから取得）。
"headers"：リクエストヘッダーのパラメータです。"anthropic-beta": "" はあえて空文字にしており、中継サービスが対応していないベータ機能を無効化して、400 の互換性エラーを防ぐための高度なトラブルシュート手法です。

3. モデルの詳細定義（models 配列）

この配列には、2つの具体的なモデル（Sonnet と Opus）を登録しています。

"id"：バックエンドで実際に使われる大規模言語モデルのリクエストID（例: claude-sonnet-4-5-20250929）。プラットフォームの対応モデルと完全に一致している必要があります。
"name"：（新版の必須項目）Dashboard コントロールパネルに表示する名前です。これがないと undefined エラーになります。
"contextWindow"：モデルのコンテキストウィンドウサイズ（Claude 系は通常 200,000 tokens をサポート）。ゲートウェイが履歴をどこで切るかを判断できます。
"maxTokens"：1回の応答で許可される最大 Token 数です。
"reasoning": true：そのモデルが高度な論理推論と思考能力を持つことを示すフラグです。

4. 自動化スケジューリング戦略（agents.defaults）

AI アシスタントを常時稼働させるための中核設定です。

"primary"：既定の主力モデルを指定します（形式は サービス名/モデルID）。ここではコスパの良い Sonnet を指定しています。
"fallbacks"：予備モデルのプールです。主力モデルがネットワーク不安定、レート制限、利用不可になった場合、システムは配列内の予備モデル（例: Opus）へ自動でシームレス切り替えし、24時間365日の安定稼働を支えます。

六、応用設定

5.1 複数 Agent で異なるモデルを使う

タスクごとに異なるモデルを割り当て、コストと性能のバランスを取ります。例えば、複雑なタスクには Opus、日常会話には Sonnet を使います。これは通常、Dashboard 画面で各 Agent ごとに個別指定できます。

5.2 既定モデルの切り替え

コマンドラインから素早く主力モデルを切り替えたい場合は、次を使います。

openclaw models set <model_id>

5.3 メッセージングプラットフォームの設定（任意）

インストール後でもいつでもメッセージングプラットフォームを追加できます。ターミナルで以下を入力し、表示に従って操作してください。

openclaw configure

一、飛書ワークベンチへの深い連携を例に

1. 飛書アプリを作成する：飛書オープンプラットフォームにログインし、「開発者バックエンド」へ進んで、企業内自作アプリを作成し、ボットの名前と説明を入力します。
1. 基本権限を有効化する：アプリ設定でボット機能を追加します。「権限管理」で検索欄に IM: と入力し、メッセージ関連の権限をすべて有効化します。その後、「バージョン作成」をクリックして公開を確定します（バージョン番号は 1.0.0 でも可）。
1. 設定端末を呼び出す： PowerShell に戻り、openclaw の設定コマンドを入力して再度設定画面に入ります。通信チャネルの設定を選び、飛書を追加すると、システムが自動で npm 経由で飛書プラグインをインストールします。
1. 飛書の認証情報を紐付ける：飛書開発者バックエンドが提供する App Secret と App ID をコピーし、PowerShell 端末に順番に貼り付けます。
1. 通信プロトコルを設定する：通信方式は最も簡単な WebSocket モードを選びます。実際の要件に応じて、個別チャットとグループチャットへのアクセス権限を設定します（たとえば Open を選んでチーム全員が使えるようにするなど）。
1. イベントコールバックを設定する：飛書開発者バックエンドに戻り、「イベントとコールバック」で購読方式を長リンクに切り替え、受信メッセージ イベントを検索して追加します。
1. 権限を補完して反映する：再度飛書の「権限管理」に入り、ロボット基本情報の取得 などの権限を追加で有効化します。最後に、必ず新しいバージョンを再公開し、すべての設定を正式に有効化します。

二、テストと機能拡張

1. 最終結合テスト：飛書アプリまたはデスクトップ版を開き、メッセージ一覧で先ほど作成したボットアプリを検索して開きます。個別チャットでメッセージを送るか、グループに追加して @ で質問し、返信の遅延やロジックが正常か確認します。
1. 自動化スキルを拡張する：基本対話が通ったら、OpenClaw の設定画面に戻って、さらに多くの自動化 Skills（例: AI 画像生成、自動資料収集など）をインストールできます。API 利用枠とデータの安全性を守るため、公式または信頼できる提供元のスキルプラグインのみを導入することを強く推奨します。

七、よく使うコマンド早見表

コマンド	役割
openclaw gateway status	ゲートウェイの稼働状況を確認