​

FAQ

​

Table des matières

• Quick start and first-run setup
  • Je suis bloqué, quel est le moyen le plus rapide de me débloquer ?
  • Quelle est la méthode recommandée pour installer et configurer OpenClaw ?
  • Comment ouvrir le tableau de bord après l’onboarding ?
  • Comment authentifier le tableau de bord (jeton) en localhost vs à distance ?
  • De quel environnement d’exécution ai-je besoin ?
  • Est-ce que cela fonctionne sur Raspberry Pi ?
  • Des conseils pour les installations sur Raspberry Pi ?
  • It is stuck on “wake up my friend” / onboarding will not hatch. What now?
  • Can I migrate my setup to a new machine (Mac mini) without redoing onboarding?
  • Where do I see what is new in the latest version?
  • I can’t access docs.openclaw.ai (SSL error). What now?
  • What’s the difference between stable and beta?
  • How do I install the beta version, and what’s the difference between beta and dev?
  • How do I try the latest bits?
  • How long does install and onboarding usually take?
  • Installer stuck? How do I get more feedback?
  • Windows install says git not found or openclaw not recognized
  • The docs didn’t answer my question - how do I get a better answer?
  • How do I install OpenClaw on Linux?
  • How do I install OpenClaw on a VPS?
  • Where are the cloud/VPS install guides?
  • Can I ask OpenClaw to update itself?
  • What does the onboarding wizard actually do?
  • Do I need a Claude or OpenAI subscription to run this?
  • Can I use Claude Max subscription without an API key
  • How does Anthropic “setup-token” auth work?
  • Where do I find an Anthropic setup-token?
  • Do you support Claude subscription auth (Claude Code OAuth)?
  • Why am I seeing HTTP 429: rate_limit_error from Anthropic?
  • Is AWS Bedrock supported?
  • How does Codex auth work?
  • Do you support OpenAI subscription auth (Codex OAuth)?
  • How do I set up Gemini CLI OAuth
  • Is a local model OK for casual chats?
  • How do I keep hosted model traffic in a specific region?
  • Do I have to buy a Mac Mini to install this?
  • Do I need a Mac mini for iMessage support?
  • If I buy a Mac mini to run OpenClaw, can I connect it to my MacBook Pro?
  • Can I use Bun?
  • Telegram: what goes in allowFrom?
  • Can multiple people use one WhatsApp number with different OpenClaw instances?
  • Can I run a “fast chat” agent and an “Opus for coding” agent?
  • Does Homebrew work on Linux?
  • What’s the difference between the hackable (git) install and npm install?
  • Can I switch between npm and git installs later?
  • Should I run the Gateway on my laptop or a VPS?
  • How important is it to run OpenClaw on a dedicated machine?
  • What are the minimum VPS requirements and recommended OS?
  • Can I run OpenClaw in a VM and what are the requirements
• What is OpenClaw?
  • What is OpenClaw, in one paragraph?
  • What’s the value proposition?
  • I just set it up what should I do first
  • What are the top five everyday use cases for OpenClaw
  • Can OpenClaw help with lead gen outreach ads and blogs for a SaaS
  • What are the advantages vs Claude Code for web development?
