OpenClaw 導入 mac ガイド
2026年3月21日
title: "OpenClaw 導入 mac ガイド" slug: "openclaw-setup-mac" date: "2026-03-21" description: "OpenClawをMacへ導入したい方向けに、Homebrewでの事前準備、CLI導入、Docker Desktopを使う分岐、権限設定、Gatekeeper対応までをやさしく整理したmacOS向けセットアップガイドです。" primaryKeyword: "openclaw 導入 mac" secondaryKeywords:
- "OpenClaw Mac"
- "OpenClaw macOS インストール"
- "OpenClaw Docker Mac"
- "OpenClaw Homebrew" searchIntent: "howto" audience: "MacでOpenClawを安全にセットアップしたい初心者"
OpenClaw 導入 mac ガイド
MacでOpenClawを導入するときは、いきなり本体を入れるより、まず Homebrew で Node.js と Docker Desktop の有無を整えてから進めると失敗が減ります。この記事では、openclaw 導入 mac を調べている方向けに、macOSでの準備、CLI導入、Dockerを使う場合の分岐、権限とGatekeeperの注意点までを1本でまとめます。
最短で進めたいなら、Homebrew で開発ツールを整えたあと、OpenClaw CLIを入れて初期セットアップを実行し、最後に health 系コマンドで確認する流れが基本です。Dockerを使う場合も、最初にMac側の権限と共有フォルダ設定を意識しておくと詰まりにくくなります。
目次
- OpenClaw を Mac に導入する前に確認すること
- Mac での事前準備: Homebrew と必須ツール
- OpenClaw を macOS に導入する基本手順
- Docker Desktop を使って Mac で動かす場合
- macOS の権限と Gatekeeper で注意すること
- Mac でよくある詰まりと対処法
- FAQ
- まとめ
OpenClaw を Mac に導入する前に確認すること
まず押さえたいのは、OpenClaw自体のセットアップより前に、Mac側の実行環境が整っているかどうかです。OpenClawの公式ドキュメントでは、Node.jsは 24 系推奨、最低でも 22.16 以上が目安とされています。
最初に確認するコマンドは次の2つです。
node -v npm -v
node が入っていない、またはバージョンが古い場合は、そのまま進めず先に更新したほうが安全です。openclaw 導入 mac でつまずく原因の多くは、OpenClaw本体より先に Node.js の版ずれやPATH設定にあります。
Mac での事前準備: Homebrew と必須ツール
Homebrew が入っているか確認する
Macで開発系ツールをそろえるなら、まず Homebrew があると管理が楽です。
brew --version
まだ未導入なら、Homebrew公式サイトのインストール手順を使って先に導入してください。この記事では具体的なワンライナーを固定せず、公式ページの最新手順に従う前提で進めます。
Node.js を Homebrew で用意する
Homebrewを使う場合は、OpenClawを入れる前に Node.js を最新の安定版へそろえるのが分かりやすいです。
brew install node
すでにNodeが入っている場合は、版だけ確認して条件を満たしていれば問題ありません。複数のNode管理ツールを併用しているMacでは、which node も一緒に見ると切り分けしやすくなります。
which node which npm
Docker を使う予定なら Docker Desktop も確認する
OpenClawをMacでコンテナ実行したい場合は、Docker Desktop for Mac が必要です。インストール後は、アプリが起動していて docker と docker compose が使えるかを確認します。
docker --version docker compose version
docker compose が返らない場合は、Docker Desktopの起動前か、初回セットアップが終わっていない可能性があります。Macではアプリを入れただけで終わりではなく、初回起動と利用規約の確認まで済ませておく必要があります。
OpenClaw を macOS に導入する基本手順
1. OpenClaw CLI をインストールする
OpenClaw CLIを使う標準的な導入フローでは、Node環境が整ったあとに次のようにCLIを入れます。
npm install -g openclaw@latest
インストール後は、まずコマンドが見えているかを確認します。
openclaw --help
ここで command not found が出るなら、インストール失敗というよりPATH反映の問題であることが多いです。ターミナルを開き直すか、Nodeのグローバル実行パスが現在のシェル設定に含まれているかを確認してください。
2. 初回セットアップを実行する
CLIが認識されたら、初回セットアップを進めます。
openclaw onboard --install-daemon
このセットアップでは、利用するモデル認証、作業ディレクトリ、Gatewayの基本設定などを順に確認できます。Macで最初に試す段階なら、外部サービス連携や公開設定は後回しにして、ローカルだけで完結する構成から始めるほうが安全です。
3. 状態確認をして導入完了を判断する
導入できたかどうかは、インストール完了メッセージより、状態確認コマンドが返るかで判断するのがおすすめです。
openclaw health openclaw status --deep openclaw doctor
この3つが通れば、少なくともMac上での基本導入はかなり安定しています。逆にどれかが失敗するなら、チャネル連携やDocker化へ進む前に、まずローカルセットアップの整合性を見直したほうが早いです。
Docker Desktop を使って Mac で動かす場合
Docker 利用が向いているケース
次のどれかに当てはまるなら、MacでもDocker運用が向いています。
- ローカル環境をなるべく汚したくない
- 検証環境を消しやすくしたい
- 後からVPSやLinux環境へ寄せたい
一方で、最速で試したいだけなら、最初はCLIだけで始めるほうがシンプルです。
Docker で進める前の確認
OpenClawのDocker構成を使う場合は、次の前提を満たしているか先に見ます。
docker --version docker compose version
あわせて、Docker Desktopの設定画面で共有対象になっているフォルダを確認しておくと安心です。Macでは、Desktop や Documents 配下をコンテナにマウントするとき、Docker Desktopやターミナルアプリにファイルアクセス許可が必要になる場合があります。
Docker の高レベル手順
MacでDockerセットアップを進める場合の大まかな流れは次のとおりです。
- OpenClawの公式リポジトリを取得する
- 公式のDocker用セットアップ手順に従う
docker composeでGatewayが正常起動するか確認する- ブラウザやCLIから状態確認する
リポジトリ取得の例は次のとおりです。
git clone https://github.com/openclaw/openclaw.git cd openclaw
その後のセットアップスクリプト名やComposeサービス名は変更される可能性があるため、Docker部分は必ず公式ドキュメントかリポジトリ内READMEの最新記述に合わせてください。この記事では、不正確な固定コマンドを避けるため、ここは高レベル手順にとどめています。
Mac で Docker 実行時に見落としやすい点
共有フォルダの権限
Macでは、ホスト側フォルダをコンテナへマウントするとき、OSのプライバシー保護によってアクセスが拒否されることがあります。特に Desktop、Documents、Downloads 配下を使うなら、System Settings > Privacy & Security の設定を見直してください。
Apple Silicon とイメージ互換性
M1、M2、M3 系のMacでは、イメージ側のCPUアーキテクチャ差で初回ビルドや起動が遅くなることがあります。動作不良というより互換レイヤーの影響である場合もあるため、まずは公式イメージや公式手順どおりの構成で試すのが安全です。
macOS の権限と Gatekeeper で注意すること
Gatekeeper は Mac を守る標準機能
Appleの案内では、macOSの Gatekeeper は、App Store外から入れたアプリや実行ファイルについて、署名や改ざん有無を確認するための仕組みです。もしOpenClaw関連ツールや依存ツールの初回起動時に警告が出た場合は、まず配布元が信頼できるかを確認してください。
信頼できる配布元から取得したもので、警告内容も理解できている場合のみ、System Settings > Privacy & Security から Open Anyway を選ぶ流れになります。警告が出たからといって、無条件で許可する運用はおすすめしません。
ターミナルや Docker Desktop のアクセス許可
MacでOpenClawを使うときは、OpenClaw本体よりも、実行元アプリの権限不足で詰まることがあります。たとえば次のケースです。
TerminalまたはiTermから特定フォルダへアクセスできないDocker Desktopが共有フォルダを読めないDesktopやDocuments配下のワークスペースをマウントできない
この場合は、Privacy & Security 内の Files and Folders、Full Disk Access、Docker Desktopのファイル共有設定などを確認します。すべてを常時許可するのではなく、必要なアプリに必要な範囲だけ許可するのが基本です。
会社支給 Mac では制限が入ることがある
MDM管理されたMacでは、Allow apps downloaded from の選択肢や Open Anyway が表示されないことがあります。この場合は個人設定で回避せず、社内管理者に確認したほうが安全です。
Mac でよくある詰まりと対処法
openclaw コマンドが見つからない
グローバルインストール後に起きやすい症状です。npm のグローバルパスが現在のシェルに通っているかを確認してください。ターミナル再起動だけで直ることもあります。
Docker は入れたのに docker compose が動かない
Docker Desktopが未起動か、初回設定が未完了のことがあります。まずDocker Desktopアプリを起動し、メニューバー上で正常稼働していることを確認してから再度試します。
Gatekeeper 警告で止まる
署名や配布元に不安がある場合は、そのまま進めないでください。信頼できるソースと確認できた場合だけ、Appleの案内どおり Privacy & Security から一時的に開く対応を取ります。
Docker マウントで Permission denied になる
Mac固有の権限設定か、共有対象フォルダの未設定が原因のことが多いです。ワークスペースを一度ホーム配下のシンプルなディレクトリへ移して再確認すると、原因切り分けがしやすくなります。
FAQ
OpenClaw は Mac で使えますか？
はい。OpenClawはmacOS対応で、まずは Node.js を整えたうえでCLI導入から始めるのが基本です。最初はローカル構成で試し、必要になったらDockerへ広げる進め方が失敗しにくいです。
Homebrew だけで OpenClaw を入れられますか？
Homebrewは主に Node.js や周辺ツールの準備に使うのが分かりやすいです。OpenClaw本体の導入は、公式案内に沿って npm ベースで進めるほうが一般的です。
Mac では Docker と通常導入のどちらがおすすめですか？
最短で試すだけなら通常導入、環境分離や再現性を重視するならDockerがおすすめです。迷ったら、最初は通常導入で動作確認し、そのあとDockerへ移るのが堅実です。
Gatekeeper の警告が出たら無効化してよいですか？
常時無効化はおすすめしません。Appleの案内どおり、信頼できる配布元と確認できた場合に限って、そのアプリだけ例外的に開く運用が安全です。
Mac で権限まわりが不安なときはどこを見るべきですか？
まず Privacy & Security、次に Files and Folders と Full Disk Access、Docker利用時はDocker Desktopのファイル共有設定を確認すると切り分けしやすいです。
まとめ
openclaw 導入 mac の最短ルートは、Homebrew で Node.js を整え、OpenClaw CLIを導入し、onboard と health 系コマンドでローカル動作を確認する流れです。Dockerを使う場合は、Mac特有の共有フォルダ権限とDocker Desktopの初回設定まで含めて準備すると詰まりにくくなります。
特にmacOSでは、インストールそのものより、PATH、Gatekeeper、ファイルアクセス許可で時間を使いやすいです。最初はローカルで小さく確認し、問題がなければDockerや外部連携へ広げる順番で進めると、安全かつ再現性高くセットアップできます。
出典
関連記事
AIエージェントのメモリスタックとは？2026年に重要度が上がる理由をやさしく解説
2026年4月8日OpenClaw vs Hermes vs Claude、創業者はどれを選ぶべき？2026年版の実務比較
2026年4月8日