2026 OpenClaw 完全インストール・設定ガイド：ゼロから動かすまでの手厚いチュートリアル

2. よくあるつまずき

1. 制約：「起動できた」で終わる説明。ターミナルの歓迎メッセージは、モデル接続・ファイルツール・ゲートウェイ受信を意味しません。実用には依存と Node バージョン、onboard とモデル、18789 Gateway、Dashboard、権限境界、ログ追跡、低リスク検収が揃う必要があります。
2. 隠れコスト：キーとパスの散在。API Key がメモだけ、openclaw.json5 と .env が不一致、作業区がホーム全体——一度の誤操作で SSH 鍵や本番リポを壊すリスクがあります。
3. 安定性と監査：ログの場所を忘れる。問題時にいきなり再インストールすると ~/.openclaw/logs/errors.log の手がかりを消します。バックアップなしのアップグレードは設定ロールバックも困難です。

3. インストール前の準備：Mac と環境チェックリスト

目的：途中でネットワーク・Git・ディスク不足に気づかないようにする。合格基準：下の項目をすべて満たしてから install スクリプトを実行。

• システム：macOS 12+（Intel / Apple Silicon 可。ローカル推論は Apple Silicon が有利なことが多いが、クラウドモデルは provider ドキュメント準拠）。
• Git：公式インストーラは macOS 13+、安定ネット、モデル provider アカウントを推奨（git --version ≥ 2.30 推奨）。未導入なら Xcode Command Line Tools または brew install git。
• ネットワーク：GitHub raw（install スクリプト）と選んだ LLM API に到達できること。社内プロキシは HTTPS_PROXY を事前設定。
• ディスク：公式 install は Python 3.11、Node.js v22、ripgrep、ffmpeg 等を取得。空き ≥ 2GB 推奨（Skills キャッシュ込みで 1.5–3GB 程度のことも、当時のドキュメントで確認）。
• 権限：一般ユーザー install に sudo は不要。root で入れた履歴があるとデータは /root/.openclaw の可能性あり。
• バックアップ：既存 ~/.openclaw があるなら cp -a ~/.openclaw ~/.openclaw.bak-$(date +%F)。
• テストディレクトリ：隔離作業区 ~/openclaw-lab を作成。初回実践は ~/Documents、本番 git、鍵入りディレクトリに向けない。

# インストール前クイックチェック（まとめて実行可）
git --version
sw_vers
df -h ~
mkdir -p ~/openclaw-lab/{inbox,outbox,archive}
echo "OpenClaw lab sample: Q2 planning notes." > ~/openclaw-lab/inbox/sample.txt

失敗時に先に見る：Git エラー → CLT/Homebrew；ディスク不足 → Downloads 整理；タイムアウト → ネット変更。原因未確認のまま三連続再インストールは避ける。

4. 公式手順で OpenClaw をインストール

目的：公式が保守する install 入口で Node と CLI を任せる。出典：公式 Installation ドキュメント（公開前にバージョン・追加フラグを再確認）。

4.1 推奨：公式 install.sh（macOS / Linux）

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

# インストールのみ、onboard は後で：
# curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

インストーラが OS を検出し、必要なら Node（ドキュメント推奨 Node 24 または Node 22.19+）と OpenClaw CLI を入れます。典型パス（現行ドキュメント準拠、公開前に再確認）：

• ユーザー設定：~/.openclaw/（openclaw.json5、secrets/、状態・ログ）
• Gateway 既定ポート：18789（ローカル Control UI / WebSocket）
• macOS 常駐：openclaw onboard --install-daemon で LaunchAgent 登録

4.2 初期化：onboard ウィザード

openclaw onboard --install-daemon

# インストール検証（公式推奨の三連）：
openclaw --version
openclaw doctor
openclaw gateway status

ウィザードでモデル provider、API Key、Gateway を設定。不明な install スクリプトは実行しない。鍵を git やチャット画像に載せない。

4.3 インストール後に必ず記録

