OpenClaw導入ガイド：5分で環境構築と初期設定を完了する

困ったときは？ — 最速で解決する方法

自分のマシンを直接「見ることができる」ローカル AI エージェントを活用しましょう。Discord で質問するよりもずっと効果的です。なぜなら、多くの場合「動かない」原因は、外部のヘルパーが確認できないローカルな設定や環境の問題だからです。

Claude Code: https://www.anthropic.com/claude-code/
OpenAI Codex: https://openai.com/codex/

これらのツールは、リポジトリの読み取り、コマンドの実行、ログの確認を行い、マシンレベルのセットアップ（PATH、サービス、権限、認証ファイル）の修正をサポートしてくれます。以下の git インストール方法を使って、ソースコード全体を AI に読み込ませてください。

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

まずは以下のコマンドから始めましょう（助けを求める際は、これらの出力を共有してください）。

openclaw status
openclaw models status
openclaw doctor

OpenClaw の推奨されるインストールとセットアップ方法

公式の推奨方法は、ソースから実行し、オンボーディングウィザードを使用することです。

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

ウィザードは UI アセットのビルドも自動で行います。オンボーディング完了後は、通常ポート 18789 で Gateway を実行します。

ソースから実行する場合（コントリビューターや開発者向け）:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
openclaw onboard

オンボーディング後にダッシュボードを開くには？

オンボーディングが完了すると、ウィザードがトークン付きのダッシュボード URL をブラウザで自動的に開き、サマリーにもフルリンク（トークン付き）を表示します。そのタブは開いたままにしておいてください。もし自動で開かなかった場合は、表示された URL を同じマシンのブラウザにコピー＆ペーストしてください。

ローカルホストとリモート環境でのダッシュボード認証（トークン）について

ローカルホスト（同じマシン）の場合:

http://127.0.0.1:18789/ を開きます。
認証を求められたら、openclaw dashboard を実行し、トークン付きのリンク（?token=...）を使用してください。

ローカルホスト以外の場合:

Tailscale Serve（推奨）: ループバックへのバインドを維持したまま、openclaw gateway --tailscale serve を実行します。
Tailnet bind: openclaw gateway --bind tailnet --token "<token>" を実行します。
SSH tunnel: ssh -N -L 18789:127.0.0.1:18789 user@host を使用します。

必要なランタイムは何ですか？

Node.js 22以上が必要です。パッケージマネージャーは pnpm をおすすめします。Gateway については、Bun はおすすめしません。

Raspberry Pi で動きますか？

はい、動きます。Gateway は軽量に設計されています。ドキュメントでは、個人利用なら 512MB〜1GB の RAM、1コア、約 500MB のディスク容量があれば十分とされています。Raspberry Pi 4 でも動作します。

もしログの保存やメディア処理、他のサービスも動かしたいといった余裕が欲しい場合は、2GB あると安心です。

ヒント：小さな Raspberry Pi や VPS で Gateway を動かし、手元のノート PC やスマートフォンを nodes として連携させれば、ローカルの画面やカメラ、Canvas 機能を利用できます。

Raspberry Pi にインストールする際のコツはありますか？

64-bit OS を使い、Node.js は 22 以上を維持してください
ログの確認や素早いアップデートができるよう、hackable (git) install を選ぶのが良いでしょう
最初は channels や skills を入れずに開始し、一つずつ追加していくのがコツです
もしバイナリ関連の奇妙なエラーが出た場合は、大抵 ARM の互換性 が原因です

「wake up my friend」で止まってしまう / オンボーディングが完了しない場合は？

その画面は、Gateway が接続可能で、かつ認証されている状態に依存しています。

Gateway を再起動します：
Terminal window
```
openclaw gateway restart
```

ステータスと認証を確認します：

openclaw status
openclaw models status
openclaw logs --follow

それでも解決しない場合は、こちらを実行してください：
Terminal window
```
openclaw doctor
```

