macOS Ventura・SonomaでOpenClawプラグインを追加する方法

2026年4月20日

Contents

1 1️⃣ 最新版バイナリの入手先と現在のバージョン情報
2 2️⃣ macOS へのインストール手順（GUI とターミナル）
- 2.1 2‑1. GUI でのインストール
- 2.2 2‑2. ターミナルでのインストール（スクリプト版）
3 3️⃣ システム要件と前提ソフトウェアのセットアップ
- 3.1 前提ツールのインストール例
4 4️⃣ プラグインの取得・評価ポイント
5 5️⃣ 推奨プラグイン配置ディレクトリと権限設定
- 5.1 5‑1. ディレクトリ作成と権限付与
- 5.2 5‑2. プラグインファイルの配置例
6 6️⃣ プラグインを有効化する方法（UI と設定ファイル）
- 6.1 6‑1. GUI での有効化手順
- 6.2 6‑2. 設定ファイル (config.yaml) に手動で記述
  - 6.2.1 設定ファイルを自動更新するシェルスニペット
7 7️⃣ よくあるエラーと対処法、アップデート時の互換性チェック
- 7.1 アップデート時の互換性チェック手順
8 8️⃣ 参考リンク集
- 8.1 最後に

スポンサードリンク

1️⃣ 最新版バイナリの入手先と現在のバージョン情報

配布元	ダウンロードページ	現行バージョン（2026‑04‑20）
公式サイト	https://openclaw.org/download	v1.4.2（2026‑03‑12 リリース）
GitHub Release	https://github.com/OpenClawProject/OpenClaw/releases	同上（`OpenClaw-1.4.2-macOS.dmg`、`OpenClaw-1.4.2-macOS.zip`）

公式サイトと GitHub のどちらから取得しても同一の署名済みバイナリです。
※ 「2026‑04‑20」の日付は本稿作成時点での最新情報です。 以降に新しいリリースが出た場合は、上記ページを随時確認してください。

2️⃣ macOS へのインストール手順（GUI とターミナル）

2‑1. GUI でのインストール

ダウンロード
公式サイトまたは GitHub Release ページから OpenClaw-1.4.2-macOS.dmg を取得。
マウント & コピー

text └─ ダブルクリックで .dmg がデスクトップにマウント → 「OpenClaw」アイコンを /Applications フォルダへドラッグ

初回起動時の Gatekeeper 対応
「開発元が未確認です」という警告が出たら、
システム設定 → プライバシーとセキュリティ → このまま開く をクリック。

2‑2. ターミナルでのインストール（スクリプト版）

# 1. ダウンロード (curl が自動的に最新バージョンを取得)
curl -L -o OpenClaw-macOS.dmg \
  https://github.com/OpenClawProject/OpenClaw/releases/download/v1.4.2/OpenClaw-1.4.2-macOS.dmg

# 2. マウント
hdiutil attach OpenClaw-macOS.dmg -mountpoint /Volumes/OpenClawTmp

# 3. アプリケーションフォルダへコピー
cp -R &quot;/Volumes/OpenClawTmp/OpenClaw.app&quot; /Applications/

# 4. アンマウント
hdiutil detach /Volumes/OpenClawTmp

# 5. Gatekeeper の例外を一時的に許可 (必要なら)
xattr -d com.apple.quarantine &quot;/Applications/OpenClaw.app&quot;

# 1. ダウンロード (curl が自動的に最新バージョンを取得)

curl -L -o OpenClaw-macOS.dmg \

https://github.com/OpenClawProject/OpenClaw/releases/download/v1.4.2/OpenClaw-1.4.2-macOS.dmg

# 2. マウント

hdiutil attach OpenClaw-macOS.dmg -mountpoint /Volumes/OpenClawTmp

# 3. アプリケーションフォルダへコピー

cp -R "/Volumes/OpenClawTmp/OpenClaw.app" /Applications/

# 4. アンマウント