source ~/.zshrc          # または新しいターミナル
openclaw --version         # バージョンをメモ（後の切り分け用）
openclaw doctor            # 不足検出；--fix で修復試行可

合格基準：which openclaw が PATH 上の openclaw（多くは npm グローバル bin）を指す；openclaw doctor にブロッキング FAIL なし。失敗時に先に見る：スクリプト末尾 20 行 → PATH → Node バージョン不足、または npm グローバル bin 未設定。

注意：失敗直後に「~/.openclaw を消して再インストール」しない——ターミナル出力と openclaw doctor を保存し、ネットか権限かを切り分ける。

5. モデルと API Key の設定

目的：選んだ LLM provider を Agent が呼べるようにする。合格基準：非対話スモークで妥当な応答；openclaw auth list または .env に項目があり、shell history に平文が残り続けない。

5.1 対話式設定（初回推奨）

openclaw onboard        # 対話ウィザード：モデル、キー、Gateway（--install-daemon と併用可）
# キーは auth-profiles / 環境変数でも注入可（公式 Authentication 参照）

5.2 環境変数と設定ファイル

主設定は ~/.openclaw/openclaw.json5、キー参照は ~/.openclaw/.env が多い（openclaw config path、openclaw config env-path で実パス確認）。例（変数名は provider 最新ドキュメント準拠、古い名前をそのままコピーしない）：

# 例：OpenRouter（自分の key に置換、git にコミットしない）
openclaw config set OPENROUTER_API_KEY "sk-or-v1-xxxxxxxx"

# または .env を直接編集（chmod 600 ~/.openclaw/.env）
echo 'OPENROUTER_API_KEY=sk-or-v1-xxxxxxxx' >> ~/.openclaw/.env

境界：価格・クォータ・地域・プライバシーは provider 次第で変わります。本記事は特定モデル名に固定しません。運用前に最新条項を確認してください。

6. 作業ディレクトリ・権限・ログ

目的：導入後に「追跡・制限・ロールバック」できる状態にする。原則：最小権限——まずテスト dir のみ、本番プロジェクトは段階的に。

• 作業区：openclaw.json5 またはセッションで ~/openclaw-lab。AGENTS.md で許可ツールと境界を書ける（公式 Context Files 参照）。
• macOS 権限：ターミナル／ファイル系ツールで「フルディスクアクセス」が出ることがある——初回検収はテスト dir 関連のみ、ディスク全体は避ける。
• ログ：既定 ~/.openclaw/logs/（agent.log、errors.log、gateway.log）。openclaw logs list、openclaw logs errors --since 30m。
• キー安全：chmod 600 ~/.openclaw/.env；バックアップ zip を同期ドライブに置かない；Agent に ~/.ssh、決済、本番 kubeconfig を読ませない。
• バックグラウンド（任意）：Telegram/Discord 等は openclaw gateway setup と openclaw gateway install。長期運用はOpenClaw 7×24 ゲートウェイ運用ガイドを参照。

合格基準：「~/openclaw-lab のみ R/W」と指示後、ホーム外パスは拒否されるかログに監査痕が残る。

7. Dashboard を開き Gateway を検証（ポート 18789）

目的：Control UI と WebSocket Gateway が正常か確認。合格基準：ローカル http://127.0.0.1:18789 が表示；openclaw gateway status で 18789 待ち受け。

openclaw gateway status
openclaw dashboard
# ブラウザ直アクセス：
# http://127.0.0.1:18789/

# リモート Mac（SSH 転送。18789 をインターネットに晒さない）：
# ssh -L 18789:127.0.0.1:18789 user@remote-mac

# ポート占有の切り分け：
lsof -i :18789
openclaw gateway restart
openclaw doctor --fix

失敗時に先に見る：ポート占有 → lsof で競合プロセス終了；Dashboard 空白だが status 正常 → キャッシュまたは WebSocket プロキシ；リモート失敗 → SSH ローカル転送のみか確認。launchd：--install-daemon 済みなら Mac 再起動後も openclaw gateway status が running。違う場合は LaunchAgent ログとユーザー一致を確認（環境変数・SecretRef・LaunchAgent Runbook）。