オンボーディングをやり直さずに、新しいマシン（Mac miniなど）へ設定を移行できますか？

はい、可能です。state directory と workspace をコピーして、一度 Doctor コマンドを実行するだけで済みます。

具体的な手順は以下の通りです：

新しいマシンに OpenClaw をインストールします
旧マシンから $OPENCLAW_STATE_DIR（デフォルト：~/.openclaw）をコピーします
自分の workspace（デフォルト：~/.openclaw/workspace）をコピーします
openclaw doctor を実行し、Gateway サービスを再起動します

この手順で、設定、auth プロファイル、WhatsApp の認証情報、セッション、そしてメモリの内容がすべて保持されます。

最新バージョンの更新内容はどこで確認できますか？

GitHub の changelog を確認してください：https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

stable版とbeta版の違いは何ですか？

stable と beta は npm dist-tags の名称であり、それぞれ独立したコードラインがあるわけではありません。

latest = stable（安定版）
beta = テスト用の先行ビルド

私たちはまず beta にビルドをリリースしてテストを行い、動作が安定したことを確認した上で、その同じバージョンを latest に昇格させています。

beta版をインストールするにはどうすればいいですか？

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

開発やカスタマイズが可能な（git）インストールを行う場合は、以下のコマンドを使用してください：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

インストールとオンボーディングにはどのくらいの時間がかかりますか？

OpenClawのセットアップはとてもスピーディーです。

インストール: 2〜5分
オンボーディング: 5〜15分（設定するチャネルやモデルの数によって変わります）

インストーラーが止まってしまいました。詳細な情報を確認するにはどうすればよいですか？

もしインストーラーが途中で止まってしまった場合は、verbose output（詳細出力）を有効にして再実行してみてください。

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

Windowsでのインストール時に「git not found」や「openclaw not recognized」と表示されます

Windows環境でよくある問題と解決策をまとめました。

1) npm error spawn git / git not found

Git for Windowsをインストールし、gitがPATHに通っていることを確認してください。
PowerShellを一度閉じてから開き直し、再度インストーラーを実行します。

2) インストール後に openclaw が認識されない

npmのグローバルbinフォルダがPATHに含まれていない可能性があります。
npm config get prefix を実行してパスを確認してください。
<prefix>\bin がPATHに含まれていることを確認しましょう。

Windowsで最もスムーズに利用したい場合は、ネイティブのWindows環境よりも WSL2 を使うのがおすすめです。

LinuxにOpenClawをインストールするにはどうすればよいですか？

Linuxガイドの手順に従ってから、オンボーディングウィザードを実行してください。

Linuxのクイックパスとサービスインストール: Linux
詳細なウォークスルー: Getting Started

OpenClawをVPSにインストールするには？

どんなLinux VPSでも大丈夫です。サーバーにインストールした後、SSHやTailscaleを使ってGatewayにアクセスしてください。

ガイドはこちら：Hetzner, Fly.io, exe.dev

OpenClawに自分自身をアップデートさせることはできますか？

簡潔に答えると、可能ですがおすすめしません。アップデートのプロセスでGatewayが再起動してアクティブなセッションが切れてしまうほか、クリーンなgit checkoutが必要になったり、確認のプロンプトが表示されたりすることがあるからです。より安全なのは、オペレーターとしてシェルからアップデートを実行する方法です。

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev

オンボーディングウィザードは具体的に何をしますか？

openclaw onboardを実行すると、以下のステップを順にガイドしてくれます：

Model/auth setup（Anthropic setup-token, OpenAI Codex OAuth, API keys, local models）
Workspaceの場所とbootstrapファイルの作成
Gateway settings（bind/port/auth/tailscale）
Providers（WhatsApp, Telegram, Discord, Signal, iMessage）
Daemon install（macOSではLaunchAgent、Linux/WSL2ではsystemd user unit）
Health checksとskillsの選択

