OpenClawの説明と使い方
OpenClaw は、自分のパソコンやサーバーの上で動かす、AI アシスタント用のツールです。Anthropic・OpenAI・Google などの AI モデルを API キーでつなぎ、ブラウザの画面や Telegram などのチャットアプリから話しかけて使います。この記事では、OpenClaw がどういうものか、インストールから最初のメッセージを送るまでの流れを、公式ドキュメント(2026年10月時点)をもとにまとめます。
対象読者:AI アシスタントを自分の環境で動かしてみたい個人・小規模サイトの運営者や実装者。
この記事は公式ドキュメントの内容を整理したものです。表記は「OpenClaw」(Open + Claw)です。コマンドや設定の細部は版によって変わることがあるため、実行前に公式ドキュメント(docs.openclaw.ai)も確認してください。
1. OpenClaw とは
OpenClaw は、次の 3 つの部品で成り立っています。
| 部品 | 役割 |
|---|---|
| Gateway | 常駐する本体。モデルへの接続、チャットアプリとの中継、ツールの実行を受け持つ(標準のポートは 18789) |
| Control UI | ブラウザで開く管理・チャット画面。openclaw dashboard で開く |
| チャネル | Telegram など、AI に話しかけるための入口。スマートフォンから使いたいときに接続する |
AI モデル自体は OpenClaw が持っているわけではなく、自分で用意した API キーでモデルのサービスに接続します。そのため、利用料金はモデルの提供元に API の使用量に応じて支払う形になります。
2. 準備するもの
- Node.js:22.22.3 以上、24.15 以上、25.9 以上のいずれか(推奨は 24)。インストーラーを使えば、足りない場合は自動で入ります
- モデルプロバイダーの API キー(Anthropic、OpenAI、Google など)
- OS:macOS、Linux、Windows。Windows はネイティブの Windows Hub アプリ、PowerShell のインストーラー、WSL2 上の Gateway のいずれかで始められます
3. インストール
3-1. インストーラースクリプト(推奨)
OS を判別し、必要なら Node を入れ、OpenClaw のインストールからオンボーディングまで進めてくれます。
macOS / Linux / WSL2:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
オンボーディング(次の手順)を後で行いたいときは、--no-onboard(PowerShell では -NoOnboard)を付けます。
3-2. npm などで入れる
自分で Node を管理している場合は、パッケージマネージャーで入れられます。
npm install -g openclaw@latest
pnpm(pnpm add -g openclaw@latest。初回のあとに pnpm approve-builds -g が必要)や bun、Docker、Nix でも入れられます。
3-3. 入ったかどうかの確認
openclaw --version
openclaw doctor
openclaw gateway status
doctor は設定の問題を調べるコマンドです。gateway status で Gateway が動いていることを確認します。
4. 初期設定(オンボーディング)
openclaw onboard --install-daemon
ウィザードに沿って、次のことを設定します。
- モデルプロバイダーを選ぶ
- API キーを入力する
- Gateway を設定する
--install-daemon を付けると、パソコンを起動したときに Gateway が自動で立ち上がるように登録されます。macOS では LaunchAgent、Linux / WSL2 では systemd のユーザーサービス、ネイティブ Windows ではスケジュールタスクが使われます。
選ばなかった項目は、あとから次のコマンドで設定し直せます。
openclaw configure
5. 使い方
5-1. Control UI でチャットする
openclaw dashboard
ブラウザが開き、Control UI が表示されます。画面が読み込まれれば設定は正常です。チャット欄に文章を入力すると、AI が応答します。
5-2. スマートフォンから使う
チャネルを接続すると、チャットアプリから話しかけられます。公式ドキュメントでは、ボットトークンだけで設定できる Telegram が最も手早い方法として案内されています。接続後は、ペアリング(誰が使えるかの登録)でアクセスを制限します。
5-3. よく使うコマンド
| コマンド | 用途 |
|---|---|
openclaw onboard --install-daemon |
初回セットアップ |
openclaw configure |
設定の変更 |
openclaw gateway status |
Gateway の稼働確認 |
openclaw gateway restart |
Gateway の再起動 |
openclaw dashboard |
Control UI を開く |
openclaw doctor |
設定の問題を調べる |
5-4. ツールと Skills
OpenClaw の AI は、ブラウザの操作、コマンドの実行(exec)、Web 検索、Skills、Plugin などのツールを使えます。便利な反面、AI にコマンドを実行させることになるため、何を許可するかは慎重に決めます(次の節)。
6. ハマりやすい点・注意点
6-1. openclaw が見つからない
インストール後に openclaw: command not found と出る場合は、多くは npm のグローバル bin ディレクトリが PATH に入っていないことが原因です。次で確認します。
node -v
npm prefix -g
echo "$PATH"
npm prefix -g で表示された場所の bin(Windows では直下)が PATH に含まれているかを見ます。
6-2. 外から見えない設定にする
Gateway は、自分のパソコンからだけ接続できる設定(ループバック)にするのが基本です。外のネットワークに公開すると、AI にコマンドを実行させる入口を他人に開けることになります。サーバー(VPS)で動かす場合も、公開範囲とアクセス制御を先に決めてください。
6-3. 版を新しく保つ
OpenClaw には、コマンドの許可判定を回避できてしまう脆弱性など、セキュリティ上の問題が過去に報告されています(NVD に CVE として登録されたもの)。古い版を使い続けず、定期的に更新してください。
6-4. アクセストークンと API キーの扱い
オンボーディングで表示されるアクセストークンや、入力した API キーは、他人に見せたり、記事・リポジトリに載せたりしないでください。スクリーンショットを撮るときも写り込みに注意します。
まとめ
- OpenClaw は、自分の環境で動かす AI アシスタントで、Gateway・Control UI・チャネルから成る
- インストールはインストーラースクリプトが手早く、
openclaw onboard --install-daemonで初期設定まで進む - 動作確認は
openclaw doctorとopenclaw gateway status、使い始めはopenclaw dashboard - Gateway は自分のパソコンからだけ接続できる設定にし、版を新しく保つ
詳しい設定やチャネルごとの手順は、公式ドキュメント(docs.openclaw.ai)にあります。
アイキャッチ画像:Image by yeiferr from Pixabay