OpenClawをセットアップした手順、
色々詰まった際のポイントや、ブラウザ操作などの用途別のコマンドなどを整理します。

OpenClaw 概要

OpenClaw は「すべてのチャットを一か所に」をコンセプトにした AI エージェントプラットフォームです。
Slack・LINE・Telegram などのチャットアプリに AI エージェントを接続し、ウェブ検索やブラウザ操作まで自動化できます。

目次

OpenClaw の全体像
インストールと初期セットアップ
まず覚える 10 コマンド
目的別ガイド
設定ファイルの場所
よくあるエラーと対処法

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