これを実行するにはClaudeやOpenAIのサブスクリプションが必要ですか？

いいえ、必要ありません。OpenClawはAPI keys（Anthropic/OpenAI/その他）で動かすことができますし、データがデバイスに残るlocal-only modelsも利用可能です。サブスクリプションは、それらのプロバイダーを認証するための選択肢の一つに過ぎません。

API key なしで Claude Max サブスクリプションを使えますか？

はい、可能です。API key の代わりに setup-token を使って認証できます。これがサブスクリプションを利用する方法です。

Anthropic の setup-token 認証はどのように機能しますか？

claude setup-token を実行すると、Claude Code CLI を通じて token string が生成されます（Web コンソールでは取得できません）。これは どのマシン でも実行可能です。ウィザードで Anthropic token (paste setup-token) を選択するか、以下のコマンドで貼り付けてください。

openclaw models auth paste-token --provider anthropic

Anthropic の setup-token はどこで見つかりますか？

Anthropic Console には ありません。setup-token は Claude Code CLI で生成します。

claude setup-token

表示されたトークンをコピーして、ウィザードで Anthropic token (paste setup-token) を選んでください。

なぜ Anthropic から `HTTP 429: rate_limit_error` が表示されるのですか？

現在の期間における Anthropic quota/rate limit が上限に達しています。Claude subscription を利用している場合は、制限がリセットされるのを待つか、プランをアップグレードしてください。Anthropic API key を利用している場合は、Anthropic Console で利用状況や支払い設定を確認してください。

ヒント：fallback model を設定しておくと、プロバイダーが制限されている間も OpenClaw が応答を続けることができます。

AWS Bedrock はサポートされていますか？

はい、サポートされています。pi-ai の Amazon Bedrock (Converse) プロバイダーを使い、manual config を行うことで利用できます。Gateway ホスト側で AWS の認証情報と Region を設定し、models config に Bedrock プロバイダーのエントリを追加してください。

Codex の認証はどのように機能しますか？

OpenClaw は、OAuth（ChatGPT ログイン）経由で OpenAI Code (Codex) をサポートしています。セットアップウィザードから OAuth フローを実行することができ、必要に応じてデフォルトモデルを openai-codex/gpt-5.2 に設定します。

Gemini CLI の OAuth はどのように設定しますか？

Gemini CLI では plugin auth flow を使用します。以下のコマンドを実行してください。

openclaw plugins enable google-gemini-cli-auth
openclaw models auth login --provider google-gemini-cli --set-default

カジュアルなチャットにローカルモデルを使っても大丈夫ですか？

通常はお勧めしません。OpenClaw は大きな context と強力な safety 機能を必要とするため、小規模なモデルでは内容が切り捨てられたり（truncate）、情報が漏洩したりする可能性があります。どうしても必要な場合は、LM Studio などを使用して、ローカルで実行可能な largest な MiniMax M2.1 ビルドを動かしてください。

強い警告：モデルのサイズが小さかったり、quantized（量子化）されていたりすると、prompt-injection のリスクが高まります。

インストールには Mac Mini を購入する必要がありますか？

いいえ、その必要はありません。OpenClaw は macOS または Linux（Windows の場合は WSL2）で動作します。Mac mini は「常時稼働させるホスト」として選ばれることもありますが、選択肢の一つに過ぎません。小型の VPS やホームサーバーでも十分に動作します。

Mac が必要になるのは、macOS 専用のツール を使用する場合のみです。iMessage を利用したい方は、BlueBubbles（推奨）をチェックしてみてください。

iMessage のサポートには Mac mini が必要ですか？

Messages にサインインしている 何らかの macOS デバイス が必要です。Mac mini に限定されるわけではなく、どの Mac でも大丈夫です。iMessage の連携には BlueBubbles（推奨）の使用をおすすめします。

Bun は使えますか？

Bun は 推奨していません。特に WhatsApp や Telegram において、実行時のバグが報告されています。Gateway を安定して動かすためには、Node を使ってください。