• Skills and automation
  • Comment puis-je personnaliser mes compétences sans laisser le repo sali ?
  • Puis-je charger des compétences depuis un dossier personnalisé ?
  • [Comment puis-je utiliser différents modèles pour différentes tâches?] (#how-can-i-use-different-models-for-different-tasks)
  • Le bot se fige, tout en faisant un travail lourd. Comment puis-je me décharger ?
  • Cron ou rappels ne tirent pas. Que dois-je vérifier?
  • Comment puis-je installer des compétences sur Linux?
  • OpenClaw peut-il exécuter des tâches sur un calendrier ou en continu en arrière-plan ?
  • Puis-je utiliser les compétences d’Apple macOS uniquement depuis Linux?
  • Avez-vous une notion ou une intégration de HeyGen ?
  • Comment puis-je installer l’extension Chrome pour la prise en charge du navigateur ?
• Sandboxing and memory
  • Y a-t-il une doc de bac à sable dédiée?
  • Comment lier un dossier hôte dans le bac à sable ?
  • Comment fonctionne la mémoire ?
  • La mémoire oublie toujours les choses. Comment puis-je le faire coller?
  • La mémoire persiste-t-elle pour toujours ? Quelles sont les limites ?
  • La recherche de mémoire sémantique requiert-elle une clé API OpenAI ?
• Where things live on disk
  • Toutes les données utilisées avec OpenClaw sont-elles sauvegardées localement ?
  • Ou OpenClaw stocke-t-il ses donnees ?
  • Où devrait vivre AGENTS.md / SOUL.md / USER.md / MEMORY.md ?
  • Quelle est la stratégie de sauvegarde recommandée ?
  • Comment désinstaller complètement OpenClaw ?
  • Les agents peuvent-ils travailler en dehors de l’espace de travail?
  • Je suis en mode distant - où est la boutique de session ?
• Config basics
  • Quel est le format de la configuration ? Où est-ce?
  • J’ai défini gateway.bind: "lan" (ou "tailnet") et maintenant rien n’écoute / l’interface utilisateur non autorisée
  • Pourquoi ai-je besoin d’un jeton sur localhost maintenant?
  • Dois-je redémarrer après la modification de la configuration ?
  • Comment puis-je activer la recherche web (et la recherche web)?
  • config.apply a effacé ma configuration. Comment puis-je récupérer et éviter cela?
  • [Comment puis-je faire fonctionner une passerelle centrale avec des travailleurs spécialisés sur tous les appareils?] (#how-do-i-run-a-central-gateway-with-specialized-workers-across-devices)
  • Le navigateur OpenClaw peut-il fonctionner sans tête ?
  • Comment utiliser Brave pour le contrôle du navigateur?
• Remote gateways + nodes
  • Comment les commandes se propagent entre Telegram, la passerelle et les nœuds ?
  • Comment mon agent peut-il accéder à mon ordinateur si la passerelle est hébergée à distance ?
  • Tailscale est connecté mais je n’ai pas de réponses. What now?
  • Deux instances OpenClaw peuvent-elles se parler (local + VPS)?
  • ai-je besoin de VPSes séparés pour plusieurs agents
  • Y a-t-il un avantage d’utiliser un nœud sur mon ordinateur portable personnel au lieu de SSH d’un VPS ?
  • Les nœuds exécutent un service de passerelle ?
  • Y a-t-il une méthode API / RPC pour appliquer la configuration ?
  • Quelle configuration “sane” minimale pour une première installation?
  • Comment puis-je configurer l’échelle de queue sur un VPS et me connecter depuis mon Mac ?
  • Comment puis-je connecter un nœud Mac à une passerelle distante (Tailscale Serve)?
  • Devrais-je installer sur un deuxième ordinateur portable ou simplement ajouter un nœud ?
• Env vars and .env loading
  • Comment les variables d’environnement sont chargées par OpenClaw ?
  • « J’ai commencé la passerelle par le service et mes vars env ont disparu. » What now?
  • J’ai défini COPILOT_GITHUB_TOKEN, mais le statut des modèles montre “Shell env: off: off.” Pourquoi?
• Sessions & multiple chats
  • Comment démarrer une nouvelle conversation ?
  • Est-ce que les sessions se réinitialisent automatiquement si je n’envoie jamais /new?
  • Y a-t-il un moyen de faire une équipe d’instances d’OpenClaw un PDG et de nombreux agents
  • Pourquoi le contexte a-t-il été tronqué en milieu de tâche? Comment puis-je le prévenir ?
  • Comment puis-je réinitialiser complètement OpenClaw mais le garder installé ?
  • Je reçois des erreurs “contextuelles trop grandes” - comment puis-je réinitialiser ou compact?
  • Pourquoi est-ce que je vois “Requête LLM rejetée: messages.N.content.X.tool_use.input: Field required”?
  • Pourquoi suis-je victime de coups de cœur toutes les 30 minutes?
  • Dois-je ajouter un “compte bot” à un groupe WhatsApp ?
  • Comment puis-je obtenir le JID d’un groupe WhatsApp ?
  • Pourquoi OpenClaw ne répond-il pas dans un groupe?
  • Est-ce que les groupes/sujets partagent le contexte avec les DMs?
  • Combien d’espaces de travail et d’agents puis-je créer?
  • Puis-je exécuter plusieurs bots ou chats en même temps (Slack), et comment devrais-je régler cela ?
• Models: defaults, selection, aliases, switching
  • Qu’est-ce que le “modèle par défaut”?
  • Quel modèle recommandez-vous ?
  • Comment changer de modèle sans effacer ma configuration?
  • Puis-je utiliser des modèles auto-hébergés (llama.cpp, vLLM, Ollama)?
  • Que font OpenClaw, Flawd et Krill pour les modèles?
  • Comment puis-je changer de modèle à la volée (sans redémarrer)?
  • Puis-je utiliser GPT 5.2 pour les tâches quotidiennes et Codex 5.3 pour le codage
  • Pourquoi puis-je voir “Modèle … n’est pas autorisé” et alors aucune réponse ?
  • Pourquoi puis-je voir “Modèle inconnu: minimax/MiniMax-M2.1”?
  • Puis-je utiliser MiniMax comme valeur par défaut et OpenAI pour des tâches complexes ?
  • Est-ce que opus / sonnet / gpt raccourcis intégrés ?
  • Comment définir/remplacer les raccourcis du modèle (alias)?
  • Comment ajouter des modèles d’autres fournisseurs comme OpenRouter ou Z.AI ?
• Model failover and “All models failed”
  • Comment fonctionne le basculement ?
  • [Que signifie cette erreur?] (#what-does-this-error-mean)
  • Corriger la liste de contrôle pour Aucun identifiant trouvé pour le profil "anthropic:default"
  • Pourquoi a-t-il aussi essayé Google Gemini et a échoué?
• Auth profiles: what they are and how to manage them
  • Qu’est-ce qu’un profil d’authentification?
  • Quels sont les identifiants de profil typiques?
  • Puis-je contrôler quel profil d’authentification est essayé en premier ?
  • Clé OAuth vs API : quelle est la différence ?
• Gateway: ports, “already running”, and remote mode
  • Quel port la passerelle utilise-t-elle?
  • Pourquoi openclaw gateway status dit-il Runtime: running mais RPC probe: failed?
  • Pourquoi openclaw gateway status montre-t-il Config (cli) et Config (service) différemment?
  • Que signifie déjà “une autre instance de passerelle est en train d’écouter?
  • Comment utiliser OpenClaw en mode distant (client se connecte à une passerelle ailleurs)?
  • L’interface de contrôle dit “non autorisé” (ou continue à se reconnecter). What now?
  • J’ai défini gateway.bind: "tailnet" mais il ne peut pas lier / rien écouter
  • Puis-je exécuter plusieurs passerelles sur le même hôte ?
  • Que signifie “établissement de liaison invalide” / code 1008 ?
• Logging and debugging
  • Où sont les logs?
  • Comment commencer/arrêter/redémarrer le service de passerelle ?
  • J’ai fermé mon terminal sous Windows - comment puis-je redémarrer OpenClaw ?
  • La passerelle est en place, mais les réponses n’arrivent jamais. Que dois-je vérifier?
  • “Déconnecté de la passerelle : pas de raison” - Et maintenant?
  • Telegram setMyCommands échoue avec des erreurs de réseau. Que dois-je vérifier?
  • TUI ne montre aucune sortie. Que dois-je vérifier?
  • Comment puis-je arrêter complètement puis démarrer la passerelle?
  • ELI5: openclaw gateway restart vs openclaw gateway
  • Quelle est la façon la plus rapide d’obtenir plus de détails lorsque quelque chose échoue ?
• Media & attachments
  • Ma compétence a généré une image/PDF, mais rien n’a été envoyé
• Security and access control
  • Est-il sécuritaire d’exposer OpenClaw à des DMs entrants?
  • L’injection rapide n’est-elle qu’une préoccupation pour les robots publics ?
  • Si mon bot possède son propre compte GitHub ou son propre numéro de téléphone
  • [Puis-je lui donner de l’autonomie par rapport à mes messages textuels et est aussi sûr] (#can-i-give-it-autonomy-over-my-text-messages-and-is-that-safe)
  • Puis-je utiliser des modèles moins chers pour des tâches personnelles d’assistant?
  • J’ai couru /start dans Telegram mais je n’ai pas obtenu de code d’appairage
  • WhatsApp : enverra-t-il un message à mes contacts ? Comment fonctionne l’appairage ?
• Chat commands, aborting tasks, and “it won’t stop”
  • Comment puis-je empêcher les messages internes du système de s’afficher dans le chat
  • Comment puis-je arrêter/annuler une tâche en cours?
  • Comment puis-je envoyer un message Discord depuis Telegram ? (“Message inter-contexte refusé”)
  • Pourquoi est-ce que le bot “ignore” les messages à feu rapide ?

​

First 60 seconds if something’s broken

1. Quick status (first check)
   openclaw status
   
   Fast local summary: OS + update, gateway/service reachability, agents/sessions, provider config + runtime issues (when gateway is reachable).
2. Pasteable report (safe to share)
   openclaw status --all
   
   Read-only diagnosis with log tail (tokens redacted).
3. Daemon + port state
   openclaw gateway status
   
   Shows supervisor runtime vs RPC reachability, the probe target URL, and which config the service likely used.
4. Deep probes
   openclaw status --deep
   
   Runs gateway health checks + provider probes (requires a reachable gateway). See Health.
5. Tail the latest log
   openclaw logs --follow
   
   If RPC is down, fall back to:
   tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
   
   File logs are separate from service logs; see Logging and Troubleshooting.
6. Run the doctor (repairs)
   openclaw doctor
   
   Repairs/migrates config/state + runs health checks. See Doctor.
7. Gateway snapshot
   openclaw health --json
   openclaw health --verbose   # shows the target URL + config path on errors
   
   Asks the running gateway for a full snapshot (WS-only). See Health.

​

Démarrage rapide et installation en premier lancement

​

Je suis coincé quel est le moyen le plus rapide de me décoincer

• **Code Claude **: https://www.anthropic.com/claude-code/
• Codex OpenAI : https://openai.com/codex/

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

openclaw status
openclaw modèle l'état
médecin openclaw

• l'état openclaw: instantané rapide de la vie de passerelle/agent + configuration de base.
• l'état des modèles openclaw: vérifie l’authentification du fournisseur + la disponibilité du modèle.
• openclaw doctor: valide et répare les problèmes de config/state courants.

​

Quelle est la méthode recommandée pour installer et configurer OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw à la carte --install-daemon

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # auto-installe UI deps à la première exécution
openclaw à bord

​

Comment puis-je ouvrir le tableau de bord après l’intégration

​

Comment puis-je authentifier le jeton du tableau de bord sur localhost vs remote

• Ouvrez http://127.0.0.1:18789/.
• Si elle demande l’identification, collez le jeton de gateway.auth.token (ou OPENCLAW_GATEWAY_TOKEN) dans les paramètres de l’interface de contrôle.
• Récupérez le depuis l’hôte de la passerelle : openclaw config get gateway.auth.token (ou générez-en un : openclaw doctor --generate-gateway-token).

• Tailscale Serve (recommandé): keep bind loopback, run openclaw gateway --tailscale serve, open https://<magicdns>/. Si gateway.auth.allowTailscale est true, les en-têtes d’identité satisfont l’authentification (pas de jeton).
• Tailnet bind: exécutez openclaw gateway --bind tailnet --token "<token>", ouvrez http://<tailscale-ip>:18789/, collez le jeton dans les paramètres du tableau de bord.
• tunnel SSH : ssh -N -L 18789:127.0.0.1:18789 user@host puis ouvrez http://127.0.0.1:18789/ et collez le jeton dans les paramètres de l’interface de contrôle.

​

De quel runtime ai-je besoin

​

S’exécute-t-il sur Raspberry Pi

​

N’importe quel conseil pour l’installation du Raspberry Pi

• Utilisez un OS 64-bit et gardez Node >= 22.
• Préférez l’installation **hackable (git) pour que vous puissiez voir les logs et mettre à jour rapidement.
• Commencez sans canaux/compétences, puis ajoutez-les un par un.
• Si vous rencontrez des problèmes binaires bizarres, c’est généralement un problème de compatibilité ARM.

​

Il est coincé au réveil, mon ami embarquera ne va pas écloire ce que maintenant

1. Redémarrez la Gateway:

openclaw gateway restart

2. Vérifier le statut + l’authentification :

openclaw status
openclaw modèle l'état
logs openclaw --follow

3. Si elle reste suspendue, exécutez :

openclaw doctor

​

Puis-je migrer mon installation vers une nouvelle machine Mac mini sans réintégrer

1. Installez OpenClaw sur la nouvelle machine.
2. Copiez $OPENCLAW_STATE_DIR (par défaut: ~/.openclaw) de l’ancienne machine.
3. Copiez votre espace de travail (par défaut: ~/.openclaw/workspace).
4. Exécutez openclaw doctor et redémarrez le service Gateway.

​

Où puis-je voir ce qui est nouveau dans la dernière version

​

Je ne peux pas accéder à docs.openclaw.ai erreur SSL maintenant

​

Quelle est la différence entre stable et beta

• latest = stable
• beta = compilation anticipée pour tester

​

Comment puis-je installer la version bêta et quelle est la différence entre la béta et le développement

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

​

Combien de temps dure l’installation et l’intégration

• Installation : 2-5 minutes
• Intégration : 5-15 minutes selon le nombre de canaux/modèles que vous configurez

​

Comment puis-je essayer les derniers bits

1. Canal Dev (checkout) :

Mise à jour de openclaw --channel dev

2. Installation hackable (à partir du site de l’installateur):

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
build

​

Installateur coincé Comment obtenir plus de commentaires

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

​

L’installation de Windows dit que git n’est pas trouvé ou que openclaw n’est pas reconnu

• Installez Git pour Windows et assurez-vous que git est sur votre PATH.
• Fermez et rouvrez PowerShell, puis relancez l’installateur.

• Votre dossier de corbeille npm global n’est pas sur PATH.
• Vérifier le chemin :
  npm config get prefix
  
• Assurez-vous que <prefix>\\bin est sur PATH (sur la plupart des systèmes, c’est %AppData%\\npm).
• Fermer et rouvrir PowerShell après la mise à jour de PATH.

​

La documentation n’a pas répondu à ma question, comment puis-je obtenir une meilleure réponse

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

​

Comment installer OpenClaw sur Linux

• Chemin d’accès rapide Linux + installation du service : Linux.
• Parcours complet : [Pour commencer] (/start/getting-started).
• Installer + mises à jour : Installer & mettre à jour.

​

Comment installer OpenClaw sur un VPS

​

Où sont les guides d’installation cloudVPS

• VPS hosting (tous les fournisseurs en un seul endroit)
• Fly.io
• Hetzner
• exe.dev

​

Puis-je demander à OpenClaw de se mettre à jour

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart

openclaw update --yes --no-restart
openclaw gateway restart

​

Que fait l’assistant d’intégration

• Configuration du modèle/auth (setup-token Anthropic recommandé pour les abonnements Claude (OpenAI Codex OAuth supporté), clés API optionnelles, modèles locaux LM Studio pris en charge)
• Emplacement de Workspace + fichiers de bootstrap
• Paramètres de passerelle (bind/port/auth/tailscale)
• Fournisseurs (WhatsApp, Telegram, Discord, Mattermost (plugin), Signal, iMessage)
• Installation du démon (LaunchAgent sur macOS; systemd user unit sur Linux/WSL2)
• Sélection des examens de santé et des compétences

​

Ai-je besoin d’un abonnement Claude ou OpenAI pour exécuter ceci

​

Puis-je utiliser l’abonnement Claude Max sans clé API

​

Comment fonctionne l’authentification Anthropic setuptoken

​

Où puis-je trouver un setuptoken Anthropic

claude setup-token

​

Prends en charge l’authentification des abonnements Claude (Claude Pro ou Max)

​

Pourquoi est-ce que je vois HTTP 429 ratelimiterror de Anthropic

​

Est AWS Bedrock pris en charge

​

Comment fonctionne l’authentification Codex

​

Prise en charge de l’authentification aux abonnements OpenAI Codex OAuth

​

Comment configurer Gemini CLI OAuth

1. Activer le plugin: openclaw plugins enable google-gemini-cli-auth
2. Connexion : openclaw models auth login --provider google-gemini-cli --set-default

​

Est un modèle local OK pour les conversations occasionnelles

​

Comment conserver le trafic de modèles hébergés dans une région spécifique

​

Dois-je acheter un Mac Mini pour installer ceci

​

Ai-je besoin d’un Mac mini pour le support iMessage

• Exécutez la passerelle sur Linux/VPS et exécutez le serveur BlueBubbles sur n’importe quel Mac connecté à Messages.
• Exécutez tout sur Mac si vous voulez la configuration la plus simple de la machine simple.

​

Si j’achète un Mac mini pour exécuter OpenClaw puis-je le connecter à mon MacBook Pro

• Passerelle sur le Mac mini (toujours activé).
• MacBook Pro exécute l’application macOS ou un hôte de nœuds et associe la passerelle.
• Utilisez openclaw nodes status / openclaw nodes list pour le voir.

​

Puis-je utiliser Bun

​

Telegram ce qui se passe dans allowFrom

• DM votre bot, puis exécutez openclaw logs --follow et lisez from.id.

• DM votre bot, puis appelez https://api.telegram.org/bot<bot_token>/getUpdates et lisez message.from.id.

• DM @userinfobot ou @getidsbot.

​

Peut plusieurs personnes utiliser un numéro WhatsApp avec différentes instances OpenClaw

​

Puis-je exécuter un agent de chat rapide et un agent de codage Opus

​

Est-ce que les Homebrew fonctionnent sous Linux

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/bin/brew shellenv)"
brew install <formula>

​

Quelle est la différence entre l’installation hackable de git et l’installation de npm

• Installation hackable (git) : checkout source complet, éditable, meilleur pour les contributeurs. Vous exécutez des compilations localement et pouvez patcher du code/docs.
• npm install: installation globale de CLI, pas de dépôt, mieux pour « juste exécuter ». Les mises à jour proviennent des tags dist-tag npm.

​

Puis-je basculer entre npm et git plus tard

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart

npm install -g openclaw@latest
docteur openclaw
redémarrage de la passerelle openclaw

​

Devrais-je exécuter la passerelle sur mon ordinateur portable ou un VPS

• Pros: sans coût de serveur, accès direct aux fichiers locaux, fenêtre du navigateur en direct.
• Cons: mise en veille/cache réseau = déconnexions, interruption des mises à jour/redémarrage du système d’exploitation, doit rester allumée.

• Pros: toujours-on, réseau stable, pas de problèmes de sommeil des ordinateurs portables, plus facile de continuer.
• Cons: exécute souvent sans tête (utiliser des captures d’écran), accès aux fichiers distants uniquement, vous devez SSH pour les mises à jour.

​

Quelle importance attachez-vous à utiliser OpenClaw sur une machine dédiée

• Hébergement dédié (VPS/Mac mini/Pi) : toujours moins d’interruptions de mise en veille/redémarrage, autorisations de nettoyage, plus facile à continuer.
• Ordinateur portable/bureau partagé: parfaitement adapté aux tests et aux utilisations actives, mais s’attend à des pauses lorsque la machine se met en veille ou se met à jour.

​

Quelles sont les exigences minimales de VPS et le système d’exploitation recommandé

• Minimum absolu : 1 vCPU, 1 Go de RAM, ~500Mo de disque.
• Recommandé : 1-2 vCPU, 2Go de RAM ou plus pour les entrées (logs, médias, canaux multiples). Les outils de nœud et l’automatisation des navigateurs peuvent avoir faim de ressources.

​

Puis-je utiliser OpenClaw dans une VM et quelles sont les exigences

• Minimum absolu : 1 vCPU, 1 Go de RAM.
• Recommandé : 2 Go de RAM ou plus si vous exécutez plusieurs canaux, l’automatisation du navigateur ou des outils multimédia.
• OS: Ubuntu LTS ou un autre Debian/Ubuntu.

​

Qu’est-ce qu’OpenClaw ?

​

Qu’est-ce que OpenClaw dans un paragraphe

​

Quelle est la proposition de valeur

• Vos périphériques, vos données : exécutez la passerelle où vous voulez (Mac, Linux, VPS) et gardez l’espace de travail* l’historique des sessions en local.
• Les canaux réels, pas un bac à sable web : WhatsApp/Telegram/Slack/Discord/Signal/iMessage/etc, plus la voix mobile et Canvas sur les plateformes prises en charge.
• Indépendant du modèle : utilisez Anthropic, OpenAI, MiniMax, OpenRouter, etc., avec routage et bascule par agent.
• Option locale uniquement: exécutez des modèles locaux afin que toutes les données puissent rester sur votre appareil si vous le souhaitez.
• Routage multi-agents : agents séparés par canal, compte ou tâche, chacun avec son propre espace de travail et par défaut.
• Open source et hackable : inspecter, étendre et auto-héberger sans verrouillage par le vendeur.

​

Je viens de configurer ce que je devrais faire en premier

• Construire un site web (WordPress, Shopify, ou un simple site statique).
• Prototype d’une application mobile (contour, écran, plan API).
• Organiser les fichiers et les dossiers (nettoyage, nommage, tagging).
• Connectez Gmail et automatisez les résumés ou les suivis.

​

Quels sont les cinq premiers cas d’utilisation quotidienne pour OpenClaw

• briefings personnels: Résumés de la boîte de réception, du calendrier et des nouvelles qui vous intéressent.
• Recherche et rédaction : recherche rapide, résumés et premiers brouillons pour les e-mails ou les documentations.
• Rappels et suivi : coups de cron ou coups de coeur et listes de contrôle.
• Automatisation du navigateur: remplir des formulaires, collecter des données et répéter des tâches web.
• Coordination entre les appareils : envoyer une tâche depuis votre téléphone, laisser la passerelle l’exécuter sur un serveur, et récupérer le résultat dans le chat.

​

Est-ce qu’OpenClaw peut aider les publicités et les blogs pour un SaaS sur les technologies de pointe en matière de technologie de pointe

​

Quels sont les avantages vs Claude Code pour le développement web

• Mémoire persistante + espace de travail à travers les sessions
• Accès multi-plateforme (WhatsApp, Telegram, TUI, WebChat)
• orchestration d’outils (navigateur, fichiers, planification, crochets)
• Passerelle permanente (fonctionne sur un VPS, interagissez depuis n’importe où)
• Nodes pour navigateur/écran/caméra/exec local

​

Compétences et automatisation

​

Comment personnaliser les compétences sans laisser le dépôt sale

​

Puis-je charger des compétences à partir d’un dossier personnalisé

​

Comment puis-je utiliser différents modèles pour différentes tâches

• Tâches Cron: les tâches isolées peuvent définir une substitution de modèle par tâche.
• Sous-agents: router les tâches vers des agents séparés avec différents modèles par défaut.
• Basculement à la demande: utilisez /model pour changer le modèle de session actuel à tout moment.

​

Le bot se bloque tout en faisant un travail lourd Comment puis-je le décharger

​

Cron ou rappels ne tirent pas Que dois-je vérifier

• La confirmation de cron est activée (cron.enabled) et OPENCLAW_SKIP_CRON n’est pas défini.
• Vérifiez que la passerelle fonctionne 24 heures sur 24 et 7 jours sur 7 (sans sommeil/redémarrage).
• Vérifier les paramètres de fuseau horaire pour la tâche (--tz vs host timezone).

openclaw cron exécute <jobId> --force
openclaw cron exécute --id <jobId> --limit 50

​

Comment installer des compétences sur Linux

npm i -g clawhub

pnpm add -g clawhub

​

OpenClaw peut-il exécuter des tâches sur un calendrier ou en continu en arrière-plan

• Tâches Cron pour les tâches planifiées ou récurrentes (persistent à travers les redémarrage).
• Heartbeat pour les vérifications périodiques de la “session principale”.
• Emplois isolés pour les agents autonomes qui postent des résumés ou livrent des chats.

​

Puis-je utiliser les compétences d’Apple MacOS uniquement avec Linux?

1. Créer un wrapper SSH pour le binaire (exemple : memo pour les notes d’Apple ) :
   #!/usr/bin/env bash
   set -euo pipefail
   exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"
   
2. Mettez le wrapper sur PATH sur l’hôte Linux (par exemple ~/bin/memo).
3. Remplacer les métadonnées de la compétence (espace de travail ou ~/.openclaw/skills) pour autoriser Linux:
   ---
   nom: apple-notes
   description : Gérez les notes Apple via le mémo CLI sur macOS.
   métadonnées : { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] } }
   ---
   
4. Commencez une nouvelle session pour que l’instantané des compétences se rafraîchisse.

​

Avez-vous une intégration Notion ou HeyGen

• Compétence personnalisée / plugin : le mieux pour un accès fiable à l’API (Notion/HeyGen ont tous les deux des API).
• Automatisation du navigateur: fonctionne sans code mais est plus lent et plus fragile.

• Une page de notion par client (contexte + préférences + travail actif).
• Demandez à l’agent de récupérer cette page au début d’une session.

clawhub installe <skill-slug>
clawhub update --all

​

Comment installer l’extension Chrome pour la prise en charge du navigateur

openclaw browser extension install
openclaw browser extension path

​

Bac à sable et mémoire

​

Y a-t-il un doc de bac à sable dédié

​

Docker se sent limité Comment puis-je activer toutes les fonctionnalités

• Persiste /home/node avec OPENCLAW_HOME_VOLUME afin que les caches survivent.
• Cuire le système dans l’image avec OPENCLAW_DOCKER_APT_PACKAGES.
• Installez les navigateurs Playwright via le CLI: node /app/node_modules/playwright-core/cli.js installer chromium
• Définissez PLAYWRIGHT_BROWSERS_PATH et assurez-vous que le chemin est maintenu.

​

Comment lier un dossier hôte au sandbox

​

Comment fonctionne la mémoire

• Notes quotidiennes en mémoire/YYYY-MM-DD.md
• Notes à long terme conservées dans MEMORY.md (sessions main/private seulement)

​

La mémoire oublie sans cesse les choses comment je les fais coller.

​

La recherche dans la mémoire sémantique requiert-elle une clé API OpenAI

​

Est-ce que la mémoire persiste pour toujours Quelles sont les limites

​

Là où les choses vivent sur le disque

​

Toutes les données utilisées avec OpenClaw sont enregistrées localement

• Local par défaut: sessions, fichiers mémoire, configuration et espace de travail en direct sur l’hôte de passerelle (~/.openclaw + votre dossier d’espace de travail).
• Distante par nécessité: messages que vous envoyez aux fournisseurs de modèles (Anthropic/OpenAI/etc.) aller à leurs APIs, et leurs plateformes de chat (WhatsApp/Telegram/Slack/etc.) stocker les données des messages sur leurs serveurs .
• Vous contrôlez l’empreinte : en utilisant des modèles locaux garde les invites sur votre machine, mais le trafic du canal passe toujours par les serveurs du canal.

​

Où est-ce que OpenClaw stocke ses données

​

Où devrait vivre AGENTSmd SOULmd USERmd MEMORYmd

• Espace de travail (par agent): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md (ou memory.md), memory/YYY-MM-DD.md, optionnel HEARTBEAT.md.
• State dir (~/.openclaw): config, credentials, auth profiles, sessions, logs, et compétences partagées (~/.openclaw/skills).

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​

Quelle est la stratégie de sauvegarde recommandée

​

Comment désinstaller complètement OpenClaw

​

Les agents peuvent travailler en dehors de l’espace de travail

{
  agents: {
    par défaut : {
      workspace: "~/Projects/my-repo",
    },
  },
}

​

Je suis en mode distant où se trouve la boutique de session

​

Bases de la configuration

​

Quel est le format de la configuration Où est il

$OPENCLAW_CONFIG_PATH

​

J’ai défini passerellebind lan ou tailnet et maintenant rien n’écoute l’interface utilisateur non autorisé

{
  passerelle : {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me",
    },
  },
}

