type: rapport projet: OpenClaw date: 2026-09-18 statut: en_cours tags:
- ia
- agent
- setup
- fedora
Rapport OpenClaw Fedora Setup
| Projet | OpenClaw 2026.9.4 — assistant IA personnel (gateway + dashboard + messagerie WhatsApp) |
| Date | 2026-09-18 |
| Statut | ✅ Gateway installé et lancé (127.0.0.1:18789) — couche modèle (Ollama) en attente |
| Contexte | Migration Windows → Fedora 44 (Zelus), continuation de Projects/OpenClaw Setup.md |
1. Environnement & contraintes
- Machine : Fedora Linux 44, noyau
7.1.13-200.fc44.x86_64. Même machine que le vault Obsidian. - Limite sandbox : je tourne dans le sandbox Flatpak d’Obsidian (
org.freedesktop.platform). Le sandbox partage mon vrai home (/home/sambasene) en lecture/écriture, donc les installs utilisateur persistent — mais :- ❌ Pas de
sudoni pas desystemctl(la supervision des services vit sur l’hôte) - ✅
nodev24.20.0 +npm11.19.0 dans~/.local/opt/node(install utilisateur, sur le PATH via.bashrc), réseau OK
- ❌ Pas de
- État à l’arrivée :
~/.openclaw/avait été copié depuis Windows (23 août) — config, credentials, devices, workspace, base d’état SQLite présents. Le CLI lui-même n’était pas installé sur cette machine. - Pourquoi Node ≥ 24.15.0 compte : sous Windows, npm bloquait
openclaw@latestcar le build exige Node ≥ 24.15.0 < 25 (cf. Projects/OpenClaw Setup.md). Ici Node 24.20.0 qualifie — la version complète s’installe proprement.
2. Étapes chronologiques
Phase 1 — Installation du CLI (2026-09-18, depuis Claudian dans Obsidian)
- Vérification des prérequis :
node --version→v24.20.0,npm --version→11.19.0, ports 18789/11434 libres, binaireopenclawabsent. - Installation globale :
npm install -g openclaw # → openclaw@2026.9.4, 330 paquets, ~3 min - ⚠️ npm 11.19.0 a bloqué les scripts d’installation (garde
allow-scripts). Mon~/.npmrcglobal contientallow-scripts=netlify-cli,esbuild,unix-dgram,sharp— les pre/postinstall d’openclaw (plugins embarqués) et les builds natifs (koffi,tree-sitter-bash,protobufjs) ont été sautés. Correctif :npm install -g --allow-scripts=openclaw,@google/genai,koffi,tree-sitter-bash,protobufjs openclaw - ✅ Vérifié :
openclaw --version→OpenClaw 2026.9.4 (3a9d69d). Binaire :~/.local/opt/node/bin/openclaw(déjà sur le PATH hôte via.bashrc).
Phase 2 — Revue de la config (migrée depuis Windows)
- ✅ Aucun chemin
C:\dans~/.openclaw/openclaw.json - ✅ Workspace
~/.openclaw/workspaceprésent avec contenu - ✅ Canal WhatsApp intact (
enabled: true, groupe120363425343912084@g.usavec politiques d’outils par expéditeur) - ✅
credentials/whatsapp/+whatsapp-pairing.jsonmigrés - ✅ Section gateway : auth par token,
bind=loopback, port 18789
Phase 3 — Premier boot : migration de la base d’état requise
openclaw gateway run refuse de démarrer :
OpenClaw state database schema migration required (audit-events-v2) at
/home/sambasene/.openclaw/state/openclaw.sqlite; run openclaw doctor --fix to migrate it.
Cause racine : la base SQLite a été migrée en dernier par OpenClaw 2026.7.1-2 (build portable-node de Windows, 23 août). Le schéma 2026.9.4 ajoute audit-events-v2.
Phase 4 — Doctor bloqué par la vérification de propriété du service
openclaw doctor --fix échoue en boucle :
Doctor could not enter maintenance. Error: Gateway service ownership or shutdown could not be verified.
Analyse du code installé (doctor-maintenance-*.mjs, doctor-service-repair-policy-*.mjs) :
- Le doctor n’entre en maintenance qu’après inspection du service gateway géré. En conteneur, il cherche une unité systemd user installée — il y en a une (enregistrée au premier run du CLI), mais dans le sandbox Flatpak
systemctlest indisponible, la lecture du service lève une erreur → verdictunavailable→ maintenance bloquée. - Traces Windows obsolètes trouvées dans la base : ligne
currentdegateway_restart_handoff(PID 11672,supervisor_mode=schtasks, expirée le 21 août) + ungateway_restart_intentpérimé.gateway stop --force/gateway stopne les effacent pas.
Correctifs appliqués (dans l’ordre) :
- Suppression des deux clés que le nouveau CLI rejetait (cf. Phase 5).
- Sauvegarde de la base (
openclaw.sqlite.bak-20260918) puis suppression des lignes handoff/intent périmées. (Diagnostic — ne débloque pas seul.) - ✅ Correctif décisif — l’échappatoire documentée dans
doctor-service-repair-policy-*.mjs:
Le doctor saute alors totalement l’inspection du service et ne répare que l’état qu’il possède. Résultat : base migrée, stores de pairage legacy (OPENCLAW_SERVICE_REPAIR_POLICY=external openclaw doctor --fixdevices/paired.json,pending.json, 3 devices) importés dans SQLite, config réécrite avec sauvegarde.
Phase 5 — Config rejetée par le nouveau CLI
Le CLI 2026.9.4 rejette deux clés écrites par le CLI 2026.2.15 (miroir inversé du problème Windows) :
meta.lastTouchedAt— non reconnuegateway.tailscale.resetOnExit— non reconnue
Correctif (sauvegarde openclaw.json.bak-20260918 d’abord, puis édition parsée) :
delete c.meta?.lastTouchedAt;
delete c.gateway?.tailscale?.resetOnExit;
Après retrait : openclaw gateway status --deep parse la config proprement.
Phase 6 — Gateway en ligne
nohup ~/.local/opt/node/bin/openclaw gateway run > ~/.openclaw/logs/gateway-fedora.log 2>&1 &
Vérifié :
- ✅ Processus
openclaw-gatewayvivant - ✅
curl http://127.0.0.1:18789/→ HTTP 200 - ✅ Log de démarrage : “http server listening (15 plugins: … whatsapp, xai …)” , “[gateway] ready”, heartbeat démarré
- ✅ WhatsApp : provider démarré
(+221789229104), “Listening for WhatsApp inbound messages (DM + 1 configured group)” — la session migrée fonctionne - ✅
openclaw status: gateway joignable (567 ms), agentmainactif, sessions 4, plugin memory-core activé - Logs :
/tmp/openclaw/openclaw-2026-09-18.log+~/.openclaw/logs/gateway-fedora.log
3. Erreurs & correctifs
| # | ❌ Erreur / blocage | ✅ Correctif | Note |
|---|---|---|---|
| 1 | npm 11.19.0 a sauté les scripts d’install (allowlist allow-scripts du ~/.npmrc) | npm install -g --allow-scripts=openclaw,@google/genai,koffi,tree-sitter-bash,protobufjs openclaw | Vérifier le .npmrc global avant de faire confiance à une install « réussie » |
| 2 | Migration de schéma requise (audit-events-v2) | OPENCLAW_SERVICE_REPAIR_POLICY=external openclaw doctor --fix | Base migrée en dernier par le build Windows 2026.7.1-2 |
| 3 | Doctor : « service ownership or shutdown could not be verified » | Même override par variable d’env ; suppression des lignes restart_handoff/restart_intent Windows obsolètes après sauvegarde | Conteneur + inspection systemd-user ne font pas bon ménage |
| 4 | Config rejetée : meta.lastTouchedAt, gateway.tailscale.resetOnExit | Clés supprimées (sauvegarde conservée) | Clés d’un vieux CLI vs validateur du nouveau — même classe de problème que le fix Windows du 21-08 |
4. Constats racine
- Le décalage de versions gouverne tout. Config écrite par 2026.2.15, base migrée par 2026.7.1-2, CLI 2026.9.4 — chaque frontière a produit sa propre incompatibilité. Le chemin sûr : CLI ↔ config ↔ base à la même version (les notes Windows du 21-08 disaient l’inverse, même conclusion).
- Le mode maintenance du doctor exige un service gateway lisible, même quand on ne veut qu’une migration de base. En sandbox (Flatpak/conteneur) sans
systemctl, l’inspection lève une erreur et bloque tout.OPENCLAW_SERVICE_REPAIR_POLICY=externalest le contournement officiel : le doctor traite le service comme géré en externe et ne répare que l’état. - npm 11.19.0 est hostile aux scripts par défaut dans cet environnement : l’allowlist
allow-scriptsdu~/.npmrcglobal fait que tout nouveau paquet global saute silencieusement ses scripts de build tant qu’on ne l’opte pas avec--allow-scripts. Piège propre à la machine, pas à OpenClaw. - Les pairages migrés survivent — 3 devices (control-ui ×2, tui) importés dans SQLite au premier boot ; session WhatsApp restaurée sans re-scanner le QR.
5. Tableau de statut
| Élément | Statut | Priorité |
|---|---|---|
| CLI installé (2026.9.4, Node 24.20.0) | ✅ | — |
| Config migrée & validée (aucun chemin Windows) | ✅ | — |
Base d’état migrée (audit-events-v2) | ✅ | — |
| Gateway sur 127.0.0.1:18789 (HTTP 200) | ✅ | — |
Dashboard http://127.0.0.1:18789/ (auth token) | ✅ | — |
| Canal WhatsApp (DM + 1 groupe) | ✅ à l’écoute | — |
| Ré-approbation du device (refresh openclaw-tui) | ⚠️ en attente — approuver depuis le dashboard/TUI sur l’hôte | moyenne |
| Couche modèle : Ollama + modèles | ❌ absent — Ollama pas encore installé. Primaire déjà réaligné sur ollama/qwen2.5:3b (le défaut Windows documenté, conforme au revert du 23-08 ; hot-reload appliqué par le gateway) | haute |
| Démarrage automatique persistant (unité systemd user existante, désactivée) | ⚠️ à faire sur l’hôte : openclaw gateway install | moyenne |
6. Tableau credentials / config
| Élément | Valeur | Note |
|---|---|---|
| Dashboard | http://127.0.0.1:18789/ | loopback uniquement |
| Token d’auth gateway | 215e4b2ea0d30c61ad476a8d04f89a66a2e6bf4d149db540 | ⚠️ token local ; à faire pivoter si exposé hors loopback |
| Bind gateway | loopback, port 18789 | gateway.bind, gateway.port |
| Modèle principal | ollama/qwen2.5:3b | défini le 2026-09-18 pour coller au défaut Windows documenté (note projet 23-08) ; ancienne valeur gemma4:26b |
| Liste des modèles | ollama/qwen2.5:3b, ollama/gemma4:26b | les deux nécessitent un serveur Ollama |
| Provider WhatsApp | +221789229104 | session migrée depuis Windows |
| Groupe WhatsApp | 120363425343912084@g.us | politiques d’outils par expéditeur intactes |
| Fichiers de config | ~/.openclaw/openclaw.json (+ backups .bak-20260918, .bak) | ACL : utilisateur seul |
| Base d’état | ~/.openclaw/state/openclaw.sqlite (+ .bak-20260918) |
7. Blocs de config réutilisables
Contournement variable d’env pour réparation stateless (sandbox / sans systemctl) :
OPENCLAW_SERVICE_REPAIR_POLICY=external openclaw doctor --fix
Transcript complet install + lancement :
npm install -g --allow-scripts=openclaw,@google/genai,koffi,tree-sitter-bash,protobufjs openclaw
nohup openclaw gateway run > ~/.openclaw/logs/gateway-fedora.log 2>&1 &
Contrôle de démarrage :
openclaw status
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:18789/
8. Dernier snapshot de vérification (2026-09-18 23:45)
$ openclaw status
Gateway → local · ws://127.0.0.1:18789 · reachable (567ms) · auth token
Agents → 1 · sessions 4 · default main active · model gemma4:26b (131k ctx)
Channels → whatsapp listening (DM + 1 group)
9. Travail en option / futur
- Ollama (bloquant pour toute réponse de l’assistant) : installer côté utilisateur ou via l’hôte
sudo dnf install ollama;ollama pull qwen2.5:3b(~2 Go) ; trancher le modèle principal ; tester un chat depuis le dashboard. - Gateway persistant : sur le terminal hôte →
openclaw gateway install,openclaw gateway enable,openclaw gateway start(l’unité systemd user a été auto-enregistrée mais est désactivée). Dans le sandbox, le gateway meurt avec la session Obsidian. - Re-connecter des providers cloud (OpenAI-style) si je veux le web search et le profil d’outils complet.
- Pivoter/garder le token gateway consciemment ; revoir le compromis
allowInsecureAuth(hérité des constats d’audit Windows), cf. Projects/OpenClaw Setup.md.
10. Leçons apprises
- Toujours CLI ↔ config ↔ base à la même version. Chaque mélange de versions crée une incompatibilité neuve à chaque frontière.
OPENCLAW_SERVICE_REPAIR_POLICY=externalest le sésame du doctor en sandbox.- Le
allow-scriptsde npm 11.19.0 rend les installs globales silencieusement incomplètes — lire les lignes d’avertissement npm avant de continuer. - L’état OpenClaw migré (pairages, session WhatsApp) survit presque intact à un changement d’OS ; la facture, c’est la chirurgie base/config ponctuelle.
- Les fichiers SQLite d’état se sauvegardent avant toute chirurgie manuelle de lignes — assurance pas chère, gardée
.bak-20260918.
Fichiers compagnons : OpenClaw Fedora Setup Report (EN) · OpenClaw Fedora - Setup (guide) · OpenClaw Fedora Setup_results (logs) Note projet : Projects/OpenClaw Setup.md