[Résolu] OpenClaw : erreur HTTP 500:404 NOT_FOUND après une mise à jour ? Mon retour d'expérience et la solution

OpenClaw : erreur HTTP 500 500:404 NOT_FOUND après mise à jour ? Mon retour d’expérience

Bonjour à tous, c’est le développeur qui adore bidouiller les outils IA en local. Récemment, j’ai mis à jour OpenClaw vers la dernière version. Enfin, pas si vieille que ça : juste de 2026.3.2 à 2026.3.8. Et au redémarrage, catastrophe — la Web UI affichait un joli message d’erreur en rouge :

HTTP 500 500:404 NOT_FOUND

Rien que de le regarder, ça faisait mal. Tout marchait nickel avant la mise à jour, les logs n’avaient rien signalé d’anormal, et là, impossible de se connecter au gateway, l’agent restait figé quand j’envoyais un message.

Mon premier réflexe, c’est bien sûr la clé universelle recommandée officiellement : openclaw doctor.

openclaw doctor --fix

Je l’ai lancé deux fois. À chaque fois, la réponse c’était « Everything looks good! », sans même un avertissement. Je me suis dit, là c’est mort, la configuration doit être complètement pétée. J’ai fouillé les issues GitHub, le serveur Discord, la doc, j’ai tout cherché. Il y avait bien quelques bugs similaires avec des 404, mais c’était surtout des histoires de fallback de modèle ou de l’API Responses d’OpenAI. Rien à voir avec mon « tout plante après la mise à jour ».

Après presque une heure de galère, j’étais sur le point de tout désinstaller et réinstaller (mais je n’osais pas, j’avais mes channels et skills bien configurés). Finalement, en mode « nothing to lose », j’ai tenté la méthode la plus bourrin : lancer directement openclaw onboard pour réinitialiser la config. (Pensez bien à sauvegarder votre fichier de configuration original et le dossier skills avant. Les plus avertis pourront faire un comparatif et remplacer manuellement.)

Concrètement, ça se résume à deux étapes :

1. D’abord, arrêter le gateway en cours (par précaution) :

   openclaw gateway stop
   # ou systemctl stop openclaw-gateway (selon comment vous avez installé le daemon)

2. Lancer l’assistant de réinitialisation :

   openclaw onboard --reset

   (Attention, ajouter --reset va effacer l’ancien config + credentials + sessions. La doc indique que c’est le comportement par défaut. Moi j’ai utilisé le reset complet --reset-scope full, de toute façon j’avais tout sauvegardé.)

L’assistant propose « Quick Start » tout du long, j’ai reconfiguré le token API, les channels… et j’ai remarqué que les options de configuration s’étaient enrichies, avec la compatibilité pour le dernier modèle ChatGPT 5.4. Le tout a pris moins de 3 minutes. (Ça aide d’avoir installé plus de 10 fois…)

Dernière étape, choisir d’utiliser le Web UI, la page s’ouvre automatiquement. Dites « hello », et là, la conversation fonctionne normalement ! Le satané 500:404 avait disparu sans laisser de trace.

Pourquoi doctor n’a rien pu faire, alors que onboard a tout sauvé ?

C’est en fait un cas classique de « configuration héritée après mise à jour ». OpenClaw évolue vite (avant ça s’appelait ClawdBot/Moltbot), début mars il y avait déjà eu 4 versions. Chaque saut de version peut modifier le schéma de config, et la doc ne met pas particulièrement l’accent sur « il faut refaire un onboard à chaque mise à jour ». J’ai appris à mes dépens, alors je laisse ce petit retour d’expérience pour ceux qui viendront après.

Cette galère m’a certes fait perdre un peu de temps, mais j’ai aussi approfondi ma compréhension du système de configuration d’OpenClaw. Moralité : aussi performants soient-ils, les outils IA locaux, il faut toujours mettre à jour avec précaution.

J’espère que ce petit article aidera ceux qui sont sous l’emprise du 500:404 ! À la prochaine ~