• gateway.remote.token est uniquement pour les appels CLI distants ; il n’active pas l’authentification de passerelle locale.
• L’interface de contrôle s’authentifie via connect.params.auth.token (stocké dans les paramètres de l’app/UI). Évitez de mettre des jetons dans les URL.

​

Pourquoi ai-je besoin d’un jeton sur localhost maintenant

​

Dois-je redémarrer après avoir modifié la configuration

• gateway.reload.mode: "hybrid" (par défaut) : appliquer les changements sûrs, redémarrer pour les changements critiques
• hot, restart, off sont également supportés

​

Comment puis-je activer la recherche web et la récupération web

{
  tools: {
    web: {
      search: {
        activé: true,
        apiKey : "BRAVE_API_KEY_ICI",
        maxResults: 5,
      },
      fetch : {
        enabled: true,
      },
    },
  },
}

• Si vous utilisez allowlists, ajoutez web_search/web_fetch ou group:web.
• web_fetch est activé par défaut (sauf désactivation explicite).
• Les démons lisent les variables env de ~/.openclaw/.env (ou de l’environnement de service).

​

Comment faire fonctionner une passerelle centrale avec des travailleurs spécialisés sur tous les appareils

• Gateway (central): possède des canaux (Signal/WhatsApp), routage et sessions.
• Nodes (devices): Macs/iOS/Android se connectent en tant que périphériques et exposent les outils locaux (system.run, canvas, camera).
• Agents (travailleurs): cerveaux/espaces de travail séparés pour des rôles spéciaux (par exemple “Hetzner ops”, “Données personnelles”).
• Sous-agents: l’arrière-plan de l’apparition d’un agent principal lorsque vous voulez un parallélisme.
• TUI: se connecter à la passerelle et commuter les agents/sessions.

