ブログ
MacでOpenClaw（旧Clawdbot/Moltbot）をインストールして実行する方法

MacでOpenClaw（旧Clawdbot/Moltbot）をインストールして実行する方法

Feb 12, 20267 min read

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	最も簡単	シンプルなボットトークン
WhatsApp	簡単	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 経由でグローバル openclaw CLI をインストールできるため、ターミナルのワークフローをアプリと併用できます
オンボーディングセッションでチャットする — アプリは専用チャットを開き、エージェントが自己紹介できるようにします

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 の幅広い機能を探索できます。

リソース

Updated on Jul 08, 2026

Fendy Feng
Fendy Feng is the Technical Marketing Writer at Zilliz. She has extensive experience developing and enhancing the impact of open-source projects in various global markets by producing high-quality, tailored content. Before joining Zilliz, Fendy worked as a Content Strategist at PingCAP, a fast-growing E-Series startup renowned for its open-source distributed SQL database.

読み続けて

Zilliz Cloud Now Available in 6 New Regions Across Japan and Europe

Zilliz Cloud is now available in new regions across Japan and Europe, including Tokyo on all three major clouds, bringing the total to 28 regions.

Zilliz Named "Highest Performer" and "Easiest to Use" in G2's Summer 2025 Grid® Report for Vector Databases

Zilliz shines in G2's Summer 2025 Grid® Report as both "Highest Performer" and "Easiest to Use," solving the performance-usability dilemma.

Demystifying the Milvus Sizing Tool

Explore how to use the Sizing Tool to select the optimal configuration for your Milvus deployment.