Einrichten von OpenClaw auf macOS mit einem einheitlichen KI-Anbieter-Endpunkt

OpenClaw macOS Installationsanleitung

Ein Entwickler dokumentierte sein Wochenendprojekt, bei dem er OpenClaw auf macOS zum Laufen brachte, und teilte spezifische Einrichtungsschritte und Fehlerbehebungs-Erkenntnisse, die aus der Dokumentation nicht offensichtlich waren.

Systemanforderungen und Installation

Die Einrichtung erfordert Node.js 24 oder 22.16+. Der Entwickler stellte fest, dass Node 20 von einem älteren Projekt unbrauchbare Fehlermeldungen produzierte. Installationsoptionen umfassen:

• Homebrew: brew install openclaw-cli
• Offizielles Installationsskript (eine Methode wählen, nicht beide)

Nach der Installation führen Sie den Einrichtungsassistenten aus:

openclaw onboard

Anbieterkonfiguration

Der Entwickler wechselte von separaten OpenAI- und Anthropic-Schlüsseln zu einem einheitlichen Anbieter-Endpunkt mit ZenMux. Während der Einrichtung wählte er "Benutzerdefinierter Anbieter", dann "OpenAI-kompatibel" und gab die Basis-URL und den API-Schlüssel ein.

Die Konfiguration nach der Installation kann in der JSON5-Konfigurationsdatei unter ~/.openclaw/openclaw.json vorgenommen werden:

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

Überprüfung und Hintergrundbetrieb

Um die Einrichtung zu überprüfen:

• openclaw doctor prüft Konfiguration, Konnektivität und Node-Version
• openclaw models list zeigt verfügbare Modelle an
• openclaw agent --local --agent main --message "Hello, respond with just Hi" für einen einfachen Funktionstest

Um OpenClaw als Hintergrunddienst auszuführen:

openclaw onboard --install-daemon

Dies richtet einen macOS LaunchAgent ein, der beim Start beginnt. Verwenden Sie openclaw status, um zu bestätigen, dass er läuft.

Fallstricke und Fehlerbehebung

Der Entwickler stieß auf zwei Hauptprobleme:

• WhatsApp blockiert standardmäßig alle eingehenden Nachrichten aus Sicherheitsgründen. Absender müssen explizit auf eine Whitelist gesetzt werden, sonst werden Nachrichten stillschweigend verworfen.
• Bei der Fehlerbehebung immer zuerst openclaw doctor ausführen, da es die meisten Konfigurationsprobleme erkennt.

Nach einer Woche Nutzung stellte der Entwickler Vorteile fest, darunter automatisches Failover zwischen Modellanbietern bei Ausfällen und vereinfachte Abrechnung mit einem einzigen API-Schlüssel und einer Abrechnungsseite anstelle der Verwaltung mehrerer Anbieter.