macOSでOpenClawを設定：統合AIプロバイダーエンドポイントの完全ガイド

OpenClaw macOS インストール手順

ある開発者が週末プロジェクトとしてmacOSでOpenClawを動作させるまでの過程を記録し、ドキュメントからは明らかでなかった具体的なセットアップ手順やトラブルシューティングの知見を共有しました。

システム要件とインストール

セットアップにはNode.js 24または22.16以上が必要です。開発者は、古いプロジェクトからのNode 20では役に立たないエラーメッセージが表示されたことに言及しています。インストールオプションは以下の通りです：

Homebrew: brew install openclaw-cli
公式インストーラースクリプト（どちらか一方の方法を選択してください）

インストール後、オンボーディングウィザードを実行します：

openclaw onboard

プロバイダー設定

開発者は、個別のOpenAIとAnthropicのキーから、ZenMuxを使用した統合プロバイダーエンドポイントに移行しました。オンボーディング中に「カスタムプロバイダー」、次に「OpenAI互換」を選択し、ベースURLとAPIキーを入力しました。

インストール後の設定は、~/.openclaw/openclaw.jsonにあるJSON5設定ファイルで行えます：

// ~/.openclaw/openclaw.json
{
  models: {
    mode: "merge",
    providers: {
      "zenmux": {
        baseUrl: "<your provider's base URL>/v1",
        apiKey: "YOUR_API_KEY",
        api: "openai-responses",
      },
    },
  },
}

検証とバックグラウンド操作

セットアップを検証するには：

openclaw doctor 設定、接続性、Nodeバージョンをチェックします
openclaw models list 利用可能なモデルを表示します
openclaw agent --local --agent main --message "Hello, respond with just Hi" サニティチェックを行います

OpenClawをバックグラウンドサービスとして実行するには：

openclaw onboard --install-daemon

これにより、起動時に開始されるmacOS LaunchAgentが設定されます。openclaw statusを使用して実行中であることを確認してください。

注意点とトラブルシューティング

開発者は主に2つの問題に遭遇しました：

WhatsAppはセキュリティのため、デフォルトで全ての受信メッセージをブロックします。送信者は明示的に許可リストに登録する必要があり、そうでないとメッセージは静かに破棄されます。
トラブルシューティング時には、まずopenclaw doctorを実行してください。ほとんどの設定問題を検出します。

一週間使用した後、開発者は、障害時のモデルプロバイダー間の自動フェイルオーバーや、複数のプロバイダーを管理する代わりに単一のAPIキーと請求ページで簡素化された課金などの利点を指摘しました。

📖 Read the full source: r/openclaw