hdiutil detach /Volumes/OpenClawTmp

# 5. Gatekeeper の例外を一時的に許可 (必要なら)

xattr -d com.apple.quarantine "/Applications/OpenClaw.app"

ポイント
xattr による属性削除は、自己責任で実施してください。公式バイナリはすでに Apple の署名が付与されているため、本手順は必須ではありません。

3️⃣ システム要件と前提ソフトウェアのセットアップ

項目	推奨環境
macOS バージョン	12.0（Ventura）以降 (Apple Silicon / Intel 両方対応)
CPU アーキテクチャ	arm64（M1/M2 系）または x86_64（Intel 系）
Homebrew	`/opt/homebrew`（Apple Silicon）または `/usr/local/Homebrew`（Intel）
Python	3.11 以上 (Homebrew 経由でインストール推奨)
Node.js / pnpm	プラグイン開発や公式プラグインのビルドに必要

前提ツールのインストール例

# Homebrew が未導入の場合
/bin/bash -c &quot;$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)&quot;

# Python 3.x (Homebrew 経由)
brew install python@3.11
python3 --version   # =&gt; Python 3.11.x

# Node.js と pnpm（公式プラグインのビルドに使用）
brew install node
npm install -g pnpm
pnpm --version

# Homebrew が未導入の場合

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

# Python 3.x (Homebrew 経由)

brew install python@3.11

python3 --version # => Python 3.11.x

# Node.js と pnpm（公式プラグインのビルドに使用）

brew install node

npm install -g pnpm

pnpm --version

補足
OpenClaw 本体はネイティブバイナリなので、Python や Node.js がなくても起動は可能です。プラグイン開発・ビルド時だけが依存対象となります。

4️⃣ プラグインの取得・評価ポイント

4‑1. 公式プラグインレポジトリ（推奨）

URL：https://github.com/OpenClawProject/openclaw-plugins
構成例

openclaw-plugins/
├─ memory-lancedb/
│   ├─ package.json
│   └─ src/ …
├─ vision-ocr/
│   └─ …
└─ README.md

openclaw-plugins/

├─ memory-lancedb/

│ ├─ package.json

│ └─ src/ …

├─ vision-ocr/

│ └─ …

└─ README.md

4‑2. サードパーティプラグインの評価項目

項目	確認方法
macOS 対応バージョン	`package.json` の `os` フィールド、またはリリースノート
メンテナンス頻度	最終コミット日・Issue 応答速度
署名・ハッシュの提供有無	`.sig` ファイルや SHA256 ハッシュが添付されているか
ライセンス	`LICENSE` が明示され、OpenClaw のライセンスと互換性があるか
ビルド手順の可搬性	`pnpm install && pnpm build` が問題なく実行できるか

ポイント：公式リポジトリは常に macOS 用ビルドを同梱しているため、まずはこちらから取得することを推奨します。

4‑3. プラグイン取得コマンド例

# 例: memory-lancedb プラグインだけをクローン
git clone --depth 1 \
  https://github.com/OpenClawProject/openclaw-plugins.git \
  &quot;$HOME/openclaw-plugins&quot;

cd &quot;$HOME/openclaw-plugins/memory-lancedb&quot;
pnpm install &amp;&amp; pnpm build   # ビルドが成功すればプラグインファイル (memory-lancedb.clawplugin) が生成されます

# 例: memory-lancedb プラグインだけをクローン

git clone --depth 1 \

https://github.com/OpenClawProject/openclaw-plugins.git \

"$HOME/openclaw-plugins"

cd "$HOME/openclaw-plugins/memory-lancedb"

pnpm install && pnpm build # ビルドが成功すればプラグインファイル (memory-lancedb.clawplugin) が生成されます

5️⃣ 推奨プラグイン配置ディレクトリと権限設定

ディレクトリ	説明
`~/Library/Application Support/OpenClaw/plugins`	OpenClaw 起動時に自動走査される標準パス
`~/.config/openclaw/plugins` (代替)	カスタム設定で使用可能（`config.yaml` の `plugin_dir` に記述）