​

Le navigateur OpenClaw peut-il fonctionner sans tête

{
  browser: { headless: true },
  agents: {
    par défaut : {
      sandbox: { browser: { headless: true } },
    },
  },
}

• Pas de fenêtre de navigateur visible (utilisez des captures d’écran si vous avez besoin de visuels).
• Certains sites sont plus stricts en ce qui concerne l’automatisation en mode sans tête (CAPTCHA, anti-bot). Par exemple, X/Twitter bloque souvent les sessions sans tête.

​

Comment utiliser Brave pour le contrôle du navigateur

​

Passerelles et nœuds distants

​

Comment les commandes se propagent entre Telegram la passerelle et les nœuds

​

Comment mon agent peut-il accéder à mon ordinateur si la passerelle est hébergée à distance

1. Exécutez la passerelle sur l’hôte permanent (VPS/home server).
2. Mettez l’hôte de la passerelle + votre ordinateur sur le même coup.
3. Assurez-vous que le WS de la passerelle est joignable (tunnel de connexion en réseau ou SSH).
4. Ouvrez l’application macOS localement et connectez-vous en mode Remote via SSH (ou direct tailnet) pour qu’il puisse s’enregistrer en tant que nœud.
5. Approuver le noeud sur la passerelle :
   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

L’échelle de queue est connectée mais je n’ai pas de réponse Ce qui est maintenant

