OpenClaw agents parallèles et concurrence sur Mac mini M4 : files, limites et montée en charge prudente (2026)

Si vous exécutez déjà OpenClaw sur un Mac mini loué, le levier suivant est souvent le parallélisme : plus d’agents, plus d’appels d’outils, plus de tâches en arrière-plan. L’Apple Silicon M4 gère bien le multi-cœur, mais les fournisseurs LLM imposent des plafonds de tokens par minute et de requêtes qui mordent avant le CPU. Ce guide explique comment monter maxConcurrentTasks (ou l’équivalent de votre orchestrateur) sans ruiner les workspaces git, l’I/O disque ou votre budget API. À lire avec installation et déploiement, workflows de production et dépannage. Pour le réseau : sortie / SOCKS5 / WireGuard ; pour l’accès distant humain : SSH vs VNC et VNC.

En bref

• Partez de 1–2 tâches concurrentes, surveillez HTTP 429 et la latence API p95, puis augmentez lentement.
• Traitez les working trees git en écriture unique sauf verrous ou clones séparés par agent.
• Les LaunchAgents ne lisent pas votre profil shell interactif — placez les drapeaux de concurrence dans l’env plist ou la config chargée par le démon.
• Privilégiez files + backpressure plutôt qu’un fan-out illimité ; limitez les sous-processus d’outils par agent.

Pourquoi la concurrence mord sur un Mac mini cloud

Un Mac mini M4 ProxyMac est assez rapide pour que les équipes pensent « plus d’agents parallèles = plus de débit ». En pratique, l’ordre des goulots est souvent : (1) limites du fournisseur, (2) sous-processus d’outils et contention disque, (3) pression mémoire (gros dépôts, caches d’embeddings), puis (4) CPU. Monter la concurrence sans mesurer ces couches donne des exécutions instables — des timeouts qui ressemblent à « OpenClaw bloqué » mais sont en réalité des files bouchées ou des conflits de verrous git.

Les agents parallèles amplifient aussi le non-déterminisme : deux tâches qui lancent npm install ou réécrivent des fichiers générés se marchent dessus. Voyez la concurrence comme une politique d’ordonnancement, pas un multiplicateur gratuit.

Facteurs limitants (ce qui plafonne vraiment le débit)

Couche	Symptôme	Atténuation
API LLM TPM / RPM	HTTP 429, longues tentatives, latence de queue qui monte	Réduire la concurrence, backoff exponentiel, répartir clés ou quotas org
I/O disque (SSD)	diskutil activity élevé, git status lent	Working trees séparés, éviter clones dupliqués sur le même volume
Sous-processus d’outils	CPU saturé, tempêtes de fork	Limiter outils shell concurrents par agent ; sérialiser gros builds
Sortie réseau	Timeouts vers fournisseur ou registre	Corriger proxy NO_PROXY, choix de région ; voir l’article sortie

Modèles de files : fan-out vs pipeline

Utilisez des schémas explicites pour que l’exploitation sache ce que « parallèle » signifie dans votre stack :

• Fan-out / fan-in : un planificateur envoie N tâches de recherche indépendantes, un réducteur fusionne — adapté au surtout lecture et chemins distincts.
• Étapes de pipeline : lint → tests → résumé ; chaque étape en concurrence 1–2 mais le pipeline reste occupé — adapté aux dépôts avec artefacts de build partagés.
• Voie prioritaire : le chat interactif passe avant l’automatisation batch — files séparées et plafonds plus stricts sur la file batch.

Quel que soit le schéma, exposez profondeur et âge de file dans les logs. Si la profondeur croît de façon monotone, augmenter maxConcurrentTasks aggrave souvent la situation — il faut plus de clés, un quota plus large ou des tâches plus légères.

Git, artefacts de build et discipline « un seul rédacteur »

Le verrouillage de fichiers macOS n’empêche pas les conflits logiques : deux agents sur la même branche peuvent committer, rebaser ou réécrire des lockfiles. Par défaut, plus sûr :

1. Un agent rédacteur par clone ; analystes en lecture seule sans outils d’écriture.
2. Working trees distincts par famille de tâches : git worktree add ou répertoires sous ~/agents/.
3. Sérialiser installations de paquets et codegen — phase de préparation à concurrence 1.

LaunchAgent, exécutions sans tête et sources de config

Lorsqu’OpenClaw tourne sous LaunchAgent après déconnexion, il n’hérite que de l’environnement encodé dans la plist (plus les défauts système). Si vous avez réglé la concurrence dans ~/.zshrc, ces valeurs ne s’appliquent pas au démon. Répliquez les mêmes maxConcurrentTasks (et variables proxy) dans EnvironmentVariables ou centralisez dans un config.json sur disque lu par les modes interactif et démon.

Après modification, recyclez l’agent avec launchctl bootout / bootstrap et vérifiez qu’un seul listener occupe le port d’admin — des plists dupliquées causent souvent une « double exécution » ressemblant à des conditions de course.

Six étapes de montée en charge prudente

1. Métriques de base : à concurrence 1, noter latence fournisseur p50/p95, nombre de 429, charge moyenne et profondeur de file disque.
2. +1 à la fois : faire monter maxConcurrentTasks de 1 → 2 → 3, avec une fenêtre d’observation suffisante pour le trafic de pointe.
3. Plafonner les outils : limiter outils shell ou navigateur concurrents par agent si le stack le permet.
4. Répartir la charge : déplacer la recherche massivement parallèle vers d’autres mini ou clés API distinctes si la politique le permet.
5. Backpressure : quand l’âge de file dépasse le SLO, réduire la charge — pauser batch, reporter reconstructions d’embeddings.
6. Documenter le rollback : conserver la dernière plist et extrait de config valides dans le runbook avec les liens aide.

Questions fréquentes

Le M4 Pro change-t-il la recommandation ?

Plus de cœurs performance aident sous-processus et builds locaux, mais les quotas fournisseur ne dépendent pas de votre puce. Toujours partir bas ; vous atteindrez peut‑être le CPU plus tard.

Que faire si je ne vois presque que des 429 ?

Réduire la concurrence, ajouter du jitter entre retries, répartir entre comptes seulement si les conditions du fournisseur le permettent. Évitez dix agents au même motif de rafale — cela déclenche des throttles globaux.

Faut-il VNC pour des agents parallèles ?

Pas pour le débit. Une session GUI ponctuelle peut rester nécessaire pour TCC ou Trousseau — utilisez VNC, puis exploitez sans tête en SSH comme dans SSH vs VNC.

Mise à jour du 19 mai 2026 : si la RSS monte alors que les invites sont au repos (et que ce n’est pas seulement des 429 côté modèle), lisez orphelins MCP OpenClaw & hygiène launchd avant d’augmenter la concurrence.

Pourquoi un Mac mini M4 ProxyMac pour OpenClaw parallèle

Du métal dédié évite les voisins bruyants quand cinq agents sollicitent disque et sous-processus à la fois. Choisissez une région proche de vos endpoints LLM et registres sur la page tarifs, gardez la sortie explicite comme dans proxy / WireGuard, et maintenez les bases sécurité de OpenClaw sécurité et secrets avant de monter la concurrence.