OpenClaw は、AI agent が Telegram や WhatsApp などのアプリに接続し、メッセージ送信やタスク処理といった操作を行えるようにするローカルツールです。流れを理解すれば、セットアップは難しくありません。このガイドでは、macOS、Linux、Windows でのインストール方法を説明します。
OpenClaw セットアップ方法の概要
用途に合ったセットアップ方法を選びましょう。OpenClaw をローカルで実行すると、すべてを自分のマシン上に保てますが、npm などの依存関係をインストールするか、自動スクリプトを使う必要があります。セットアップを省きたい場合は、Kimi Claw のような完全ホスト型プラットフォームが環境を用意してくれるため、すぐに始められます。
| macOS / Linux | Windows | |
|---|---|---|
| ローカルで実行 | ターミナルのワンラインコマンド | PowerShell のワンラインコマンド |
| npm 経由 | npm 経由 | |
| Homebrew 経由 | WSL2 経由 | |
| オンラインで実行 | クラウドベースのソリューション（例：Kimi Claw） | クラウドベースのソリューション（例：Kimi Claw） |
macOS と Linux に OpenClaw をインストールする方法
macOS と Linux では、同じインストーラーとコマンドを使用します。特に記載がない限り、以下の手順は両方のシステムに適用されます。
以下はクイックセットアップガイドです。スクリーンショット付きの詳しい手順は、macOS に OpenClaw をインストールする方法をご覧ください。
方法 1：ワンラインインストーラースクリプトを使う
ステップ 1：ターミナルでインストールスクリプトを実行する
公式インストーラースクリプトを実行して OpenClaw をセットアップします。このスクリプトは Node.js 22 以降がインストールされているか確認します。未インストールまたは古い場合は、Node.js 24 が自動でインストールされます。その後、OpenClaw CLI をインストールし、オンボーディングウィザードを起動します。
ステップ 2：オンボーディングウィザードを完了する
オンボーディングウィザードに従って agent 環境をセットアップします。モデルプロバイダー（例：Kimi API）の選択、API キーの入力、チャネルの選択、基本設定の構成を行います。
ステップ 3：インストールを確認する
次のコマンドを実行して、OpenClaw のバージョンを確認します。
ステップ 4：gateway を確認してセットアップを完了する
次のコマンドを実行して、OpenClaw gateway がアクティブであることを確認します。
インストーラーは macOS では LaunchAgent、Linux では systemd サービスも登録するため、OpenClaw はバックグラウンドで実行され続けます。すべてのセットアップが完了すると、agent を使用できるようになります。チャットを始めたり、ツールを接続したり、必要に応じてワークフローを設定したりできます。
方法 2：Homebrew でインストールする
ステップ 1：Node.js をインストールまたはアップグレードする
ターミナルで次のコマンドを実行し、Homebrew を使って Node.js をインストールします。すでに Node.js がインストールされている場合は、代わりにアップグレードコマンドを実行して最新版にしてください。
ステップ 2：OpenClaw CLI をインストールする
次のコマンドを実行して、OpenClaw CLI をグローバルにインストールします。
ステップ 3：オンボーディングを実行して daemon を設定する
次のコマンドを実行してオンボーディングウィザードを起動し、バックグラウンド daemon を登録します。ウィザードに従って agent 環境を設定します。モデルプロバイダー（例：Kimi API）の選択、API キーの入力、メッセージングチャネルの接続を行います。セットアップが完了すると、agent を使用できるようになります。チャットを始めたり、ツールを接続したり、必要に応じてワークフローを設定したりできます。
方法 3：npm でインストールする
ステップ 1：ランタイムのバージョンを確認する
次のコマンドを実行して、Node.js 22.14 以降がシステムにインストールされていることを確認します。バージョンが最新であれば、インストールに進めます。
ステップ 2：OpenClaw CLI をインストールする
次のコマンドを実行して、OpenClaw CLI をグローバルにインストールします。
ステップ 3：オンボーディングを実行して永続化を有効にする
次のコマンドを実行してオンボーディングウィザードを開始し、バックグラウンド daemon を登録します。ウィザードに従って agent 環境を設定します。モデルプロバイダー（例：Kimi API）の選択、API キーの入力、メッセージングチャネルの選択を行います。セットアップが完了すると、agent を使用できます。agent とやり取りを始めたり、ツールを接続したり、必要に応じてワークフローを構築したりできます。
プラットフォームに関する注意： OpenClaw は Intel Mac と Apple Silicon Mac の両方に対応しています。インストールが Gatekeeper によってブロックされた場合は、システム設定の「プライバシーとセキュリティ」で許可できます。
Windows に OpenClaw をインストールする方法
Windows で OpenClaw をインストールする主な方法は 3 つあります。すばやくネイティブ環境にセットアップできる PowerShell インストーラー、完全な Linux 環境を使う WSL2、手動インストール用の npm です。
以下はクイックセットアップガイドです。スクリーンショット付きの詳しい手順は、Windows に OpenClaw をインストールする方法をご覧ください。
方法 1：PowerShell インストーラーを使う（ネイティブ Windows）
ステップ 1：PowerShell でインストーラースクリプトを実行する
PowerShell を管理者として開き、公式のワンラインスクリプトを実行して OpenClaw をインストールします。
ステップ 2：オンボーディングウィザードを完了する
オンボーディングの手順に従って agent 環境を設定します。モデルプロバイダー（例：Kimi API）の選択、API キーの入力、メッセージングチャネルの選択を行います。
ステップ 3：インストールを確認する
次のコマンドを実行して、OpenClaw が正しくインストールされ、gateway がアクティブであることを確認します。
ステップ 4：agent を使い始める
セットアップが完了すると、agent を使用できます。agent とやり取りを始めたり、ツールを接続したり、必要に応じてワークフローを設定したりできます。
方法 2：WSL2 でインストールする
ステップ 1：Linux 環境をセットアップする
PowerShell を管理者として開き、次のコマンドを実行して WSL2 を有効化し、初期化します。
ステップ 2：Linux でインストーラーを実行する
Linux ターミナルを開き、標準のインストールスクリプトを実行して OpenClaw をインストールします。
ステップ 3：オンボーディングウィザードを完了する
オンボーディングの手順に従って agent 環境を設定します。モデルプロバイダー（例：Kimi API）の選択、API キーの入力、メッセージングチャネルの選択を行います。
セットアップが完了すると、agent を使用できます。agent とやり取りを始めたり、ツールを接続したり、必要に応じてワークフローを設定したりできます。
方法 3：Windows で npm を使ってインストールする
ステップ 1：Node.js のバージョンを確認する
次のコマンドを実行して、Node.js がインストール済みで最新であることを確認します。
ステップ 2：OpenClaw CLI をインストールする
次のコマンドを実行して、OpenClaw CLI をグローバルにインストールします。
ステップ 3：オンボーディングを実行して永続化を有効にする
次のコマンドを実行してオンボーディングウィザードを開始し、バックグラウンド daemon を登録します。
オンボーディングの手順に従って agent 環境を設定します。モデルプロバイダー（例：Kimi API）の選択、API キーの入力、メッセージングチャネルの選択を行います。
セットアップが完了すると、agent を使用できます。agent とやり取りを始めたり、ツールを接続したり、必要に応じてワークフローを設定したりできます。
Kimi Claw で OpenClaw をオンライン実行する方法
上記の方法では、ターミナル、対応する Node.js バージョン、そして稼働し続けるマシンが必要です。Kimi Claw なら完全ホスト型の選択肢が用意されているため、ローカル環境をインストールしたり保守したりせずに OpenClaw を実行できます。
ステップ 1：Kimi Claw を開いてインスタンスを作成する
Kimi Claw のページに移動し、作成をクリックして開始します。
ステップ 2：デプロイを確認する
ポップアップウィンドウでデプロイを確認します。Kimi Claw は、ローカルでの設定を必要とせず、gateway やワークスペースを含む OpenClaw 環境を自動でセットアップします。
ステップ 3：ワークスペースを使い始める
デプロイが完了すると、ダッシュボードでワークスペースが開きます。ブラウザ上で直接、agent とのやり取り、スキルの設定、スケジュールタスクの構成、ファイル管理を始められます。
Kimi Claw の主な機能
クラウドホスティング： Kimi Claw は gateway をクラウド上で実行するため、ローカルマシンがオフラインでも agent を利用できます。
自動メンテナンス： 更新やパッチ適用はバックグラウンドで処理され、手動セットアップや再起動は不要です。
組み込み機能： タスクスケジューリング、永続ストレージ、プロンプトに基づく動的なスキル読み込みを備え、デバイスをまたいでシームレスに利用できます。
OpenClaw インストール時によくあるエラーのトラブルシューティング
OpenClaw のインストール問題の多くは、PATH 設定、依存関係の不足、ポート競合など、いくつかの一般的なカテゴリに分類されます。以下のセクションでは、macOS、Windows、Linux でよく発生する問題をすばやく特定し、解決する方法を説明します。
インストール後に "openclaw: command not found" と表示される
OpenClaw がシステムの PATH に含まれていません。
修正： npm のグローバル bin ディレクトリを PATH に追加します。
その後、シェルを再読み込みする（例：source ~/.zshrc）か、ターミナルを再起動します。Windows では、環境変数にパスを追加して PowerShell を再起動します。
macOS で Sharp のビルドエラーが発生する
通常は、グローバルにインストールされた libvips が Sharp ライブラリと競合している場合に発生します。
修正： この環境変数を付けてインストールコマンドを実行します。
node-gyp エラーが表示される場合は、Xcode Command Line Tools をインストールします。
再起動後に OpenClaw が起動しない
オンボーディング中にバックグラウンド daemon がインストールされていません。
修正： daemon フラグを付けてオンボーディングを再実行します。
次に、サービスを確認します。
Gateway が応答しない、または "0 tokens used" と表示される
gateway プロセスが停止しているか、API 認証に失敗している可能性があります。
修正： gateway を再起動します。
ヘルスチェックを実行します。
デバッグログを確認するには：
あわせて、API キーが有効であることを確認してください。
ポート 18789 がすでに使用中
別のプロセスが OpenClaw gateway のポートを使用しています。
修正： 競合しているプロセスを見つけて停止します
その後、gateway を再起動します。
EACCES 権限エラー
通常は、npm のグローバルディレクトリに適切な権限がないことを意味します。
修正： ディレクトリの所有者を更新します。
Windows では、PowerShell を管理者として実行するか、カスタム npm prefix を設定します。
Docker 環境では、ボリュームの権限を修正します。
"spawn git ENOENT" エラー
Git がインストールされていないか、PATH から利用できません。
修正： git-scm.com から Git をインストールし、ターミナルを再起動してからインストールを再試行します。
WSL2 で systemd が動作しない
WSL 設定で systemd が有効になっていません。
修正：
/etc/wsl.confを編集して、次を追加します。
その後、WSL を再起動します。
Linux ターミナルを開き直して確認します。
VPS で npm install 中にメモリ不足になる
メモリの少ない VPS インスタンスでは、パッケージのインストール中に失敗することがあります。
修正： スワップファイルを作成します。
その後、インストールを再実行します。
メッセージングプラットフォーム接続時に "Access not configured" と表示される
アカウントが OpenClaw によって承認されていません。
修正： ペアリングコードを使ってアカウントを承認します。
あわせて、bot の認証情報（token、webhook、権限）が正しく設定されていることを確認してください。
まとめ
OpenClaw は macOS、Linux、Windows のいずれでも簡単にインストールできます。環境に応じて、ワンラインスクリプト、PowerShell、WSL2、npm を利用できます。オンボーディングウィザードが、モデル選択、API 設定、メッセージングチャネルの設定を案内します。ローカル環境を管理したくない場合は、Kimi Claw の完全ホスト型オプションを使えば、クラウド上で OpenClaw を直接実行できます。
よくある質問
node --version を実行して、バージョンが最小要件を満たしていることを確認してください。npm install -g openclaw@latest を実行します。これにより CLI が最新版に更新されます。ワンラインインストーラーを再実行しても、既存のインストールが自動でアップグレードされます。OpenClaw は 127.0.0.1:18789 の Control UI からアプリ内アップデートも利用できます。更新後は、新しいバージョンを読み込むために openclaw gateway restart で gateway を再起動してください。openclaw gateway status を実行してください。Windows では、systemd を有効にした WSL2 が、常時稼働させる構成として最も安定しています。ローカルサービスを管理したくない場合は、Kimi Claw のような完全ホスト型の選択肢を使えば、クラウド上で OpenClaw を継続実行できます。