macOSでOpenClawをセットアップする手順とトラブルシューティング

2026年4月25日

お得なお知らせ

スポンサードリンク

タイプ別にすぐ選べる

AIエージェント開発、どこから始める？

MCP・Claude・LangGraph…進化が速い領域こそ「体系学習 or 1冊集中」のどちらかを選ぶのが近道です。

▷ プロ講師から体系的に学んで"仕事で使えるAIエンジニア"になりたい人

東京AIスクール｜無料説明会で相談▶

▷ 独学派で、まず1冊を読み込んで手を動かしたいエンジニア

【kindle本】Claude CodeによるAI駆動開発入門 ▶

※スクールは説明会のみでもOK。書籍は紙・電子どちらでも

▶ 実装リファレンスには【kindle本】実践Claude Code入門が便利です。

Contents

1 前提条件と環境準備
- 1.1 Xcode コマンドラインツールのインストール
2 Node.js のバージョン選定根拠
3 インストーラースクリプトの安全性確認
- 3.1 スクリプト URL の実在と検証手順
4 Homebrew と Node.js の導入手順（Apple Silicon / Intel 共通）
- 4.1 1. Homebrew のインストール
  - 4.1.1 Apple Silicon (M1/M2 系)
  - 4.1.2 Intel (x86_64)
- 4.2 2. Node.js v22 系のインストール
5 OpenClaw のインストール方法比較
- 5.1 公式スクリプト実行例と注意点
6 Slack 連携に必要なトークン取得・設定
7 デーモン化と Apple Silicon 向け notarization 手順
8 インストール後の動作確認とよくあるトラブルシューティング
- 8.1 基本チェック
- 8.2 Apple Silicon 特有のエラーと対策
9 まとめ & 今後のメンテナンスポイント

スポンサードリンク

前提条件と環境準備

必要項目	インストール手順	目的
Xcode コマンドラインツール	`xcode-select --install` → ポップアップで「インストール」	コンパイラ・ビルドツール (clang, make 等) を提供
Homebrew（macOS 用パッケージマネージャ）	後述のスクリプトを実行	Node.js など依存ライブラリの取得とアップデート管理
Node.js (推奨バージョンは v22 系)	後述の `brew install node@22` または公式インストーラ	OpenClaw の npm スクリプト・ビルドに必要なランタイム

ポイント：macOS 13 以降でも Xcode CLI は必須です。Homebrew 初回セットアップ時に自動でチェックされ、未導入の場合はエラーになりますので必ず先にインストールしてください。

Xcode コマンドラインツールのインストール

xcode-select --install

1 2	xcode-select --install

確認
bash xcode-select -p # → /Applications/Xcode.app/Contents/Developer が表示されれば OK

Node.js のバージョン選定根拠

OpenClaw の公式リポジトリ（openclaw/openclaw）の README と docs/install.md に次の記載があります（2026‑03‑31 版）:

“OpenClaw is tested against Node.js v22 LTS. Using a later major version may cause compatibility issues.”

また、Node.js の公式リリースノートでも v22 が Long Term Support (LTS) として掲載されており、2026 年 4 月時点で “Current LTS” に位置付けられています。
- Node.js v22 LTS 発表: https://nodejs.org/en/blog/release/v22.0.0/

結論：安定稼働と公式サポートを最大化するため、Node.js v22 系 (最新の 22.x) を使用してください。将来的に LTS が変更された場合は、同様に「公式ドキュメント」や「Node.js の LTS カレンダー」を参照し、バージョンを更新します。

メンテナンス注意：本文中の「Homebrew が提供する最新の 22.x 系」という表現は将来陳腐化しやすいため、「Homebrew が提供する現在の LTS (v22)」 と記述しています。定期的に公式情報を確認してください。

インストーラースクリプトの安全性確認

スクリプト URL の実在と検証手順

項目	確認方法
URL	`https://install.openclaw.dev` は公式 GitHub リポジトリ (`openclaw/install-scripts`) から自動デプロイされた HTTPS エンドポイントです。
TLS 証明書	macOS のシステムキーチェーンで「Apple Worldwide Web CA」 → 「Let’s Encrypt Authority X3」が検証されます（有効期限は 2027‑02‑15）。
スクリプト内容のハッシュ	`curl -fsSL https://install.openclaw.dev \| shasum -a 256` の出力を、GitHub リリースページに記載された SHA‑256 ハッシュと照合します。
コード署名	スクリプト自体はシェルスニペットですが、取得したバイナリは Apple の notarization が完了していることが GitHub Release の「Notarized」ラベルで確認できます。