• La passerelle est en cours d’exécution: openclaw gateway status
• Santé de la passerelle: status openclaw
• Santé du canal : status des canaux openclaw

• Si vous utilisez Tailscale Serve, assurez-vous que gateway.auth.allowTailscale est défini correctement.
• Si vous vous connectez via un tunnel SSH, confirmez que le tunnel local est en marche et pointe vers le port droit.
• Confirmez vos listes d’autorisations (DM ou groupe) inclure votre compte.

​

Deux instances OpenClaw peuvent-elles se parler avec des VPS locaux

openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to <chat-id>

​

Ai-je besoin d’un VPS séparé pour plusieurs agents

​

Y a-t-il un avantage à utiliser un nœud sur mon ordinateur portable personnel au lieu de SSH d’un VPS

• Aucun SSH entrant n’est requis. Les nœuds se connectent à la passerelle WebSocket et utilisent le jumelage de périphériques.
• Des contrôles d’exécution plus sûrs. system.run est bloqué par des listes d’autorisations/approbations de noeuds sur cet ordinateur portable.
• Plus d’outils de périphériques. Nodes expose canvas, camera et screen en plus de system.run.
• **Automatisation locale du navigateur. * Gardez la passerelle sur un VPS, mais exécutez Chrome localement et contrôlez le relais avec l’extension Chrome + un hôte de nœud sur l’ordinateur portable.

​

Devrais-je installer sur un second ordinateur portable ou simplement ajouter un nœud

​

Faire exécuter un service de passerelle aux nœuds

​

Y a-t-il une méthode RPC API pour appliquer la configuration

​

configapply a effacé ma configuration Comment puis-je récupérer et éviter cela

• Restaurer à partir d’une sauvegarde (git ou un ~/.openclaw/openclaw.json copié).
• Si vous n’avez pas de sauvegarde, ré-exécutez openclaw doctor et reconfigurez les canaux/modèles.
• Si cela était inattendu, remplissez un bogue et incluez votre dernière configuration connue ou une sauvegarde.
• Un agent de codage local peut souvent reconstruire une configuration fonctionnelle à partir des logs ou de l’historique.

• Utilisez openclaw config set pour de petits changements.
• Utilisez openclaw configure pour des modifications interactives.

