Configuration OpenClaw macOS avec fournisseur IA unifié

Guide d'installation d'OpenClaw sur macOS

Un développeur a documenté son projet de week-end pour faire fonctionner OpenClaw sur macOS, partageant des étapes de configuration spécifiques et des conseils de dépannage qui n'étaient pas évidents dans la documentation.

Configuration système et installation

La configuration nécessite Node.js 24 ou 22.16+. Le développeur a noté que Node 20 d'un projet plus ancien produisait des messages d'erreur peu utiles. Les options d'installation incluent :

Homebrew : brew install openclaw-cli
Script d'installation officiel (choisir une seule méthode, pas les deux)

Après l'installation, exécutez l'assistant de configuration :

openclaw onboard

Configuration du fournisseur

Le développeur est passé de clés OpenAI et Anthropic séparées à un point de terminaison de fournisseur unifié utilisant ZenMux. Pendant la configuration, il a sélectionné "Fournisseur personnalisé" puis "Compatible OpenAI" et a saisi l'URL de base et la clé API.

La configuration post-installation peut être effectuée dans le fichier de configuration JSON5 à l'emplacement ~/.openclaw/openclaw.json :

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

Vérification et fonctionnement en arrière-plan

Pour vérifier la configuration :

openclaw doctor vérifie la configuration, la connectivité et la version de Node
openclaw models list affiche les modèles disponibles
openclaw agent --local --agent main --message "Hello, respond with just Hi" pour un test de bon fonctionnement

Pour exécuter OpenClaw en tant que service en arrière-plan :

openclaw onboard --install-daemon

Cela configure un LaunchAgent macOS qui démarre au démarrage. Utilisez openclaw status pour confirmer qu'il fonctionne.

Pièges et dépannage

Le développeur a rencontré deux problèmes principaux :

WhatsApp bloque par défaut tous les messages entrants pour des raisons de sécurité. Les expéditeurs doivent être explicitement autorisés, sinon les messages sont supprimés silencieusement.
Lors du dépannage, exécutez toujours openclaw doctor en premier, car il détecte la plupart des problèmes de configuration.

Après une semaine d'utilisation, le développeur a noté des avantages, notamment le basculement automatique entre les fournisseurs de modèles lors des pannes et la facturation simplifiée avec une seule clé API et page de facturation au lieu de gérer plusieurs fournisseurs.

📖 Read the full source: r/openclaw