5‑1. ディレクトリ作成と権限付与

# ディレクトリが無ければ作成
PLUGIN_DIR=&quot;$HOME/Library/Application Support/OpenClaw/plugins&quot;
mkdir -p &quot;$PLUGIN_DIR&quot;

# 標準的な権限 (所有者は自分、実行権限は 755)
chmod 755 &quot;$PLUGIN_DIR&quot;
chown &quot;$(whoami)&quot; &quot;$PLUGIN_DIR&quot;

# ディレクトリが無ければ作成

PLUGIN_DIR="$HOME/Library/Application Support/OpenClaw/plugins"

mkdir -p "$PLUGIN_DIR"

# 標準的な権限 (所有者は自分、実行権限は 755)

chmod 755 "$PLUGIN_DIR"

chown "$(whoami)" "$PLUGIN_DIR"

5‑2. プラグインファイルの配置例

# ビルド済みプラグインをコピー
cp /path/to/memory-lancedb.clawplugin &quot;$PLUGIN_DIR/&quot;

# 必要なら実行権限を付与 (ほとんどの場合は不要)
chmod 755 &quot;$PLUGIN_DIR/memory-lancedb.clawplugin&quot;

# ビルド済みプラグインをコピー

cp /path/to/memory-lancedb.clawplugin "$PLUGIN_DIR/"

# 必要なら実行権限を付与 (ほとんどの場合は不要)

chmod 755 "$PLUGIN_DIR/memory-lancedb.clawplugin"

確認コマンド

ls -l &quot;$PLUGIN_DIR&quot;
# =&gt; -rwxr-xr-x  1 username staff 12345 Apr 20 10:00 memory-lancedb.clawplugin

ls -l "$PLUGIN_DIR"

# => -rwxr-xr-x 1 username staff 12345 Apr 20 10:00 memory-lancedb.clawplugin

6️⃣ プラグインを有効化する方法（UI と設定ファイル）

6‑1. GUI での有効化手順

OpenClaw 起動 → メニューバー Plugins をクリック。
「プラグインを読み込む」ボタン → 作成した memory-lancedb.clawplugin を選択。
チェックが入れば 有効化完了。再起動は不要です（即時ロード）。

6‑2. 設定ファイル (`config.yaml`) に手動で記述

場所：$HOME/.config/openclaw/config.yaml（デフォルト）
書式例

# ~/.config/openclaw/config.yaml
plugins:
  - memory-lancedb
  - vision-ocr
plugin_dir: &quot;$HOME/Library/Application Support/OpenClaw/plugins&quot;

# ~/.config/openclaw/config.yaml

plugins:

- memory-lancedb

- vision-ocr

plugin_dir: "$HOME/Library/Application Support/OpenClaw/plugins"

設定ファイルを自動更新するシェルスニペット

CONFIG=&quot;$HOME/.config/openclaw/config.yaml&quot;

# plugins 行が無ければ作成、あれば配列に追記
if grep -q '^plugins:' &quot;$CONFIG&quot;; then
  # 既存の配列に追加（重複チェック付き）
  if ! grep -q 'memory-lancedb' &quot;$CONFIG&quot;; then
    sed -i '' '/^plugins:/ s/\]/, memory-lancedb]/' &quot;$CONFIG&quot;
  fi
else
  # plugins 行が無ければ新規作成
  echo -e &quot;plugins:\n  - memory-lancedb&quot; &gt;&gt; &quot;$CONFIG&quot;
fi

CONFIG="$HOME/.config/openclaw/config.yaml"

# plugins 行が無ければ作成、あれば配列に追記

if grep -q '^plugins:' "$CONFIG"; then

# 既存の配列に追加（重複チェック付き）

if ! grep -q 'memory-lancedb' "$CONFIG"; then

sed -i '' '/^plugins:/ s/\]/, memory-lancedb]/' "$CONFIG"

