Passer d'un PoC solo à une configuration exploitable en équipe, le dur n'est souvent pas « peut-on installer OpenClaw ? » — c'est une Gateway qui tient Telegram, Discord, Slack et Web Chat à la fois, un routage déterministe vers des agents distincts, et l'accès des collègues (téléphone, portable) en nœuds pour les commandes côté appareil. Ce billet prend un Mac M4 hébergement cloud Vuncloud en ancrage Gateway 7×24, en enfilant routage multi-agent, appairage de nœuds détenu par la Gateway et routage des canaux avec US Est / US Ouest / APAC, M4 16 Go/24 Go, 1 To/2 To et découpages parallèles. Les faits s'ancrent sur docs.openclaw.ai ; baseline d'install dans OpenClaw sur Mac hébergement cloud — installation, vérification SSH/VNC, régions, RAM M4, stockage et parallèle FAQ ; accès distant dans tunnel SSH vs Direct (wss) (cité seulement pour Web Chat / acceptation d'appairage — pas le récit complet des liaisons).
Intention de recherche : six questions → matrice de décision
Regroupez « multi-canaux, multi-agent, appairage nœud, région, config, durée de location » en un tableau : alignez les preuves, puis éditez openclaw.json.
| Votre question | Vérifier d'abord | Étape suivante |
|---|---|---|
| Telegram et Discord ont besoin de « personnalités » différentes | agents.list + bindings |
Un accountId par canal/bot, lier des agentId distincts |
| Les téléphones des collègues doivent lancer caméra/commandes système | openclaw nodes pending |
Compléter l'approbation d'appairage Gateway (obligatoire depuis 2026.3.31+) |
| Le trafic tombe toujours sur main — « routage cassé » | agents list --bindings |
Ordre des règles peer et accountId manquant |
| Gateway en US Est ou APAC ? | Sortie API des canaux + fuseau d'astreinte | Co-localiser le bot chaud avec la Gateway ; repli Node/VNC APAC |
| 16 Go suffisent pour quatre canaux ? | Sessions concurrentes + taille workspace | Préférer 24 Go si multi-agent + plugins/skills en parallèle |
| Migrer l'état au changement de location ou de machine | OPENCLAW_STATE_DIR |
openclaw backup create --verify puis restauration migrating officielle |
Architecture : plan de contrôle Gateway vs exécution Nœud vs règles de retour canal
Trois phrases pour fixer le modèle mental :
- Gateway (Mac hébergement cloud résident) : seul plan de contrôle ; détient
~/.openclaw/openclaw.json, identifiants des canaux,bindingset magasin d'appairage (nodes/paired.json). - Agent : « cerveau » isolé —
agentDir, workspace et magasin de sessions séparés ; le modèle ne choisit pas votre canal : le routage entrant estbindings. - Nœud : téléphone, portable, Mac sans tête en périphériques via WS vers la Gateway, exposant
node.invoke; pas une seconde Gateway.
Entrant : canal → route Gateway → session agent choisie → modèle → retour sur le même compte canal. Sortant appareil : agent/outil → Gateway → nœud appairé.
Checklist environnement Mac distant
Avant de toucher aux canaux, rendez vrai « la Gateway peut écrire l'état de façon fiable » :
- Node.js 22+ et
PATHnon interactif prévisible (launchd = SSH — éviter exit 127). OPENCLAW_STATE_DIRsur disque de données local (surtout montage 1 To/2 To), pas le volume système racine.- Résidence :
openclaw onboard --install-daemon+pmsetanti-sommeil ; après reboot,openclaw gateway statusimmédiatement. - SSH : automatisation, sauvegarde, CLI d'approbation ; VNC : connexions canal GUI ou invites de permission système.
- Permissions : l'utilisateur d'exécution peut écrire état, workspace,
credentials/; traiterpaired.jsoncomme confidentiel.
US Est vs US Ouest vs APAC : placement Gateway
| Dimension | Gateway US Est | Gateway US Ouest | Gateway / Nœud APAC |
|---|---|---|---|
| Sortie API des canaux | Plutôt amont US Est | Plutôt amont US Ouest | Amont APAC ; bots transfrontaliers = tests réels |
| WebSocket / SSH ops | RTT plus bas pour équipes US Est | RTT plus bas pour équipes US Ouest | Astreinte APAC ; Gateway NA reste transpacifique |
| Rôle parallèle indicatif | Gateway principale + Discord public | Nœud lourd / builds | Repli humain VNC, nœud régional |
| Note de choix | Artefacts/API modèle chauds US Est | Choisir une côte US — éviter deux Gateways sur un state dir | Personnes APAC, cerveau NA : Gateway NA + Nœud APAC |
Durées et détail SKU : manuel de choix de région ; ici l'accent : une Gateway production → un répertoire d'état.
M4 16 Go vs 24 Go : seuil multi-canaux + multi-agent
| Profil de charge | 16 Go | 24 Go |
|---|---|---|
| Agent unique + PoC 1–2 canaux | Souvent suffisant | Plus de marge, Health plus stable |
| ≥3 workspaces agent + plugins/skills | Risque swap — « canal bloqué » | Défaut production recommandé |
| Sessions multi-canaux concurrentes + index | Rétention logs/sessions serrée | Mieux pour Gateway 7×24 |
1 To/2 To et répertoire d'état : sauvegarde et migration
L'état est par défaut ~/.openclaw (surcharge OPENCLAW_STATE_DIR) ; l'appairage vit dans nodes/paired.json, pending.json. Avant changement de machine ou de location :
openclaw gateway stop
openclaw backup create --verify --output ~/Backups
# Sur la nouvelle instance, OPENCLAW_STATE_DIR uniforme, puis redémarrage gateway
Voir CLI backup et migrating. Gros workspaces : --no-include-workspace réduit l'archive — synchronisez les arbres workspace vous-même ensuite.
Suivi pas à pas : Gateway → canaux → bindings agent → appairage nœud
Les étapes correspondent au JSON-LD HowTo en tête de page ; ports et champs suivent la sortie de votre openclaw doctor.
- Installer la Gateway : Install des dépendances ;
openclaw onboard --install-daemon. - Configurer les canaux : dans
channels.telegram.accounts/channels.discord.accountsunaccountIdpar bot ;openclaw channels status --probe. - Multi-agent :
openclaw agents add alerts,openclaw agents add social; ne réutilisez pas le mêmeagentDir. - Exemple bindings (séparation Telegram + Discord) :
{
agents: {
list: [
{ id: "main", workspace: "~/.openclaw/workspace-main" },
{ id: "alerts", workspace: "~/.openclaw/workspace-alerts" },
],
},
bindings: [
{ agentId: "main", match: { channel: "discord", accountId: "default" } },
{ agentId: "alerts", match: { channel: "telegram", accountId: "alerts" } },
],
channels: {
telegram: {
accounts: {
alerts: { botToken: "…", dmPolicy: "pairing" },
},
},
discord: {
accounts: {
default: { token: "…" },
},
},
},
}
- Appairage nœud : après connexion des appareils à la Gateway, sur la machine ops :
openclaw nodes pending openclaw nodes approve <requestId> openclaw nodes status
Depuis le 2026.3.31, les commandes node ne s'exécutent pas tant que l'appairage nœud n'est pas approuvé (les commandes en file sont abandonnées). Après approbation, gateway.nodes.allowCommands et la politique associée s'appliquent encore.
- Acceptation :
openclaw gateway restart→agents list --bindings→ message test par canal → contrôle Web Chat.
Topologie parallèle : Gateway US Est + Nœud US Ouest + VNC APAC
| Instance | Rôle | Porte |
|---|---|---|
| US Est M4 24 Go / 1 To | Gateway unique | Telegram+Discord+Web Chat ; tous les bindings |
| US Ouest M4 16 Go | Nœud lourd | Compilation, jobs batch — pas de seconde Gateway |
| APAC M4 + VNC | Nœud repli humain | Connexions GUI / permissions ; fenêtres d'astreinte courtes |
La valeur du parallèle est la moins grande contention, pas la duplication du plan de contrôle. Jetons, OPENCLAW_STATE_DIR et identifiants canal n'ont qu'un seul rédacteur.
Matrice canal × agent × région
| Canal | Stratégie account | Binding agent typique | Indice placement Gateway |
|---|---|---|---|
| Telegram | BotFather : un bot → un accountId |
Alertes/astreinte → alerts |
Même région que le chemin API chaud Amérique du Nord |
| Discord | Un jeton bot par persona | Communauté/ingénierie → main / coding |
Penser Message Content Intent |
| Slack | Binding niveau teamId |
Agents par workspace | Co-localiser avec la politique de sortie entreprise |
| Web Chat | Même origine que la Gateway | main par défaut ou agent dédié |
L'origine navigateur doit correspondre à la gateway |
FAQ : appairage, routage, connexion canal
Forme : symptôme → diagnostic → action (aligné sur le FAQPage en tête).
- Déconnexion canal / échec probe → rotation jeton ou redémarrage gateway →
channels status --probe; reconnecter ceaccountIdsi besoin. - Mauvais agent (binding) → ordre des bindings ou
accountIdmanquant →agents list --bindings; règles peer en premier. - Appairage expiré → timeout pending 5 min → reconnexion nœud +
nodes approveà nouveau. - Commandes node non approuvées → politique 2026.3.31+ → compléter l'appairage ; l'appairage appareil seul ne suffit pas.
- Conflit state_dir → deux Gateways sur un répertoire → un seul rédacteur ; migrer avec backup.
- Disque plein → sessions/journaux → agrandir disque données + backup périodique ; surveiller
df. - exit 127 → PATH launchd → chemins absolus ; voir article d'installation.
- Échec Health → gateway/config/ressources → doctor + lot de quatre statuts.
- Web Chat muet → origine/WS → article liaisons ; pas de récit wss complet ici.
- Migration de location → arrêt, backup → restaurer
OPENCLAW_STATE_DIRsur nouvelle instance → retester bindings et appairage.
paired.json contient des jetons nœud — ne jamais committer dans Git. N'activez autoApproveCidrs que sur des réseaux explicitement de confiance selon la doc pairing officielle.
Acheter un Mac ou louer
Envisagez l'achat quand le nombre de canaux, d'agents et l'échelle des nœuds sont stables et que vous pouvez exploiter le matériel. La plupart des équipes en itération multi-canaux conviennent à la location jour/semaine/mois avec rôles parallèles. Pas de SLA ni chiffres de performance inventés.
Clôture et lectures
Ordre suggéré : fixer région et résidence Gateway → canaux et bindings agent → acceptation appairage nœud → puis M4/disque/location ou topologie parallèle. Tarifs : https://vuncloud.com/fr/location-mac-mini.html ; régions : https://vuncloud.com/fr/index.html ; aide : https://vuncloud.com/fr/help-center.html ; blog : https://vuncloud.com/fr/blog/index.html. Édition anglaise : English edition.
Mettre le multi-canal dans un runbook auditable
En production, versionnez les tableaux bindings et les enregistrements d'appairage nœud avec les tickets de changement. Gardez ce billet avec les articles install et liaisons dans le wiki interne pour réduire l'astreinte répétée sur « mauvais agent » et « nœud non approuvé ».
Partez de la page d'accueil pour la carte des régions, alignez le budget sur tarifs et commande, et utilisez le centre d'aide pour l'approvisionnement.