初めて OpenClaw を入れるならこの記事：
2026 インストール・設定の完全ガイド（準備から動作確認まで）

0 このチュートリアルで完了すること

最後まで進めば、次の四つを確認できます。① CLI と Gateway が入っている；② モデル provider と API Key がつながっている；③ ブラウザで本機の Control UI が開ける；④ テスト用フォルダで低リスクの読み書きが一度通る。ゴールは「入れた」ではなく、「制御できる範囲で動き、トラブル時に自分で調べられる」ことです。

1 インストール前の準備：Mac・ネットワーク・テスト用フォルダ

やること：作業前に環境を揃える。理由：一つ欠けると途中で何度もやり直しになる。成功の目安：ターミナルを開け、公式インストールドキュメントにアクセスでき、テスト用フォルダを作ってある。

• システム — macOS（Apple Silicon / Intel どちらでも可）。公式は Node 24（推奨）または Node 22.19+。公式インストールスクリプトなら Node は自動処理され、先に Homebrew を入れる必要はありません（任意）。
• ネットワークと管理者権限 — openclaw.ai とモデル各社のサイトに届くこと。設定や LaunchAgent には macOS の管理者パスワードが必要な場合があります。
• モデルアカウント — Anthropic、OpenAI、OpenRouter などから一社選び、API Key（モデルサービスへの認証情報。パスワード同様、共有・Git 公開しない）を取得。
• テスト用ディレクトリ — 例：~/openclaw-test に notes.txt を置く。ワークスペース＝Agent が触ってよい範囲。初回はここだけに限定。

2 インストール：公式ソースのみ、出力は保存

やること：OpenClaw CLI と Gateway を入れる。理由：非公式パッケージは改ざんの恐れがある。成功の目安：openclaw --version でバージョンが表示される。

Mac 推奨（OS 検出・Node 導入・オンボーディングまで自動）：

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

Node を自分で管理している場合：npm install -g openclaw@latest のあと openclaw onboard --install-daemon（macOS バックグラウンドの LaunchAgent を登録）。

終了後はターミナルのバージョンと全文の出力を保存（スクショまたはメモ）。エラー時は公式 Troubleshooting と照合。確認は次の三つ：

openclaw --version · openclaw doctor · openclaw gateway status

3 設定：provider・API Key・設定ファイル

用語だけ先に揃えます（百科にはしません）。モデル provider＝クラウド事業者（Anthropic など）；API Key＝アクセス用の認証情報；環境変数＝ターミナル上の一時設定（例：export ANTHROPIC_API_KEY=...）；設定ファイル＝永続設定、既定は ~/.openclaw/openclaw.json（JSON5）；ローカルモデル＝Ollama など本機推論——初回はクラウド Key だけで十分です。

オンボーディング（provider 選択・Key 貼り付け・既定モデル選択）：

openclaw onboard --install-daemon

成功の目安：openclaw doctor にブロックするエラーがない；Dashboard または CLI で「こんにちは」と送り、モデルから返答がある。失敗時はまず：Key のコピー漏れ・余分な空白、残高/利用上限、プロキシによる HTTPS 遮断。

4 権限：初回はテスト用フォルダだけ

やること：Agent が読み書きできるパスを絞り、macOS の許可ダイアログを慎重に扱う。理由：ディスク全体の許可は、Mac 全体を自動化に渡すのと同義。成功の目安：テストは ~/openclaw-test 内だけでファイルの作成・更新ができる。

「ファイルとフォルダ」「自動化」「アクセシビリティ」などの表示名は macOS のバージョンで変わります——画面の表記どおりに確認してください。推奨：

• テスト用フォルダだけにチェック。最初から「ディスク全体」や iCloud のルートは与えない。
• カレンダー・連絡先・画面収録など、初回の動作確認に不要な権限はいったん拒否し、必要になったら付与。
• Gateway のポートをインターネットに晒さない。自宅では本機または VPN 経由で十分。

5 Dashboard を開く：本機アドレスとリモート Mac

やること：ブラウザで Control UI を開く。理由：Gateway の稼働とセッションを視覚的に確認するため。成功の目安：ページが表示され、メッセージを送れる。

ターミナルで openclaw dashboard、またはブラウザで公式の既定アドレス http://127.0.0.1:18789/（本機のみ）。

ログはトラブルシュートの根拠です。Gateway 異常時は openclaw doctor の出力と公式 Help / Troubleshooting を照合し、感覚だけで設定をいじらないでください。

6 初回実行：低リスクのテストタスク

~/openclaw-test/notes.txt に二行書く（例：「プロジェクトコード名：Alpha」）。Dashboard または CLI で次を送る：

openclaw-test フォルダの notes.txt を読み、三文で要約し、同じフォルダに summary.md を書いてください。

動作確認できたとみなす条件：① 返答がファイル内容と一致；② フォルダに summary.md ができる；③ openclaw doctor が引き続き正常；④ ログにリクエスト記録がある（空ではない）。書き込み失敗時は、まず macOS のファイルアクセス拒否を疑い、モデルの性能を疑わない。

7 初心者によくあるエラー

8 Mac mini なら OpenClaw の常駐が楽

OpenClaw はセルフホスト型 Gatewayです。常時オンラインかつ権限の境界を守るには、メインの MacBook に載せると日常作業とリソースを奪い合います。Mac mini M4 は小型で待機時の消費電力はおおよそ 4W 級、静音で 24/7 に向きます。macOS のネイティブ Unix 環境では公式インストールスクリプト、LaunchAgent、SSH メンテがスムーズ。Gatekeeper・SIP・FileVault で専用アカウントとテスト用フォルダに閉じ込めやすい。家庭や小チームの常駐ノードなら Mac mini M4 はコスパの良い選択です——まず手元でテストを通し、専用 Mac mini へ移して長期運用する流れがおすすめです。