8. 初回検収：七ステップ Runbook

次の七ステップで「設定完了」から「実戦可用」へ。できるだけそのまま実行し、出力またはログ断片を残してください。

1. 診断：openclaw doctor --fix → 未処理 FAIL なし。
2. モデル ping：openclaw agent --message "Reply with exactly: OPENCLAW_OK" → 応答に OPENCLAW_OK。
3. ファイル読取：~/openclaw-lab/inbox/sample.txt を読み先頭文を要約。
4. ファイル書込：~/openclaw-lab/outbox/ping.txt に書き cat で確認。
5. ログ：openclaw logs errors --since 10m → 新規 ERROR なし（既知の無視可項目はメモ）。
6. ターミナル再起動：ウィンドウを閉じ新規で手順 2 を再実行 → PATH が session 限定でないか確認。
7. 任意で Mac 再起動：再起動後に手順 2（gateway 済みなら openclaw gateway status も）。

引用可能な目安（個人検収、公式 SLA ではない）：スモーク応答 < 60 秒；10 分以内の未説明 ERROR は 0；書込後 ls -la ~/openclaw-lab/outbox に新ファイル。

9. 最初の実践ケース：要約 + ToDo + ロールバック可能な出力

シナリオ：テスト dir でサンプルを読み、日本語で 150 字以内の要約と ToDo 3 件を Markdown に書き、バックアップを残す。インストール（CLI）、設定（モデル）、workflow（読取→推論→書込→ログ）を一度に検証します。

# 1. 入力準備（第 3 節で作成済みならスキップ可）
cat > ~/openclaw-lab/inbox/weekly-notes.txt <<'EOF'
今週完了：OpenClaw インストール文書の下書き。
フォロー：OpenRouter の予算アラート設定；来週 Telegram 接続を評価。
リスク：API Key を git にコミットしない。
EOF

# 2. 対話セッション開始
openclaw
# セッション内プロンプト例：
# 「~/openclaw-lab のみ使用。inbox/weekly-notes.txt を読み、
#   日本語で 150 字以内の要約と ToDo 3 件を outbox/summary-and-todos.md に保存し、
#   原稿を archive/weekly-notes.bak にコピーして」

# 3. 非対話検収
ls -la ~/openclaw-lab/outbox/summary-and-todos.md
ls -la ~/openclaw-lab/archive/
openclaw logs agent -n 30 --since 15m

合格基準：

• summary-and-todos.md に要約と ToDo 3 件があり、原文と意味が一致。
• archive/ にバックアップ、diff で比較可。
• ログに tool call；provider の請求画面に今回の呼び出し（コスト確認用）。

ロールバック：rm ~/openclaw-lab/outbox/summary-and-todos.md && cp ~/openclaw-lab/archive/weekly-notes.bak ~/openclaw-lab/inbox/weekly-notes.txt。失敗時に先に見る：コンテキスト切れで未読 → outbox 書込権限 → errors.log の tool エラー。

10. よくあるトラブル：層ごとに切り分け、盲目的な再インストールを避ける

公開前ファクトチェック（編集者向け）：公式 install.sh URL、最低 macOS、既定ディレクトリ、CLI サブコマンド、provider 環境変数名、ログパス——いずれか変わったら先に文書を更新。読者は：openclaw doctor → errors.log → 最後に再インストール、の順を覚えておけば十分です。

11. 次の拡張：テスト dir から本番 workflow へ

検収後は次のペースで広げ、いきなり本番リポジトリや決済系には接続しない：

1. 実プロジェクト dir を 1 つだけホワイトリストに。依然 ~/.ssh とグローバル * 読み書きは禁止。
2. openclaw cron で低リスク日次タスク（例：ダウンロード一覧——対象はテスト dir のみ）。
3. メッセージゲートウェイ 1 つ（Telegram/Discord）をペアリング制限付きで有効化（公式 Security 参照）。
4. 週次 openclaw backup --quick の後、長期運用記事でアップグレード／ロールバック演習。