Telegram: `allowFrom` には何を設定すればよいですか？

channels.telegram.allowFrom に設定するのは、送信者（人間）の Telegram ユーザー ID（数字を推奨）または @username です。ボット自身のユーザー名ではないので注意してください。

自分の ID を調べる方法は以下の通りです：

ボットに DM を送り、openclaw logs --follow を実行して from.id を確認する
https://api.telegram.org/bot<bot_token>/getUpdates を呼び出して message.from.id を確認する

1つのWhatsApp番号を複数のOpenClawインスタンスで共有できますか？

はい、multi-agent routingを使えば可能です。各送信者のWhatsApp DMを異なるagentIdに紐付けることで、ユーザーごとに専用のワークスペースとセッションストレージを持たせることができます。

「高速チャット用」エージェントと「コーディング用Opus」エージェントを使い分けることはできますか？

はい、できます。ここでもmulti-agent routingを活用しましょう。各エージェントに個別のデフォルトモデルを設定し、受信ルートをそれぞれのエージェントに紐付けるだけでOKです。

hackable (git) インストールと npm インストールの違いは何ですか？

hackable (git) インストール: ソースコードをすべてチェックアウトする形式です。コードを編集できるため、コントリビューターに最適です。ローカルでビルドを実行し、コードやドキュメントにパッチを当てることも可能です。
npm インストール: グローバルな CLI インストールで、リポジトリは含みません。「とにかく動かしたい」という場合に最適です。アップデートは npm の dist-tags から提供されます。

後から npm インストールと git インストールを切り替えることはできますか？

はい、可能です。もう一方のタイプをインストールしてから、Doctor を実行してください。これにより Gateway サービスが新しいエントリポイントを指すようになります。この操作でデータが削除されることはありません。変更されるのは OpenClaw の実行コードのみです。

Gatewayは自分のノートPCとVPSのどちらで動かすべきですか？

24時間365日の安定性を求めるなら、VPSを使ってください。 手間を最小限に抑えたい、あるいはスリープや再起動による中断が気にならないのであれば、ローカル環境で動かすのが良いでしょう。

ノートPC（ローカルのGateway）

メリット：サーバー費用がかからない、ローカルファイルに直接アクセスできる、ブラウザウィンドウで動作を直接確認できる
デメリット：スリープやネットワークの切断が原因でオフラインになる、OSのアップデートや再起動で処理が中断される

VPS / クラウド

メリット：常にオンライン、安定したネットワーク、ノートPCのスリープを気にしなくていい
デメリット：多くの場合ヘッドレス（画面なし）で動作させる必要がある（スクリーンショット機能を利用）、ファイルへのアクセスがリモート経由になる

OpenClawを専用のマシンで動かすことはどれくらい重要ですか？

必須ではありませんが、信頼性と環境の分離のために推奨しています。

専用ホスト（VPS/Mac mini/Raspberry Piなど）： 常時稼働しており、中断が少ない
共有のノートPC/デスクトップ： テスト目的や、自分が作業している間に動かすのであれば全く問題ありません

VPSの最小要件と推奨OSは何ですか？

OpenClawは軽量な設計です：

最小要件： 1 vCPU, 1GB RAM, 約500MBのディスク容量
推奨要件： 1-2 vCPU, 2GB以上の RAM

OS：Ubuntu LTS（または最新のDebian/Ubuntu系）を使用してください。

OpenClawをVM（仮想マシン）で動かせますか？またその要件は？

はい、可能です。VMもVPSと同じように扱ってください。常に稼働しており、ネットワーク的に到達可能で、Gatewayや有効にする各チャンネルを動かすのに十分なRAMが必要です。

最小要件： 1 vCPU, 1GB RAM
推奨要件： 2GB以上の RAM

Windows環境であれば、WSL2が最も簡単なVMスタイルのセットアップ方法です。

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。