​

Quelle configuration Sane minimale pour une première installation

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

Comment configurer l’échelle de queue sur un VPS et me connecter à partir de mon Mac

1. Installez + connectez-vous sur le VPS
   curl -fsSL https://tailscale.com/install.sh | sh
   sudo tailscale up
   
2. Installez + connectez-vous sur votre Mac
   • Utilisez l’application Tailscale et connectez-vous au même tailnet.
3. Activer MagicDNS (recommandé)
   • Dans la console d’administration en échelle de queue, activez MagicDNS pour que le VPS ait un nom stable.
4. Utilisez le nom d’hôte du réseau tail
   • SSH: ssh [email protected]
   • Passerelle WS: ws://votre-vps.tailnet-xxxx.ts.net:18789

openclaw gateway --tailscale serve

​

Comment puis-je connecter un nœud Mac à un serveur en échelle de queue de passerelle distante

1. Assurez-vous que le VPS + Mac est sur la même queue.
2. Utilisez l’application macOS en mode distant (SSH target can be the tailnet hostname). L’application va tunnel le port de la passerelle et se connecter en tant que nœud.
3. Approuver le nœud sur la passerelle :
   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

Env vars et .env chargement

​

Comment les variables d’environnement d’OpenClaw chargent-elles

• .env du répertoire de travail actuel
• un repli global .env depuis ~/.openclaw/.env (alias $OPENCLAW_STATE_DIR/.env)

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}

​

J’ai commencé la passerelle par le service et mes vars env ont disparu ce qui est maintenant

1. Mettez les clés manquantes dans ~/.openclaw/.env afin qu’elles soient ramassées même si le service n’hérite pas votre shell env.
2. Activer l’importation shell (opt-in convenience) :

{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

​

J’ai défini COPILOTGITHUBTOKEN mais le statut des modèles montre l’env Shell de Pourquoi

1. Mettez le jeton dans ~/.openclaw/.env:
   COPILOT_GITHUB_TOKEN=...
   
2. Ou activez l’importation du shell (env.shellEnv.enabled: true).
3. Ou ajoutez-le à votre bloc env de configuration (ne s’applique qu’en cas de manquance).

openclaw models status

​

Sessions et chats multiples

​

Comment démarrer une nouvelle conversation

​

Faire la réinitialisation automatique des sessions si je n’envoie jamais de nouvelles

{
  session: {
    idleMinutes: 240,
  },
}

​

Y a-t-il un moyen de faire une équipe d’instances OpenClaw un PDG et de nombreux agents

​

Pourquoi le contexte a-t-il été tronqué en milieu de tâche Comment le prévenir

• Demandez au bot de résumer l’état actuel et de l’écrire dans un fichier.
• Utilisez /compact avant de longues tâches, et /new lors du changement de thèmes.
• Gardez un contexte important dans l’espace de travail et demandez au bot de le lire.
• Utiliser des sous-agents pour un travail long ou parallèle de sorte que le chat principal reste plus petit.
• Choisissez un modèle avec une fenêtre de contexte plus grande si cela se produit souvent.

​

Comment puis-je réinitialiser complètement OpenClaw mais le garder installé

openclaw reset

openclaw reset --scope full --yes --non-interactive

openclaw onboard --install-daemon

• L’assistant d’intégration offre également Réinitialiser s’il voit une configuration existante. Voir Wizard.
• Si vous avez utilisé des profils (--profile / OPENCLAW_PROFILE), réinitialisez chaque dossier d’état (les valeurs par défaut sont ~/.openclaw-<profile>).
• Réinitialisation Dev : openclaw gateway --dev --reset (dev-only; efface dev config + credentials + sessions + workspace).

​

Je reçois des erreurs de contexte trop grandes comment puis-je réinitialiser ou compacte

• Compact (garde la conversation mais résume les anciennes tours):
  /compacte
  
  ou /compact <instructions> pour guider le résumé.
• Réinitialiser (nouvel ID de session pour la même touche de chat) :
  /new
  /reset
  

• Activer ou affiner le nettoyage de session (agents.defaults.contextPruning) pour couper la sortie de l’ancien outil.
• Utilisez un modèle avec une fenêtre de contexte plus grande.

​

Pourquoi est-ce que je vois la requête LLM rejetée messages NcontentXtooluseinput Champ requis

​

Pourquoi suis-je victime de coups de cœur toutes les 30 minutes

{
  agents: {
    par défaut: {
      heartbeat: {
        every: "2h", // ou "0m" pour désactiver
      },
    },
  },
}

​

Dois-je ajouter un compte bot à un groupe WhatsApp

{
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

​

Comment puis-je obtenir le JID d’un groupe WhatsApp

logs openclaw --follow --json

openclaw directory groups list --channel whatsapp

​

Pourquoi OpenClaw ne répond pas dans un groupe

• La mention de la barrière est activée (par défaut). Vous devez @mentionner le bot (ou faire correspondre mentionPatterns).
• Vous avez configuré channels.whatsapp.groups sans "*" et le groupe n’est pas autorisé.

​

Faire des threads de groupe partager le contexte avec des DMs

​

Combien d’espaces de travail et d’agents puis-je créer

• Croissance du disque : sessions + transcripts live sous ~/.openclaw/agents/<agentId>/sessions/.
• Coût du jeton : plus d’agents signifie plus d’utilisation simultanée du modèle.
• Opération forte: profils, espaces de travail et routage des canaux d’authentification par agent.

• Garder un espace de travail actif par agent (agents.defaults.workspace).
• Supprimez les anciennes sessions (supprimer les entrées JSONL ou de magasin) si le disque grossit.
• Utilisez openclaw doctor pour repérer les espaces de travail errants et les incompatibilités de profil.

​

Puis-je exécuter plusieurs bots ou chats en même temps Slack et comment dois-je configurer cela

• Hôte de passerelle permanente (VPS/Mac mini).
• Un agent par rôle (liaisons).
• Canaux(s) Slack liés à ces agents.
• Navigateur local via un relais d’extension (ou un nœud) lorsque nécessaire.

​

Modèles: par défaut, sélection, alias, changement de modèle

​

Quel est le modèle par défaut

agents.defaults.model.primary

​

Quel modèle recommandez-vous

​

Puis-je utiliser des modèles auto-hébergés llamacpp vLLM Ollama

​

Comment changer de modèle sans effacer ma configuration

• /model dans le chat (rapide, par session)
• set de modèles openclaw ... (mise à jour de la configuration du modèle)
• openclaw configure --section model (interactif)
• éditer agents.defaults.model dans ~/.openclaw/openclaw.json

​

Que font OpenClaw, Flawd et Krill pour les modèles

• OpenClaw + Flawd: Anthropic Opus (anthropic/claude-opus-4-6) - voir Anthropic.
• Krill: MiniMax M2.1 (minimax/MiniMax-M2.1) - see MiniMax.

​

Comment puis-je changer de modèle à la volée sans redémarrer

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

/modèle 3

/model opus@anthropic:default
/model opus@anthropic:work

/fr/model anthropic/claude-opus-4-6

​

Puis-je utiliser GPT 5.2 pour les tâches quotidiennes et Codex 5.3 pour le codage

• Changement rapide (par session): /model gpt-5.2 pour les tâches quotidiennes, /model gpt-5.3-codex pour le codage.
• Par défaut + switch: définissez agents.defaults.model.primary à openai/gpt-5.2, puis passez à openai-codex/gpt-5.3-codex lors du codage (ou inversement).
• Sous-agents: acheminer des tâches de codage vers des sous-agents avec un modèle par défaut différent.

​

Pourquoi est-ce que je vois le modèle n’est pas autorisé et alors aucune réponse

Model "provider/model" is not allowed. Use /model to list available models.

​

Pourquoi je vois le modèle inconnu minimaxMiniMaxM21

1. Mise à jour vers 2026.1.12 (ou depuis la source main), puis redémarrez la passerelle.
2. Assurez-vous que MiniMax est configuré (assistant ou JSON), ou qu’une clé API MiniMax existe dans les profils env/auth pour que le fournisseur puisse être injecté.
3. Utilisez l’id exact du modèle (sensible à la casse) : minimax/MiniMax-M2.1 ou minimax/MiniMax-M2.1-lightning.
4. Run:
   openclaw models list
   
   et choisissez dans la liste (ou /model list dans le chat).

​

Puis-je utiliser MiniMax comme valeur par défaut et OpenAI pour des tâches complexes

{
  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-... },
  agents: {
    defaults: {
      model: { primary: "minimax/MiniMax-M2. " },
      modèles: {
        "minimax/MiniMax-M2. ": { alias: "minimax" },
        "openai/gpt-5. ": { alias: "gpt" },
      },
    },
  },
}

/modèle gpt

• Agent par défaut : MiniMax
• Agent B par défaut : OpenAI
• Router par agent ou utiliser /agent pour basculer

​

Are opus sonnet gpt raccourcis internes

• opus → anthropique/claude-opus-4-6
• sonnet → anthropic/claude-sonnet-4-5
• gpt → openai/gpt-5.2
• gpt-mini → openai/gpt-5-mini
• gemini → google/gemini-3-pro-preview
• gemini-flash → google/gemini-3-flash-preview

​

Comment définir les alias des raccourcis du modèle

{
  agents: {
    par défaut: {
      model: { primary: "anthropic/claude-opus-4-6" },
      modèles: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropique/claude-haiku-4-5": { alias: "haiku" },
      },
    },
  },
}

