OpenClawをセットアップした手順、
色々詰まった際のポイントや、ブラウザ操作などの用途別のコマンドなどを整理します。
OpenClaw 概要
OpenClaw は「すべてのチャットを一か所に」をコンセプトにした AI エージェントプラットフォームです。
Slack・LINE・Telegram などのチャットアプリに AI エージェントを接続し、ウェブ検索やブラウザ操作まで自動化できます。
目次
OpenClaw の全体像
あなた
│
├─ Slack / LINE / Telegram など ──┐
│ ▼
└─ ターミナル (CLI) ──────► OpenClaw Gateway (常駐サービス)
│
┌───────┼───────┐
▼ ▼ ▼
AI モデル プラグイン チャンネル
(gpt-5.5 等) (browser, brave 等) (Slack 等)
- Gateway — バックグラウンドで動き続けるサーバー。チャット受信→AI処理→返信を担う
-
エージェント — 指示を受けて動く AI の単位。デフォルトは
main - プラグイン — 機能拡張モジュール（ブラウザ操作・ウェブ検索など）
- チャンネル — Slack / LINE などの接続先
インストールと初期セットアップ
前提条件
- Node.js v18 以上（v22 推奨）
- macOS / Linux
# Node のバージョンを確認
node --version # v22.x.x が理想
# OpenClaw をグローバルインストール
npm install -g openclaw@latest
# バージョン確認
openclaw --version
初回セットアップ
# ガイド付きセットアップ（最初はこれだけでOK）
openclaw onboard
onboard コマンドが対話形式で以下をすべてセットアップしてくれます：
- Gateway サービスの登録・起動
- AI プロバイダー（OpenAI 等）の認証
- チャットチャンネルの接続
※ AIプロバイダーについて、
最初はOpenAI APIを利用するのがおすすめですが、ある程度の性能がなければ
ツールを使いこなせない点に注意が必要です。
汎用的に使えるモデルとして、gpt-5.5あたりをセットしておくと良さそうです。
まず覚える 10 コマンド
openclaw help コマンドまたは以下のページで確認可能ですが...とても多い&専門用語多めなので簡単に使うコマンドを整理しました。
| 優先度 | コマンド | 何をするか |
|---|---|---|
| ★★★ | openclaw status |
全体の状態確認（まず迷ったらこれ） |
| ★★★ | openclaw gateway restart |
Gateway を再起動（設定変更後に必須） |
| ★★★ | openclaw doctor --fix |
問題を自動診断・修復 |
| ★★★ | openclaw dashboard |
ブラウザで管理画面を開く |
| ★★☆ | openclaw logs --follow |
リアルタイムログを確認 |
| ★★☆ | openclaw plugins list |
プラグイン一覧を表示 |
| ★★☆ | openclaw agent --agent main --message "テスト" |
エージェントに直接メッセージを送る |
| ★☆☆ | openclaw config get |
現在の設定を表示 |
| ★☆☆ | openclaw channels status |
接続中チャンネルの状態確認 |
| ★☆☆ | openclaw health |
Gateway の詳細ヘルス情報 |
ワンライナーチートシート
# 状態を素早く確認
openclaw status
# 問題があったらまずこれ
openclaw doctor --fix
# 設定を変えたら必ずこれ
openclaw gateway restart
# チャットが返ってこないとき
openclaw logs --follow
目的別ガイド
チャットチャンネルを接続する
Slack
# Slack プラグインをインストール
openclaw plugins install @openclaw/slack
# チャンネル追加（対話形式）
openclaw channels add
# 接続確認
openclaw channels status
その他のチャンネル
openclaw channels add # 対話メニューからチャンネル種別を選択
AI モデルを設定する
# 利用可能なモデルを確認
openclaw models status
# モデルプロバイダーの認証
openclaw configure
OpenAI (gpt-5.5) を使う場合
codex ハーネスプラグインが必要です:openclaw plugins install @openclaw/codex openclaw gateway restart
プラグインを追加する
プラグインは機能追加モジュールです。インストール後は必ず Gateway を再起動してください。
# インストール
openclaw plugins install <プラグイン名>
# 有効化（plugins.allow に追加が必要な場合）
openclaw config set plugins.allow '["codex","slack","browser","brave"]'
# 再起動して反映
openclaw gateway restart
# 一覧確認
openclaw plugins list
主要プラグイン一覧
| プラグイン | npm パッケージ | 機能 |
|---|---|---|
| codex | @openclaw/codex |
OpenAI gpt-5.5 エージェントハーネス |
| slack | @openclaw/slack |
Slack 連携 |
| brave | @openclaw/brave-plugin |
Brave ウェブ検索 |
| browser | (同梱) | Chrome ブラウザ操作 |
注意:
plugins.allowリストに含まれないプラグインは起動しません。
セキュリティのため、使うプラグインだけを明示的に列挙しましょう。
ブラウザ操作を使う
OpenClaw には Google Chrome を操作する機能が内蔵されています。
セットアップ
# browser を plugins.allow に追加
openclaw config set plugins.allow '["codex","slack","browser","brave"]'
openclaw gateway restart
エージェント経由で使う
チャットで普通に指示するだけで OK:
「https://example.com を開いてタイトルを教えて」
「このページのテキストをすべて抜き出して」
CLI で直接使う
openclaw browser open https://example.com
openclaw browser evaluate --fn '() => document.title'
openclaw browser screenshot --output /tmp/screen.png
openclaw browser close t1
ウェブ検索を使う
Brave Search API を使ったウェブ検索機能です。
Chromeブラウザ操作より、素早く情報を検索できるため、OpenClawに使うモデルのトークン削減などに使えます。一方で入力やクリックなどの人間らしい操作にはデフォルトのブラウザ操作が向いています。
セットアップ
- Brave Search API で API キーを取得
- 設定を行う:
# プラグインインストール
openclaw plugins install @openclaw/brave-plugin
# API キーを設定
openclaw config set tools.web.search.enabled true
openclaw config set tools.web.search.provider brave
openclaw config set tools.web.search.apiKey "あなたのAPIキー"
# brave を allow リストに追加
openclaw config set plugins.allow '["codex","slack","browser","brave"]'
# 再起動
openclaw gateway restart
使い方
エージェントに「〇〇について最新情報を検索して」と指示するだけで自動的にウェブ検索します。
問題が起きたとき
手順
# ステップ1: 状態を確認
openclaw status
# ステップ2: 自動修復を試みる
openclaw doctor --fix
# ステップ3: ログを確認
openclaw logs --follow
# ステップ4: Gateway を再起動
openclaw gateway restart
# ステップ5: それでもダメならバージョン確認
openclaw --version
node --version
よくある症状チェック
| 症状 | 最初に試すコマンド |
|---|---|
| チャットが返ってこない | openclaw logs --follow |
| プラグインが動かない |
openclaw plugins list → openclaw gateway restart
|
| 管理画面が開かない |
openclaw dashboard（URLを直打ちしないこと） |
| 接続できない | openclaw gateway restart |
設定ファイルの場所
| ファイル / ディレクトリ | 内容 |
|---|---|
~/.openclaw/openclaw.json |
メイン設定ファイル |
~/.openclaw/logs/gateway.log |
Gateway ログ |
~/.openclaw/logs/gateway.err.log |
Gateway エラーログ |
~/.openclaw/npm/ |
外部プラグインのインストール先 |
~/.openclaw/agents/ |
エージェントのセッション・メモリ |
設定ファイルを直接編集するより openclaw config set を使うほうが安全です。
# 設定を確認
openclaw config get
# 特定のキーを確認
openclaw config get plugins.allow
# 設定を変更
openclaw config set <キー> <値>
よくあるエラーと対処法
SyntaxError: Unexpected token {
原因: Node.js のバージョンが古い (v10 など)
対処:
node --version # v18 未満ならアップデート
# fnm を使っている場合
fnm default system
Requested agent harness "codex" is not registered
原因: codex プラグインが未インストール
対処:
openclaw plugins install @openclaw/codex
openclaw gateway restart
plugins.allow excludes "browser"
原因: plugins.allow リストに "browser" がない
対処:
openclaw config set plugins.allow '["codex","slack","browser","brave"]'
openclaw gateway restart
protocol mismatch / GatewayClientRequestError
原因: 古い Gateway プロセスが残っている
対処:
openclaw gateway restart
管理画面で「認証が一致しません」
原因: URL を直接入力した（トークンなし）
対処: ブラウザに URL を貼らず、ターミナルで以下を実行:
openclaw dashboard # 正しいトークン付き URL でブラウザが開く
まとめ: 最初の 30 分でやること
# 1. インストール
npm install -g openclaw@latest
# 2. セットアップ（対話形式）
openclaw onboard
# 3. 状態確認
openclaw status
# 4. 問題があれば
openclaw doctor --fix
# 5. 管理画面を開く
openclaw dashboard
これだけで基本的な AI エージェントが動き始めます！
バージョン情報: このガイドは OpenClaw 2026.6.x をもとに作成しました。
最新情報:openclaw docsまたは https://docs.openclaw.ai/cli