Une fois qu'OpenClaw est installé et en cours d'exécution, le chat peut toujours afficher « l'outil a été exécuté mais le résultat est vide » exit code 1, « commande refusée par la stratégie » ou un longue suspension. Le problème n’est généralement pas ce que dit le modèle, c’est le processus enfant, répertoire de travail, stratégie d'approbation et autorisations macOS. Ce guide s'adresse à 2026 opérateurs sur un Mac distant via VNC qui a besoin d'un chemin de tri reproductible : les points douloureux qui le font pas dupliquez l'aide-mémoire sur les erreurs courantes à l'échelle du site ; un matrice symptôme × cause; sept étapes ordonnées de openclaw doctor via la passerelle et la confidentialité ; quatre seuils chiffrés; FAQ ; et une conclusion qui est naturellement liée à la location d'un Mac graphique distant. Après avoir lu, vous devez savoir s'il faut d'abord lire les journaux, les approbations ou les invites de l'interface utilisateur.
1. Pourquoi le message d'erreur générique ne suffit pas
- On dirait "pas de réponse": le sous-processus outil est déjà terminé mais l'assistant affiche une chaîne vide ; sans journaux de débogage, vous blâmez le modèle ou le contexte – mauvaise direction.
- code de sortie et stderr tronqué: certains clients affichent uniquement la dernière ligne ; les sessions à distance sans niveau de journalisation complet perdent « le chemin n'existe pas » ou « Opération non autorisée ».
- Approbations et bac à sable ensemble: depuis 2026.3.x, « l'outil doit être approuvé » et « le répertoire ne figure pas sur la liste autorisée » sont courants ; La politique multi-espaces de travail ou de plugin empile les échecs différemment d’une simple faute de frappe.
- cwd contre launchd/shell: sur un Mac distant, le démon
$PWDpeut différer de votre terminal VNC, donc les outils de chemin relatif échouent par intermittence. - Points aveugles SSH: les invites pour autoriser l'automatisation du Terminal/Finder ou l'accès au trousseau nécessitent des clics ; SSH affiche uniquement un délai d'attente, distinct de l'accessibilité de la passerelle.
- Division du travail avec l'article sans réponse: si les messages sont totalement silencieux et que vous avez besoin de battements de cœur/réflexion/cron, lisez Tâches sans réponse d'abord. Cette page cible chaîne d'outils invoquée mais l'exécution a échoué avec des signaux observables.
2. Catégories de symptômes et matrice de décision
| Ce que tu vois | Suspecter d'abord | Première action | vs liste principale des erreurs courantes |
|---|---|---|---|
Effacer exit code != 0 et stderr mentionne le chemin/autorisation | Commande + système de fichiers | Réexécutez la même commande manuellement dans le même cwd | La liste principale fausse l'installation/deps ; ici nous nous concentrons sur outils d'exécution |
/approve ou déni de politique | Approbation du plugin/liste autorisée | Vérifiez les approbations OpenClaw et les liaisons de canal dans la configuration | Liens vers l'approbation du plugin et les publications MCP du navigateur |
| Se bloque jusqu'à l'expiration du délai, pas de sortie | Réseau, invite GUI, blocage des E/S | Ouvrez VNC pour les boîtes de dialogue cachées ; concurrence inférieure | vs non-réponse : ici, vous avez généralement un identifiant d'appel d'outil |
| Uniquement sur le nœud distant, Mac local OK | Env, chemins, montages sandbox | Comparez env et openclaw status; montage du répertoire de données | Souligne triangle à distance, pas réinstaller |
| Démarré juste après la mise à niveau | Briser les valeurs par défaut, bac à sable plus strict | Courir openclaw doctor --fix et lisez les notes de version | Complète l'article de mise à niveau v2026.4.5 |
Si vous êtes bloqué sur « Dois-je réinstaller », terminez le sept étapes ci-dessous en premier ; la plupart des pannes d'outils sont mappées à une seule couche dans les 30 minutes sans réinstallation complète du système d'exploitation.
3. Sept étapes ordonnées (notes Mac à distance)
Version du code PIN et instantané de configuration
Enregistrer openclaw --version, chemin de configuration et profil ; sur les nœuds distants, notez launchd/cron donc « le manuel fonctionne, le démon échoue » est comparable.
Courir openclaw doctor
Corrigez d'abord les éléments rouges ; si --fix est recommandé, appliquez-le puis réessayez l'outil (identique au flux de mise à niveau v2026.4.5).
Confirmer les chemins cwd et inscriptibles
Rechercher dans les journaux les outils cwd; dans une exécution de terminal VNC pwd et ls pour aligner. Les outils de chemin relatif sont sensibles au CWD.
Capturez le stderr complet et le code de sortie
Augmentez temporairement le niveau de journalisation pour voir le dernier écran d'une sortie non nulle ; sur les nœuds distants, enregistrez une session défaillante dans un fichier pour comparaison.
Vérifier les approbations / la politique des plugins
Si l'outil est un plugin ou un binaire externe, confirmez /approve ou des entrées de liste blanche ; les configurations multi-espaces de travail vérifient les points de liaison des canaux dans le bon répertoire.
Vérifier la passerelle et la console
Ouvrez la console Web dans un navigateur ; confirmer que les ID d'appel de session et d'outil correspondent. Si seul WebSocket est erroné, corrigez le proxy inverse et les ports (article Gateway), et non aveuglément le script de l'outil.
VNC : confidentialité et dialogues
Pour l'automatisation ou l'accès au bureau, vérifiez Paramètres système → Confidentialité et sécurité pour le terminal/automatisation ; cliquez sur Autoriser dans les invites, puis réessayez avec le même outil et surveillez le code de sortie.
4. Notes et seuils citables
EACCES, EPERM, ou le libellé du bac à sable, exécutez la commande manuellement dans VNC en tant que même utilisateur. Le succès manuel + l'échec d'OpenClaw signifie généralement cwd ou politique, et non un binaire corrompu.- ✅ Reproduit manuellement dans le même cwd avec stderr enregistré
- ✅ L'état d'approbation et les versions du plugin correspondent à OpenClaw actuel
- ✅ Les invites système et les éléments de confidentialité exclus sous VNC
5. Liste de contrôle de l'interface graphique VNC (boîtes de dialogue et paramètres)
Sur un nœud loué, exécutez ceci avec les runbooks de première exécution et de réseau d'entreprise : ① même utilisateur macOS connecté ; ② pas de boîtes de dialogue de sécurité obsolètes après le verrouillage de l'écran ; ③ ne pas s'appuyer uniquement sur SSH lorsqu'une invite existe ; ④ Déverrouillage du trousseau effectué sur le bureau VNC ; ⑤ Passerelle liée à l'hôte local pendant que le navigateur atteint une autre carte réseau : toute inadéquation peut ressembler à une « échec de l'outil » au lieu d'une passerelle désactivée.
6. FAQ, articles associés, clôture
Q : Réinstaller d'abord le répertoire de données ? Seulement si doctor signale une corruption de fichier principal ; la plupart des problèmes de code de sortie sont liés au chemin et à la politique.
Q : Docker ou Bare Metal ? Les conteneurs n'ont pas d'interface graphique hôte ; Le presse-papiers, le navigateur et certaines autorisations macOS diffèrent : lisez la publication Docker avec les approbations cwd + ici.
Connexes : Erreurs courantes d'OpenClaw (10 solutions), Pas de tri des réponses, proxy de passerelle publique, mise à niveau v2026.4.5 + doctor --fix, navigateur MCP.
Clôture : reconstituez les défaillances de la couche d'outils en signaux observables
La modification des invites dans le chat ne peut pas corriger les autorisations des sous-processus ; sans session graphique, blocage rapide est facile de se confondre avec desquamation du modèle. Traiter code de sortie, stderr, approbations et chronologie comme triangle de triage, puis utilisez un Bureau macOS visible par VNC pour l'autorisation du système - c'est le combo stable pour OpenClaw en 2026. Si vous ne souhaitez pas posséder un Mac toujours actif mais que vous avez besoin d'un vrai macOS pour les outils et les autorisations, louer un Mac distant VNC (par exemple VNCMac) fait de « voir, cliquer, faire correspondre les journaux » le flux de travail par défaut. Choisissez un nœud sur la page d'accueil ou d'achat, joignez cette liste en sept étapes à votre runbook et, dans la prochaine version, testez de régression trois anciens échecs : si vous pouvez regrouper chacun d'eux dans les 15 minutes vers cwd/approbation/autorisation/passerelle, le processus est fermé.