​

Comment ajouter des modèles d’autres fournisseurs comme OpenRouter ou ZAI

{
  agents: {
    par défaut: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      modèles: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
  env: { OPENROUTER_API_KEY: "sk-or-. ." },
}

{
  agents: {
    defaults: {
      model: { primary: "zai/glm-4. " },
      modèles: { "zai/glm-4. ": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

• Exécutez openclaw agents add <id> et configurez l’authentification pendant l’assistant.
• Ou copiez auth-profiles.json de l’agent principal agentDir dans le nouvel agent agentDir.

​

Basculement du modèle et “Tous les modèles ont échoué”

​

Comment fonctionne le basculement

1. Rotation du profil d’authentification dans le même fournisseur.
2. Bascule de modele vers le modele suivant dans agents.defaults.model.fallbacks.

​

Que signifie cette erreur

Aucun identifiant trouvé pour le profil "anthropic:default"

​

Réparer la liste de contrôle pour Aucune information d’identification trouvée pour le profil anthropique par défaut

• Confirmer où vivent les profils d’authentification (nouveaux vs chemins existants)
  • Actuellement: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Legacy: ~/.openclaw/agent/* (migré par openclaw doctor)
• Confirmez que votre var env est chargé par la passerelle
  • Si vous définissez ANTHROPIC_API_KEY dans votre shell mais que vous exécutez la passerelle via le système/lancement, il se peut qu’elle ne l’hérite. Mettez-le dans ~/.openclaw/.env ou activez env.shellEnv.
• Assurez-vous de modifier le bon agent
  • Les configurations multi-agents signifient qu’il peut y avoir plusieurs fichiers auth-profiles.json.
• Etat de l’authentification et du modèle de vérification
  • Utilisez l'état des modèles openclaw pour voir les modèles configurés et si les fournisseurs sont authentifiés.

• Utilisez un setup-token
  • Exécutez claude setup-token, puis collez-le avec openclaw models auth setup-token --provider anthropic.
  • Si le jeton a été créé sur une autre machine, utilisez openclaw modèles auth paste-token --provider anthropic.
• Si vous voulez utiliser une clé API à la place.
  • Mettez ANTHROPIC_API_KEY dans ~/.openclaw/.env sur l’hôte de passerelle.
  • Effacer tout ordre épinglé qui force un profil manquant :
    L'ordre d'authentification des modèles openclaw --provider anthropique
    
• Confirmez que vous exécutez des commandes sur l’hôte de passerelle
  • En mode distant, les profils d’authentification sont en direct sur la machine de passerelle, pas sur votre ordinateur portable.

​

Pourquoi a-t-il également essayé Google Gemini et a échoué

​

Profils d’authentification : ce qu’ils sont et comment les gérer

​

Qu’est-ce qu’un profil d’authentification

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

​

Quels sont les identifiants de profil typiques

• anthropic:default (commun quand aucune identité email n’existe)
• anthropique :<email> pour les identités OAuth
• identifiants personnalisés que vous choisissez (par exemple anthropique:work)

​

Puis-je contrôler quel profil d’authentification est essayé en premier

# Par défaut, l'agent par défaut configuré (omit --agent)
l'ordre d'authentification des modèles openclaw get --provider anthropic

# Verrouiller la rotation sur un seul profil (n'essayez que celui-ci)
openclaw modèles auth ordre --provider anthropic:default

# Ou définir un ordre explicite (repli dans le provider)
modèle openclaw auth protocole --provider anthropic:work anthropic:work anthropic:default

# Forcer la substitution (revenir à config auth. rder / rond-robin)
modèles d'authentification openclaw clair --provider anthropique

Protocole d'authentification des modèles openclaw --provider anthropique --agent principal anthropic:default

​

Clé OAuth vs API quelle est la différence

• OAuth tire souvent parti de l’accès à l’abonnement (le cas échéant).
• Les clés API utilisent la facturation pay-per-jeton.

​

Passerelle : ports, “déjà en cours d’exécution”, et mode distant

​

Quel port la passerelle utilise-t-elle

--port > OPENCLAW_GATEWAY_PORT > gateway.port > default 18789

​

Pourquoi le statut de la passerelle openclaw dit-il que Runtime est en cours d’exécution mais que la sonde RPC a échoué

• Probe target: (l’URL que la sonde a réellement utilisée)
• Écoute: (ce qui est réellement lié sur le port)
• Dernière erreur de passerelle : (cause courante de la racine lorsque le processus est en cours mais que le port n’écoute pas)

​

Pourquoi le statut de passerelle openclaw montre-t-il la configuration cli et le service de configuration diffère-t-il

installation de la passerelle openclaw --force

​

Qu’est-ce qu’une autre instance de passerelle est déjà en écoute moyenne

​

Comment faire pour exécuter OpenClaw en mode distant que le client se connecte à une passerelle ailleurs

{
  gateway: {
    mode: "remote",
    remote: {
      url: "ws://gateway.tailnet:18789",
      token: "votre-jeton",
      password: "votre-mot de passe",
    },
  },
}

• openclaw gateway ne démarre que lorsque gateway.mode est local (ou que vous passez le drapeau de remplacement).
• L’application macOS surveille le fichier de configuration et bascule les modes en temps réel lorsque ces valeurs changent.

​

L’interface de contrôle dit non autorisé ou continue de reconnecter ce qui est maintenant

• L’UI Contrôle stocke le jeton dans la clé localStorage du navigateur openclaw.control.settings.v1.

• Rapide: openclaw dashboard (affiche + copie l’URL du tableau de bord, essaye de l’ouvrir; affiche l’indice SSH si sans chapeau).
• Si vous n’avez pas encore de jeton : docteur openclaw --generate-gateway-token.
• Si distant, le tunnel d’abord : ssh -N -L 18789:127.0.0.1:18789 user@host puis ouvrez http://127.0.0.1:18789/.
• Définissez gateway.auth.token (ou OPENCLAW_GATEWAY_TOKEN) sur l’hôte de la passerelle.
• Dans les paramètres de l’interface de contrôle, collez le même jeton.
• Toujours coincé? Exécutez openclaw status --all et suivez Troubleshooting. Voir Dashboard pour les détails d’authentification.

​

J’ai réglé le gatewaybind tailnet mais il ne peut pas lier d’écoute

• Démarrer l’échelle de queue sur cet hôte (donc il a une adresse 100.x), ou
• Basculez vers gateway.bind: "loopback" / "lan".

​

Puis-je exécuter plusieurs passerelles sur le même hôte

• OPENCLAW_CONFIG_PATH (configuration par instance)
• OPENCLAW_STATE_DIR (état par instance)
• agents.defaults.workspace (isolement de l’espace de travail)
• gateway.port (ports uniques)

• Utilisez openclaw --profile <name> … par instance (crée automatiquement ~/.openclaw-<name>).
• Définissez un gateway.port unique dans chaque configuration de profil (ou passez --port pour les exécutions manuelles).
• Install a per-profile service: openclaw --profile <name> gateway install.

​

Que signifie le code d’établissement de liaison 1008 invalide

• Vous avez ouvert l’URL HTTP dans un navigateur (http://...) au lieu d’un client WS.
• Vous avez utilisé le mauvais port ou chemin.
• Un mandataire ou un tunnel a supprimé les en-têtes d’authentification ou a envoyé une requête non passerelle.

1. Utilisez l’URL WS: ws://<host>:18789 (ou wss://... si HTTPS).
2. Ne pas ouvrir le port WS dans un onglet normal.
3. Si l’authentification est activée, incluez le jeton/mot de passe dans le cadre connect.

openclaw tui --url ws://<host>:18789 --token <token>

​

Journalisation et débogage

​

Où sont les logs

/tmp/openclaw/openclaw-YYYY-MM-DD.log

openclaw logs --follow

• macOS: $OPENCLAW_STATE_DIR/logs/gateway.log et gateway.err.log (par défaut: ~/.openclaw/logs/...; les profils utilisent ~/.openclaw-<profile>/logs/...)
• Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
• Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST

​

Comment démarrer le service de passerelle

statut de la passerelle openclaw
redémarrage de la passerelle openclaw

​

J’ai fermé mon terminal sous Windows comment puis-je redémarrer OpenClaw

wsl
status de la passerelle openclaw
redémarrage de la passerelle openclaw

openclaw gateway run

statut de la passerelle openclaw
redémarrage de la passerelle openclaw

openclaw gateway run

​

La passerelle est en place, mais les réponses n’arrivent jamais. Que dois-je vérifier

openclaw status
openclaw modèle l'état
canaux openclaw statut
logs openclaw --follow

• L’authentification du modèle n’est pas chargée sur l’hôte de passerelle (vérifiez le statut des modèles).
• Réponses de blocage de l’appairage des canaux/listes de blocage (vérifiez la configuration des canaux + les logs).
• WebChat/Dashboard est ouvert sans le jeton droit.

​

Déconnecté de la passerelle, aucune raison ce qui est maintenant

1. La passerelle est-elle en cours d’exécution ? openclaw gateway status
2. La passerelle est-elle en bonne santé ? openclaw status
3. L’interface utilisateur dispose-t-elle du bon jeton ? openclaw dashboard
4. Si la télécommande, est-ce que le tunnel/échelle de queue est en haut?

openclaw logs --follow

​

Telegram setMyCommands échoue avec des erreurs de réseau Que dois-je vérifier

statut des canaux openclaw
openclaw channels logs --channel telegram

​

TUI ne montre aucune sortie que je devrais vérifier

openclaw status
openclaw modèle l'état
logs openclaw --follow

​

Comment puis-je arrêter complètement puis démarrer la passerelle

arrêt de la passerelle openclaw
démarrage de la passerelle openclaw

openclaw gateway run

​

Redémarrage de la passerelle ELI5 openclaw vs passerelle openclaw

• openclaw gateway restart: redémarre le service d’arrière-plan (launchd/systemd).
• passerelle openclaw: exécute la passerelle au premier plan pour cette session de terminal.

​

Quel est le moyen le plus rapide d’obtenir plus de détails lorsque quelque chose échoue

​

Médias et pièces jointes

​

Ma compétence a généré une image PDF mais rien n’a été envoyé

message openclaw send --target +155550123 --message "Here you go" --media /path/to/file.png

• Le canal cible prend en charge les médias sortants et n’est pas bloqué par les listes d’autorisations.
• Le fichier est dans les limites de taille du fournisseur (les images sont redimensionnées à 2048px).

​

Contrôle de sécurité et d’accès

​

Est-il sécuritaire d’exposer OpenClaw aux DMs entrants

• Le comportement par défaut sur les canaux compatibles avec le DM est appairage:
  • Les expéditeurs inconnus reçoivent un code d’appairage ; le bot ne traite pas leur message.
  • Approuver avec: l'appairage openclaw approuve <channel> <code>
  • Les requêtes en attente sont plafonnées à 3 par canal; vérifiez openclaw pairing list <channel> si un code n’est pas arrivé.
• L’ouverture des DMs nécessite un opt-in explicite (dmPolicy: "open" et allowlist "*").

​

Est l’injection de prompt seulement une préoccupation pour les robots publics

• en utilisant un agent “reader” en lecture seule ou désactivé par l’outil pour résumer le contenu non approuvé
• Garder web_search / web_fetch / browser à l’abri des agents activés par les outils
• sandboxing et outils stricts listes d’autorisations

​

Si mon bot a son propre compte GitHub ou son propre numéro de téléphone

​

Puis-je lui donner une autonomie par rapport à mes messages textuels et est-ce sûr

• Garder les MP en mode appairage ou dans une liste d’autorisations serrée.
• Utilisez un numéro séparé ou compte si vous voulez qu’il message en votre nom.
• Laissez-le brouiller, puis approuver avant d’envoyer.

​

Puis-je utiliser des modèles moins chers pour des tâches personnelles d’assistant

​

J’ai commencé dans Telegram mais je n’ai pas obtenu de code d’appairage

openclaw pairing list telegram

​

WhatsApp va envoyer un message à mes contacts Comment fonctionne l’appairage

L'appairage openclaw approuve whatsapp <code>

liste d'appairage openclaw whatsapp

​

Commandes de chat, abandon des tâches, et “ça ne s’arrêtera pas”

​

Comment empêcher les messages internes du système de s’afficher dans le chat

/verbose off
/reasoning off

​

Comment arrêter une tâche en cours d’exécution

arrêter
abandonner
esc
attendre
sortie
interrupt

action de traitement:kill sessionId:XXX

​

Comment envoyer un message Discord depuis la messagerie Crosscontext de Telegram refusée

{
  agents: {
    par défaut: {
      tools: {
        message: {
          crossContext: {
            allowAcrossProviders: true, Marqueur
            : { activé: vrai, préfixe : "[de {channel}] " },
          },
        },
      },
    },
  },
}

​

Pourquoi est-ce que le bot ignore les messages rapidfire

• steer - les nouveaux messages redirigent la tâche actuelle
• followup - lance un message à la fois
• collect - envoi de messages par lots et réponse une fois (par défaut)
• steer-backlog - orientez maintenant, puis traitez le backlog
• interrupt - interrompre l’exécution en cours et démarrer le nouveau

​

Répondre à la question exacte de la capture d’écran/journal de chat