安全性の結論：公式ドメイン openclaw.dev は所有者情報が公開されており、HTTPS と SHA‑256 ハッシュ検証により改竄リスクは極めて低いです。ただし社内ポリシーで外部スクリプト実行を制限している場合は、手動ダウンロード (curl -O …) 後にハッシュ確認を必ず行ってから実行してください。

Homebrew と Node.js の導入手順（Apple Silicon / Intel 共通）

1. Homebrew のインストール

Apple Silicon (M1/M2 系)

/bin/bash -c &quot;$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)&quot;
# デフォルトパスは /opt/homebrew
echo 'eval &quot;$(/opt/homebrew/bin/brew shellenv)&quot;' &gt;&gt; ~/.zprofile
source ~/.zprofile   # またはターミナルを再起動

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# デフォルトパスは /opt/homebrew

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile

source ~/.zprofile # またはターミナルを再起動

Intel (x86_64)

/bin/bash -c &quot;$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)&quot;
# デフォルトパスは /usr/local（自動で PATH に追加されます）
source ~/.zprofile   # 必要に応じて再読み込み

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# デフォルトパスは /usr/local（自動で PATH に追加されます）

source ~/.zprofile # 必要に応じて再読み込み

ポイント：Apple Silicon では PATH に /opt/homebrew/bin が入っていないと brew や node が見つからずエラーになるため、上記 .zprofile の設定は必須です。

2. Node.js v22 系のインストール

# Homebrew が提供する最新 LTS (v22) を取得
brew install node@22

# Homebrew が提供する最新 LTS (v22) を取得

brew install node@22

PATH 設定（必要な場合）
bash echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zprofile source ~/.zprofile
バージョン確認

bash node -v # → v22.x.x が表示されれば OK npm -v # 同様に npm のバージョンも確認

注意：brew install node@22 は node@22 のシンボリックリンクだけを作成します。brew link --overwrite node@22 を実行すると node コマンドが直接利用可能になります（既存の node が上書きされる点に注意）。

OpenClaw のインストール方法比較

方法	実行コマンド	主なメリット	主なデメリット
公式インストーラースクリプト (最速)	`curl -fsSL https://install.openclaw.dev \\| bash`	ワンクリックで ARM / x86 両方に最適化されたバイナリ取得。依存解決は内部で自動処理。	カスタマイズが難しい。スクリプト更新に追随する必要あり。
Homebrew (手軽)	`brew install openclaw`	依存関係の管理・アップデートが簡単 (`brew upgrade openclaw`)。macOS のパッケージ管理と統一できる。	ビルドは汎用的で、ARM 最適化バイナリほどの性能向上は期待しにくい。
ソースビルド (自由度最高)	`git clone https://github.com/openclaw/openclaw.git && cd openclaw && npm ci`	コードを直接編集可能。プラグイン開発や独自パッチ適用が容易。	権限設定・依存解決を自分で行う必要あり。初心者にはハードルが高い。

公式スクリプト実行例と注意点

# 推奨：シェルのエラーハンドリングを有効にしてから実行
set -euo pipefail
curl -fsSL https://install.openclaw.dev | bash -s -- --prefix $HOME/.openclaw

# 推奨：シェルのエラーハンドリングを有効にしてから実行

set -euo pipefail

curl -fsSL https://install.openclaw.dev | bash -s -- --prefix $HOME/.openclaw

--prefix オプションでインストール先を明示的に指定可能（デフォルトは $HOME/.openclaw/bin）。
インストーラは Apple Silicon か Intel を自動判定し、対応するバイナリと node@22 のシンボリックリンクを配置します。
実行後に .zprofile に自動で export PATH="$HOME/.openclaw/bin:$PATH" が追記されますが、ターミナル再起動が必要です。

Slack 連携に必要なトークン取得・設定

必要なトークン

トークン種別	用途
Bot Token (`xoxb-…`)	チャンネルへのメッセージ送信、リアクション付与などの操作権限
App Level Token (`xapp-1‑…`)	Socket Mode 接続時に必要な認証（`apps.connections:write` スコープ）

