はじめに

目標：無理のない既定値で、ゼロ → 最初のチャット成功 まで最速で到達する。

最速でチャットする： コントロール UI を開きます（チャネル設定不要）。openclaw dashboard を実行

その後ブラウザでチャットするか、Gateway ホストで http://127.0.0.1:18789/ を開きます。

ドキュメント：Dashboard と Control UI。

推奨ルート： CLI オンボーディングウィザード（openclaw onboard）を使います。次をセットアップします：

• モデル/認証（OAuth 推奨）
• Gateway 設定
• チャネル（WhatsApp/Telegram/Discord など）
• ペアリング既定値（安全な DM）
• ワークスペースのオンボーディング + スキル
• 任意のバックグラウンドサービス

より詳しいリファレンスが必要なら：ウィザード、セットアップ、ペアリング、セキュリティ。

サンドボックスの注意： agents.defaults.sandbox.mode: "non-main" は session.mainKey（既定 "main"）を利用するため、グループ/チャネルのセッションがサンドボックス化されます。メインエージェントを常にホスト上で動かしたい場合は、エージェントごとに明示的な上書きを設定します：

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/.openclaw/workspace",
        "sandbox": { "mode": "off" }
      }
    }
  }
}

• Node >=22
• pnpm（任意。ソースからビルドする場合は推奨）
• 推奨： Web 検索用の Brave Search API キー

最も簡単：openclaw configure --section web（tools.web.search.apiKey を保存）。

Web ツール を参照。

macOS：アプリをビルドする予定なら Xcode / CLT を導入してください。CLI + Gateway のみなら Node だけで十分です。

Windows：WSL2（Ubuntu 推奨）を利用してください。ネイティブ Windows は未検証で、ツール互換性も低めです。参照：Windows (WSL2)。

curl -fsSL https://openclaw.bot/install.sh | bash

インストールの選択肢（シェル種別、非対話、GitHub からなど）：Installation。

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

別案（グローバルインストール）：

npm install -g openclaw@latest

pnpm add -g openclaw@latest

openclaw onboard --install-daemon

選択が必要な項目：

• ローカル vs リモート Gateway
• 認証：OpenAI Code（Codex）サブスク（OAuth）または API キー。Anthropic は API キー推奨（claude setup-token も対応）。
• プロバイダー：WhatsApp の QR ログイン、TG/Discord の bot トークンなど
• デーモン：バックグラウンド導入（launchd/systemd）
• ランタイム：Node（推奨。WhatsApp/TG では必須）。Bun は 非推奨。
• Gateway トークン：既定でウィザードが生成し、gateway.auth.token に保存します。

ウィザードのドキュメント：Wizard

• Anthropic の推奨： API キーを設定（ウィザードがサービス向けに保存できます）。Claude Code の資格情報を流用したい場合は claude setup-token も利用できます。
• OAuth 資格情報（旧インポート）：~/.openclaw/credentials/oauth.json
• Auth Profile (OAuth + API Keys): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json

ヘッドレス/サーバーのヒント：最初はデスクトップで OAuth を完了し、oauth.json を Gateway ホストへコピーします。

オンボーディング中にサービスを導入した場合、Gateway はすでに動いているはずです：

openclaw gateway status

手動起動（フォアグラウンド）：

openclaw gateway --port 18789 --verbose

Dashboard (localhost): http://127.0.0.1:18789/

トークンを設定している場合、Control UI の設定に貼り付けてください（connect.params.auth.token に保存）。

openclaw channels login

WhatsApp → 設定 → 連携デバイス からスキャンします。

WhatsApp ドキュメント：WhatsApp

ウィザードはトークン/設定を書き込めます。手動で設定したい場合はここから：

• Telegram: Telegram
• Discord: Discord
• Mattermost（プラグイン）: Mattermost（プラグイン）

TG DM のヒント： 最初の DM ではペアリングコードが返ってきます。次の手順で承認しないと bot は返信しません。

既定：未認証の DM にはショートコードを返し、承認されるまでメッセージを処理しません。

最初の DM に返信がない場合は、ペアリングを承認します：

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <code>

ペアリングのドキュメント：Pairing

OpenClaw 自体を開発する場合は、ソースから実行します：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
openclaw onboard --install-daemon

グローバルインストールしていない場合、リポジトリ内で pnpm openclaw ... からオンボーディングを実行してください。

pnpm build は A2UI アセットもバンドルします。必要なだけなら pnpm canvas:a2ui:bundle を使ってください。

Gateway（このリポジトリから）：

node openclaw.mjs gateway --port 18789 --verbose

新しいターミナルでテストメッセージを送ります：

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

openclaw health が「認証未設定」と表示する場合、ウィザードに戻って OAuth/キー認証を設定してください（設定がないとエージェントは返信できません）。

ヒント：openclaw status --all は貼り付けやすい読み取り専用のデバッグレポートです。

ヘルスプローブ：openclaw health（または openclaw status --deep）は稼働中の Gateway にヘルススナップショットを問い合わせます。

• macOS メニューバーアプリ + ウェイクワード: macOS メニューバーアプリ + ウェイクワード
• iOS/Android ノード（Canvas/Camera/Voice）: iOS/Android ノード（Canvas/Camera/Voice）
• リモートアクセス（SSH トンネル / Tailscale Serve）: リモートアクセス（SSH トンネル / Tailscale Serve）
• Tailscale: Tailscale
• 常駐実行 / VPN 設定: リモートアクセス（SSH トンネル / Tailscale Serve）, exe.dev（VM）, Hetzner