OpenClawの説明と使い方

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

ウィザードに沿って、次のことを設定します。

  1. モデルプロバイダーを選ぶ
  2. API キーを入力する
  3. 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