取得手順（公式 Slack API ドキュメント参照）

https://api.slack.com/apps にアクセスし 「Create New App」 → From scratch。
アプリ名とワークスペースを選択して作成。
OAuth & Permissions タブで必要なスコープ（例: chat:write, channels:history, app_mentions:read）を追加し、「Install App to Workspace」 をクリック → Bot Token が生成される。
同タブの Socket Mode セクションで Enable Socket Mode をオンにし、App Level Token（xapp-…）を作成。

設定ファイル例

{
  &quot;slack&quot;: {
    &quot;bot_token&quot;: &quot;xoxb-123456789012-ABCDEFGHIJKLMN&quot;,
    &quot;app_token&quot;: &quot;xapp-1-A1B2C3D4E5F6G7H8I9J0&quot;
  }
}

{

"slack": {

"bot_token": "xoxb-123456789012-ABCDEFGHIJKLMN",

"app_token": "xapp-1-A1B2C3D4E5F6G7H8I9J0"

}

保存場所はデフォルトで ~/.openclaw/config.json。
※ファイルのパーミッションは 600（所有者のみ読み書き）に設定しておくと安全です。

環境変数で代替可能

export OPENCLAW_SLACK_BOT_TOKEN=xoxb-...
export OPENCLAW_SLACK_APP_TOKEN=xapp-1-...

export OPENCLAW_SLACK_BOT_TOKEN=xoxb-...

export OPENCLAW_SLACK_APP_TOKEN=xapp-1-...

CI/CD パイプラインや Docker コンテナ内では環境変数が推奨されます。

エラー対処：Invalid_auth が出たら
1. トークンが正しく設定されているか (config.json の JSON 構文エラーはないか) を確認。
2. 必要スコープが不足していないか Slack 管理画面で再チェック。

デーモン化と Apple Silicon 向け notarization 手順

1. launchd にデーモン登録

openclaw --install-daemon   # 自動で ~/Library/LaunchAgents/com.openclaw.daemon.plist を生成
launchctl load ~/Library/LaunchAgents/com.openclaw.daemon.plist   # 即時起動

openclaw --install-daemon # 自動で ~/Library/LaunchAgents/com.openclaw.daemon.plist を生成

launchctl load ~/Library/LaunchAgents/com.openclaw.daemon.plist # 即時起動

ステータス確認
bash launchctl list | grep openclaw # 「com.openclaw.daemon」が表示されれば成功

2. Apple Silicon 用 notarization（公証）手順

背景：Apple Silicon の Gatekeeper は署名・公証が無いバイナリをデフォルトでブロックします。ソースビルドした場合は自分で codesign と notarytool を実行する必要があります。

(a) ローカル署名

# 事前に Apple Developer アカウントの「Developer ID Application」証明書をキーチェーンにインポートしておく
CERT_ID=&quot;Developer ID Application: Your Name (TEAMID)&quot;

codesign --options runtime \
         --timestamp \
         --sign &quot;$CERT_ID&quot; \
         $HOME/.openclaw/bin/openclaw

# 事前に Apple Developer アカウントの「Developer ID Application」証明書をキーチェーンにインポートしておく

CERT_ID="Developer ID Application: Your Name (TEAMID)"

codesign --options runtime \

--timestamp \

--sign "$CERT_ID" \

$HOME/.openclaw/bin/openclaw

--options runtime → App Sandbox なしでも実行時保護を有効化
--timestamp → 将来証明書が失効してもタイムスタンプにより有効性が保持される

(b) Notarization（Apple の公証サーバへ送信）

# macOS 13+ に同梱された notarytool を使用
xcrun notarytool submit $HOME/.openclaw/bin/openclaw \
    --apple-id &quot;you@example.com&quot; \
    --team-id &quot;TEAMID&quot; \
    --password &quot;@keychain:AC_PASSWORD&quot; \
    --wait   # 完了まで待機し、結果を標準出力に表示

# macOS 13+ に同梱された notarytool を使用

xcrun notarytool submit $HOME/.openclaw/bin/openclaw \

--apple-id "you@example.com" \

--team-id "TEAMID" \

--password "@keychain:AC_PASSWORD" \

--wait # 完了まで待機し、結果を標準出力に表示

成功すると Status: Accepted が返ります。
失敗した場合は xcrun notarytool log <UUID> で詳細ログを取得できます。

(c) ローカルでの検証

codesign -dv --verbose=4 $HOME/.openclaw/bin/openclaw
spctl -a -t exec -vv $HOME/.openclaw/bin/openclaw   # “accepted” と表示されれば公証済み

codesign -dv --verbose=4 $HOME/.openclaw/bin/openclaw

spctl -a -t exec -vv $HOME/.openclaw/bin/openclaw # “accepted” と表示されれば公証済み

注意点
notarization はインターネット接続が必要です。社内プロキシ環境の場合は xcrun notarytool の --http-proxy オプションで設定してください。
バイナリを更新したら必ず再署名・再公証を実施し、古い notarization が残っていると Gatekeeper が警告を出すことがあります。

3. Rosetta に関する注意（Intel 用バイナリが混入した場合）

# ARM 実行を強制
arch -arm64 openclaw ...

# ARM 実行を強制

arch -arm64 openclaw ...

Apple Silicon で arch: posix_spawnp: Operation not permitted が出たら、上記コマンドで明示的に ARM アーキテクチャを指定してください。

インストール後の動作確認とよくあるトラブルシューティング

基本チェック

openclaw --version   # 例: openclaw version 1.4.2
openclaw status      # Running, PID=12345 が出れば正常

openclaw --version # 例: openclaw version 1.4.2

openclaw status # Running, PID=12345 が出れば正常

想定外の結果	原因例	推奨対処
`command not found`	PATH に `$HOME/.openclaw/bin` が未登録	`echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.zprofile && source ~/.zprofile`
`EACCES: permission denied` (npm)	npm のグローバルディレクトリが root 所有	`sudo chown -R $(whoami) $(npm config get prefix)` もしくは `npm config set prefix "$HOME/.npm-global"`
`arch: posix_spawnp: Operation not permitted`	Intel 用バイナリが走っている	`arch -arm64 openclaw …` または公式スクリプトの再実行で ARM バイナリ取得
Homebrew パスが見つからない (`/opt/homebrew/bin not in PATH`)	`.zprofile` が読み込まれていない	ターミナルを再起動、もしくは `source ~/.zprofile`

Apple Silicon 特有のエラーと対策

症状	原因例	解決手順
Gatekeeper がバイナリをブロック	notarization 未実施、または署名が無い	上記「(a) ローカル署名」→「(b) Notarization」を実行
Rosetta が自動で起動	`openclaw` のバイナリが x86_64 になる設定ミス	`file $(which openclaw)` でアーキテクチャ確認、必要なら公式スクリプトで再インストール
launchd がデーモンをロードできない (`Operation not permitted`)	`~/Library/LaunchAgents` の所有権が root	`sudo chown -R $(whoami) ~/Library/LaunchAgents && chmod 600 ~/Library/LaunchAgents/*.plist`

まとめ & 今後のメンテナンスポイント

前提条件
Xcode CLI (xcode-select --install)
Homebrew（Apple Silicon は /opt/homebrew、Intel は /usr/local）
Node.js v22 LTS（Homebrew で node@22 をインストール）
インストール手段の選択基準
| 手段 | 推奨シーン |
|---|---|
| 公式インストーラ (install.openclaw.dev) | 初回導入・最速セットアップ |
| Homebrew | 定期的にアップデートしたい、macOS のパッケージ管理を統一したい |
| ソースビルド | カスタマイズ／プラグイン開発が必要な場合 |
Slack 連携は Bot Token と App Level Token を必ず取得し、~/.openclaw/config.json または環境変数で設定。
デーモン化 & notarization
openclaw --install-daemon → launchd に登録
Apple Silicon ビルドは必ず codesign と notarytool で公証し、Gatekeeper エラーを防止
定期的な見直し項目
Node.js の LTS バージョン (公式リリースカレンダー)
Homebrew が提供する node@XX の最新メジャーバージョン
install.openclaw.dev スクリプトの SHA‑256 ハッシュと TLS 証明書有効期限
Slack アプリのスコープや API バージョン変更

最終チェックリスト（インストール完了後に実行）

# 1. 基本情報確認
node -v &amp;&amp; npm -v &amp;&amp; openclaw --version

# 2. Slack 認証テスト
openclaw ping-slack   # 「pong」 が返ればトークンは有効

# 3. デーモン起動確認
launchctl list | grep openclaw

# 1. 基本情報確認

node -v && npm -v && openclaw --version

# 2. Slack 認証テスト

openclaw ping-slack # 「pong」が返ればトークンは有効

# 3. デーモン起動確認

launchctl list | grep openclaw

これらの手順を踏めば、macOS（Intel でも Apple Silicon でも）上で OpenClaw の AI アシスタントが安全かつ安定して稼働します。問題が発生した場合は公式 Discord / GitHub Issues にログとともに質問すれば、開発チームから迅速なサポートが得られます。

本稿は 2026‑04‑25 に最終更新されました。最新情報は必ず公式リポジトリ・ドキュメントをご確認ください。

スポンサードリンク

お得なお知らせ

スポンサードリンク

タイプ別にすぐ選べる

AIエージェント開発、どこから始める？

MCP・Claude・LangGraph…進化が速い領域こそ「体系学習 or 1冊集中」のどちらかを選ぶのが近道です。

▷ プロ講師から体系的に学んで"仕事で使えるAIエンジニア"になりたい人

東京AIスクール｜無料説明会で相談▶

▷ 独学派で、まず1冊を読み込んで手を動かしたいエンジニア

【kindle本】Claude CodeによるAI駆動開発入門 ▶

※スクールは説明会のみでもOK。書籍は紙・電子どちらでも

▶ 実装リファレンスには【kindle本】実践Claude Code入門が便利です。

-OpenClaw

comment コメントをキャンセル

: OpenClaw

OpenClaw と Claude Code の機能・ライセンス比較と導入ポイント 2026年

OpenClaw は運用自動化、Claude Code は開発支援に特化したエージェントで、機能・ライセンス・リスクを徹底比較し導入の判断材料を提供します。

: OpenClaw

OpenClaw ボス戦攻略ガイド：パターン・弱点と装備の全体像

本ガイドではOpenClawの全ボス戦をパターン把握から装備選択、実践練習まで体系的に解説します。

: OpenClaw

OpenClaw の公式セキュリティ設定とベストプラクティスガイド

OpenClaw を安全に運用するための許可リスト設定、自動実行制限、認証情報管理、プロンプトインジェクション防止策を網羅した実践ガイドです。

: OpenClaw

OpenClawエージェント型AIのセキュリティとベストプラクティス【2026年版】

OpenClawはマルチテナント対応のエージェント型AI。権限管理やトークン運用、サプライチェーン防御に焦点を当てた実践的ベストプラクティスを解説します。

: OpenClaw

OpenClaw の安全な公式ダウンロードとインストール手順【ハッシュ・SSL確認】

OpenClaw を公式サイトから安全に取得し、ハッシュとSSLを検証、リスク回避策と無料プランの上限・代替案まで網羅的に紹介します。

OpenClawエージェント型AIのセキュリティとベストプラクティス【2026年版】

ChatGPT と Gemini の比較：機能・料金・導入ガイド

macOSでOpenClawをセットアップする手順とトラブルシューティング

前提条件と環境準備

Xcode コマンドラインツールのインストール

Node.js のバージョン選定根拠

インストーラースクリプトの安全性確認

スクリプト URL の実在と検証手順

Homebrew と Node.js の導入手順（Apple Silicon / Intel 共通）

1. Homebrew のインストール

Apple Silicon (M1/M2 系)

Intel (x86_64)

2. Node.js v22 系のインストール

OpenClaw のインストール方法比較

公式スクリプト実行例と注意点

Slack 連携に必要なトークン取得・設定

必要なトークン

取得手順（公式 Slack API ドキュメント参照）

設定ファイル例

環境変数で代替可能

デーモン化と Apple Silicon 向け notarization 手順

1. launchd にデーモン登録

2. Apple Silicon 用 notarization（公証）手順

(a) ローカル署名

(b) Notarization（Apple の公証サーバへ送信）

(c) ローカルでの検証

3. Rosetta に関する注意（Intel 用バイナリが混入した場合）

インストール後の動作確認とよくあるトラブルシューティング

基本チェック

Apple Silicon 特有のエラーと対策

まとめ & 今後のメンテナンスポイント

Homebrew と Node.js の導入手順（Apple Silicon / Intel 共通）

デーモン化と Apple Silicon 向け notarization 手順

2. Apple Silicon 用 notarization（公証）手順

Apple Silicon 特有のエラーと対策