OpenClaw Fedora


type: rapport projet: OpenClaw date: 2026-09-18 statut: en_cours tags:

  • ia
  • agent
  • setup
  • fedora

Rapport OpenClaw Fedora Setup

ProjetOpenClaw 2026.9.4 — assistant IA personnel (gateway + dashboard + messagerie WhatsApp)
Date2026-09-18
Statut✅ Gateway installé et lancé (127.0.0.1:18789) — couche modèle (Ollama) en attente
ContexteMigration 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 sudo ni pas de systemctl (la supervision des services vit sur l’hôte)
    • ✅ node v24.20.0 + npm 11.19.0 dans ~/.local/opt/node (install utilisateur, sur le PATH via .bashrc), réseau OK
  • É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@latest car 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)

  1. Vérification des prérequis : node --version → v24.20.0, npm --version → 11.19.0, ports 18789/11434 libres, binaire openclaw absent.
  2. Installation globale :
    npm install -g openclaw        # → openclaw@2026.9.4, 330 paquets, ~3 min
  3. ⚠️ npm 11.19.0 a bloqué les scripts d’installation (garde allow-scripts). Mon ~/.npmrc global contient allow-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
  4. ✅ 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/workspace présent avec contenu
  • ✅ Canal WhatsApp intact (enabled: true, groupe 120363425343912084@g.us avec politiques d’outils par expéditeur)
  • ✅ credentials/whatsapp/ + whatsapp-pairing.json migré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 systemctl est indisponible, la lecture du service lève une erreur → verdict unavailable → maintenance bloquée.
  • Traces Windows obsolètes trouvées dans la base : ligne current de gateway_restart_handoff (PID 11672, supervisor_mode=schtasks, expirée le 21 août) + un gateway_restart_intent périmé. gateway stop --force / gateway stop ne les effacent pas.

Correctifs appliqués (dans l’ordre) :

  1. Suppression des deux clés que le nouveau CLI rejetait (cf. Phase 5).
  2. Sauvegarde de la base (openclaw.sqlite.bak-20260918) puis suppression des lignes handoff/intent périmées. (Diagnostic — ne débloque pas seul.)
  3. ✅ Correctif décisif — l’échappatoire documentée dans doctor-service-repair-policy-*.mjs :
    OPENCLAW_SERVICE_REPAIR_POLICY=external openclaw doctor --fix
    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 (devices/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 reconnue
  • gateway.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-gateway vivant
  • ✅ 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), agent main actif, sessions 4, plugin memory-core activé
  • Logs : /tmp/openclaw/openclaw-2026-09-18.log + ~/.openclaw/logs/gateway-fedora.log

3. Erreurs & correctifs

#❌ Erreur / blocage✅ CorrectifNote
1npm 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 openclawVérifier le .npmrc global avant de faire confiance à une install « réussie »
2Migration de schéma requise (audit-events-v2)OPENCLAW_SERVICE_REPAIR_POLICY=external openclaw doctor --fixBase migrée en dernier par le build Windows 2026.7.1-2
3Doctor : « 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 sauvegardeConteneur + inspection systemd-user ne font pas bon ménage
4Config rejetée : meta.lastTouchedAt, gateway.tailscale.resetOnExitClé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

  1. 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).
  2. 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=external est le contournement officiel : le doctor traite le service comme géré en externe et ne répare que l’état.
  3. npm 11.19.0 est hostile aux scripts par défaut dans cet environnement : l’allowlist allow-scripts du ~/.npmrc global 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.
  4. 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émentStatutPriorité
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ôtemoyenne
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 installmoyenne

6. Tableau credentials / config

ÉlémentValeurNote
Dashboardhttp://127.0.0.1:18789/loopback uniquement
Token d’auth gateway215e4b2ea0d30c61ad476a8d04f89a66a2e6bf4d149db540⚠️ token local ; à faire pivoter si exposé hors loopback
Bind gatewayloopback, port 18789gateway.bind, gateway.port
Modèle principalollama/qwen2.5:3bdéfini le 2026-09-18 pour coller au défaut Windows documenté (note projet 23-08) ; ancienne valeur gemma4:26b
Liste des modèlesollama/qwen2.5:3b, ollama/gemma4:26bles deux nécessitent un serveur Ollama
Provider WhatsApp+221789229104session migrée depuis Windows
Groupe WhatsApp120363425343912084@g.uspolitiques 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

  1. Toujours CLI ↔ config ↔ base à la même version. Chaque mélange de versions crée une incompatibilité neuve à chaque frontière.
  2. OPENCLAW_SERVICE_REPAIR_POLICY=external est le sésame du doctor en sandbox.
  3. Le allow-scripts de npm 11.19.0 rend les installs globales silencieusement incomplètes — lire les lignes d’avertissement npm avant de continuer.
  4. L’état OpenClaw migré (pairages, session WhatsApp) survit presque intact à un changement d’OS ; la facture, c’est la chirurgie base/config ponctuelle.
  5. 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