MacでOpenClaw（旧Clawdbot/Moltbot）をインストールして実行する方法
OpenClaw は、日常的に使うメッセージングアプリと AI コーディングエージェントを橋渡しする、オープンソースのセルフホスト型ゲートウェイです。タブ、アプリ、インターフェースを切り替える代わりに、WhatsApp や Telegram からメッセージを送るだけで、ポケットの中で AI を活用した応答を受け取れます。MIT ライセンスで提供され、自分のハードウェア上で動作し、データを完全に自分で管理できます。
このチュートリアルでは、前提条件から最初に動作するチャットまで、macOS に OpenClaw をインストールして実行するために必要なすべてを順を追って説明します。
必要なもの
始める前に、以下が揃っていることを確認してください。
- macOS（最近のバージョンであれば可）
- Node.js 22 以降 — まだインストールされていない場合はインストーラスクリプトが処理しますが、確認しておくとよいでしょう
- API キー — OpenClaw チームは Anthropic を推奨しています
- 約 5 分 の時間
現在の Node バージョンを確認するには、Terminal を開いて実行します。
node --version
v22.x.x 以上が表示されれば準備完了です。そうでない場合も心配いりません — インストーラが対応します。
ステップ 1: インストーラスクリプトで OpenClaw をインストールする（推奨）
macOS に OpenClaw をインストールする最速の方法は、1 行のインストーラスクリプトです。Node の検出、CLI のインストール、オンボーディングウィザードの起動を、すべて 1 ステップで処理します。
Terminal を開いて実行します。
curl -fsSL https://openclaw.ai/install.sh | bash
これだけです。スクリプトは CLI をダウンロードし、npm 経由でグローバルにインストールし、オンボーディングウィザードを自動的に開始します。
代替方法: npm で直接インストールする
すでに Node 22+ があり、手動で制御したい場合は、npm で OpenClaw をインストールできます。
npm install -g openclaw@latest
openclaw onboard --install-daemon
代替方法: pnpm でインストールする
pnpm をパッケージマネージャーとして使っている場合:
pnpm add -g openclaw@latest
pnpm approve-builds -g # openclaw, node-llama-cpp, sharp などを承認
openclaw onboard --install-daemon
注: pnpm では、ビルドスクリプトを持つパッケージに対して明示的な承認が必要です。最初のインストールで "Ignored build scripts" 警告が表示されたら、pnpm approve-builds -g を実行し、一覧表示されたパッケージを選択してください。
トラブルシューティング: sharp のビルドエラー
libvips をグローバルにインストールしている場合（macOS では Homebrew 経由で一般的）に sharp がインストール中に失敗する場合は、プリビルドバイナリを強制します。
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
sharp: Please add node-gyp to your dependencies というエラーが表示される場合は、ビルドツール（Xcode Command Line Tools + npm install -g node-gyp）をインストールするか、上記の環境変数を使用してください。
ステップ 2: オンボーディングウィザードを実行する
インストーラスクリプトで自動的に起動しなかった場合は、オンボーディングウィザードを手動で開始します。
openclaw onboard --install-daemon
ウィザードは、認証、ゲートウェイ設定、任意のチャネル接続の構成を案内します。また、OpenClaw をバックグラウンドサービス（デーモン）としてインストールするため、Terminal を閉じた後も Gateway は実行され続けます。
ウィザードで設定されるもの
- 認証 — Gateway 用のトークンを生成し、ローカルおよびリモートクライアントに認証を必須にします
- Gateway 設定 — ポート、バインドアドレス、サービスのインストール
- チャネル接続 — WhatsApp、Telegram、Discord などの任意セットアップ
ステップ 3: Gateway が実行中であることを確認する
オンボーディングが完了したら、Gateway が起動していることを確認します。
openclaw gateway status
Gateway が実行中であることを示す確認メッセージが表示されるはずです。デバッグや簡単なテストのためにフォアグラウンドで実行したい場合は、次を使用します。
openclaw gateway --port 18789
完全なヘルスチェックを行うには:
openclaw health
ステップ 4: Control UI（Dashboard）を開く
OpenClaw でチャットを始める最速の方法は、ブラウザベースの Control UI を使うことです — チャネル設定は不要です。
実行します。
openclaw dashboard
これにより、dashboard URL がコピーされ、可能であればブラウザが開き、リンクが表示されます。デフォルトでは、Control UI は次の場所で提供されます:
http://127.0.0.1:18789/
ダッシュボードで認証を求められた場合は、Gateway 設定のトークンを貼り付けてください。次のコマンドで取得できます。
openclaw config get gateway.auth.token
セキュリティに関する注意: Control UI は管理者向けの画面です — チャット、設定、実行承認へのアクセスを提供します。公開しないでください。localhost、Tailscale Serve、または SSH トンネルを使用してください。
ステップ 5: チャットチャンネルを接続する（任意）
Control UI ですぐにチャットへアクセスできますが、OpenClaw の本当の力は、すでに使っているアプリから AI エージェントにメッセージを送れることです。対応チャンネルの概要は次のとおりです。
| チャンネル | セットアップの複雑さ | 注記 |
|---|---|---|
| Telegram | 最も簡単 | シンプルなボットトークン |
| 簡単 | QR ペアリングが必要。ディスク上により多くの状態を保存 | |
| Discord | 中程度 | Bot API + Gateway |
| iMessage | 中程度 | BlueBubbles macOS サーバー経由を推奨 |
| IRC | 低い | クラシック IRC。チャンネル + DM |
| Slack | 中程度 | Bolt SDK。ワークスペースアプリ |
| Signal | 中程度 | プライバシー重視。signal-cli を使用 |
複数のチャンネルを同時に実行できます — 好きなだけ設定でき、OpenClaw はチャットごとにメッセージをルーティングします。
こちらの記事もご覧ください: OpenClaw Tutorial: Connect to Slack for Local AI Assistant - Milvus Blog
クイック例: WhatsApp をペアリングする
WhatsApp を接続するには、次を実行します。
openclaw channels login
QR ペアリングのフローに従うと、WhatsApp から直接 AI エージェントにメッセージを送れるようになります。
ステップ 6: テストメッセージを送信する
チャンネルを設定したら、CLI からテストメッセージを送信します。
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
電話番号を自分のものに置き換えてください。すべてが正しく接続されていれば、メッセージングアプリにメッセージが届き、OpenClaw の AI エージェントが応答します。
任意: ソースからビルドする
コントリビューター、またはローカルチェックアウトから実行したい方向け:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
CLI をグローバルにリンクします。
pnpm link --global
その後、オンボーディングを実行します。
openclaw onboard --install-daemon
開発中にホットリロードを行うには、標準の gateway コマンドの代わりに pnpm gateway:watch を使用してください。
任意: macOS アプリのオンボーディング
OpenClaw は、独自のオンボーディングフローを備えたネイティブ macOS アプリ（メニューバー）も提供しています。アプリを使用している場合:
- 初回起動時に macOS のセキュリティ警告を承認する
- 「ローカルネットワークを検索」 権限を許可する
- ローカル vs. リモートを選択する — ローカル専用 Gateway には「この Mac」を選択
- 権限を付与する — ユースケースに応じて、アプリが Automation、Notifications、Accessibility、その他の TCC 権限を要求する場合があります
- CLI をインストールする（任意） — アプリは npm 経由でグローバル
openclawCLI をインストールできるため、ターミナルのワークフローをアプリと併用できます - オンボーディングセッションでチャットする — アプリは専用チャットを開き、エージェントが自己紹介できるようにします
OpenClaw ドキュメントで推奨される安定したワークフロー: OpenClaw.app をインストールして起動し、オンボーディングチェックリストを完了してから、openclaw channels login でチャンネルをリンクします。
設定の基本
OpenClaw は設定を ~/.openclaw/openclaw.json に保存します。標準では、送信者ごとのセッションを持つ RPC モードで同梱の Pi バイナリを使用します — 設定は不要です。
エージェントにメッセージを送信できるユーザーを制限したい場合は、allowFrom ルールを追加します。
{
"channels": {
"whatsapp": {
"allowFrom": ["+15555550123"],
"groups": {
"*": {
"requireMention": true
}
}
}
},
"messages": {
"groupChat": {
"mentionPatterns": ["@openclaw"]
}
}
}
macOS における主要ファイルの場所
| パス | 目的 |
|---|---|
~/.openclaw/openclaw.json | メイン設定ファイル |
~/.openclaw/workspace/ | スキル、プロンプト、メモリ |
~/.openclaw/credentials/ | チャンネル認証情報 |
~/.openclaw/agents/<agentId>/sessions/ | エージェントセッションデータ |
/tmp/openclaw/ | ログ |
便利な環境変数
| 変数 | 目的 |
|---|---|
OPENCLAW_HOME | 内部パス解決用のホームディレクトリを上書き |
OPENCLAW_STATE_DIR | 状態ディレクトリを上書き |
OPENCLAW_CONFIG_PATH | 設定ファイルパスを上書き |
トラブルシューティング: openclaw が見つからない
インストール後にシェルが openclaw コマンドを見つけられない場合、ほぼ必ず PATH エントリの不足が原因です。
簡単な診断:
node -v
npm -v
npm prefix -g
echo "$PATH"
npm prefix -g の出力に /bin を加えたものが $PATH に含まれていない場合は、シェルの起動ファイル（最近の macOS では ~/.zshrc）に追加してください。
export PATH="$(npm prefix -g)/bin:$PATH"
その後、新しいターミナルウィンドウを開くか、source ~/.zshrc を実行してください。
トラブルシューティング: ダッシュボードでの "Unauthorized" / 1008 エラー
Control UI に unauthorized エラーが表示される場合:
- Gateway に到達できることを確認してください:
openclaw status - トークンを取得します:
openclaw config get gateway.auth.token - ダッシュボード設定で、トークンを認証フィールドに貼り付けて再接続します
新しいトークンを生成する必要がある場合:
openclaw doctor --generate-gateway-token
これで利用できるもの
このチュートリアルを完了すると、以下が利用できます。
- Mac 上で稼働中の Gateway
- 安全なアクセスのために設定済みの認証
- ブラウザベースのチャット用のControl UI アクセス
- 任意で、1 つ以上の接続済みメッセージングチャンネル（WhatsApp、Telegram、Discord など）
ここから、マルチエージェントルーティング、ワークスペース分離、メディアサポート、OpenClaw の幅広い機能を探索できます。
リソース
読み続けて
Why AI Databases Don't Need SQL
Whether you like it or not, here's the truth: SQL is destined for decline in the era of AI.
How to Build RAG with Milvus, QwQ-32B and Ollama
Hands-on tutorial on how to create a streamlined, powerful RAG pipeline that balances efficiency, accuracy, and scalability using the QwQ-32B and Milvus.
Zilliz Cloud BYOC Upgrades: Bring Enterprise-Grade Security, Networking Isolation, and More
Discover how Zilliz Cloud BYOC brings enterprise-grade security, networking isolation, and infrastructure automation to vector database deployments in AWS