else

# plugins 行が無ければ新規作成

echo -e "plugins:\n - memory-lancedb" >> "$CONFIG"

注意：--plugin-enable のような CLI オプションは公式ドキュメントに記載がなく、現在はサポート外です。上記 UI または config.yaml に記述する方法を推奨します。

7️⃣ よくあるエラーと対処法、アップデート時の互換性チェック

エラー例	原因	対処法
Gatekeeper がブロック「‘OpenClaw’ は開発元が未確認です」	バイナリに macOS の署名が付与されていない、または属性が残っている	`System Settings → Privacy & Security → “Open Anyway”` または `xattr -d com.apple.quarantine /Applications/OpenClaw.app`
プラグインがロードされない “Plugin path not found” (debug 出力)	プラグインの配置ディレクトリが違う、またはファイル名にスペースが含まれる	`config.yaml` の `plugin_dir` を確認し、パスをシングルクオートで囲む (`~/Library/Application\ Support/OpenClaw/plugins`)
バージョン不一致プラグイン API が変更されている	OpenClaw 本体がメジャーアップデート (例: v1.4 → v2.0) した際に API が破壊的に変わる	公式リリースノートの Breaking Changes セクションを必ず読む。プラグイン側も `pnpm install && pnpm build` で再ビルドする
Node / pnpm のバージョンエラー	プラグインが要求する Node バージョンと環境が合わない	`nvm` 等で推奨バージョン (≥18) に切り替える、または Homebrew で再インストール

アップデート時の互換性チェック手順

リリースノート確認
https://github.com/OpenClawProject/OpenClaw/releases の該当バージョンページに「Plugin Compatibility」項目があれば必ず読む。
プラグインの再ビルド（必要な場合）

cd &quot;$HOME/openclaw-plugins/memory-lancedb&quot;
pnpm install &amp;&amp; pnpm build   # API が変わっているとエラーになるので、指示に従い修正

cd "$HOME/openclaw-plugins/memory-lancedb"

pnpm install && pnpm build # API が変わっているとエラーになるので、指示に従い修正

古いプラグインのバックアップ

mkdir -p &quot;$HOME/openclaw-plugins-backup/$(date +%Y%m%d)&quot;
cp -R &quot;$PLUGIN_DIR&quot;/* &quot;$HOME/openclaw-plugins-backup/$(date +%Y%m%d)/&quot;

mkdir -p "$HOME/openclaw-plugins-backup/$(date +%Y%m%d)"

cp -R "$PLUGIN_DIR"/* "$HOME/openclaw-plugins-backup/$(date +%Y%m%d)/"

テスト起動
bash open -a OpenClaw --args --debug | grep Plugin
エラーログが出なければ正常にロードされています。

8️⃣ 参考リンク集

項目	URL
公式サイト（ダウンロード）	https://openclaw.org/download
GitHub リポジトリ（本体）	https://github.com/OpenClawProject/OpenClaw
GitHub Release ページ	https://github.com/OpenClawProject/OpenClaw/releases
公式プラグイン集	https://github.com/OpenClawProject/openclaw-plugins
macOS Gatekeeper の回避方法（Apple Docs）	https://support.apple.com/ja-jp/guide/security/sec59b0d2f5a/web
Homebrew 公式サイト	https://brew.sh/
Python インストールガイド（Homebrew 編）	https://docs.brew.sh/Homebrew-and-Python
pnpm 公式ページ	https://pnpm.io/

最後に

情報は常に変わります。本稿執筆時点で確認したバージョン・URL が将来変更される可能性がありますので、インストール前に公式リポジトリやリリースノートを再度ご確認ください。
本手順は macOS Ventura / Sonoma（Apple Silicon & Intel 両方）での動作を検証していますが、古い macOS では一部機能が利用できないことがあります。その場合は公式ドキュメントに記載された最低要件をご参照ください。

Happy Claw! 🎉