Installation Openclaw

Installation Openclaw

Ce tutoriel a été généré automatiquement depuis un PDF importé. Relisez les blocs, vérifiez les captures/images nécessaires et ajustez les consignes avant publication.

Codex

Tuto pour refaire une installation quasi identique à celle-ci, en local, avec

Gateway systemd, Control UI et modèle openai-codex/gpt-5.5 .

Linux / Debian-like Node 24 OpenClaw 2026.4.29+ OpenAI Codex OAuth

Généré le 09/05/2026. Les secrets et jetons locaux ne sont pas inclus volontairement.

1. Résultat visé

À la fin, tu dois avoir une installation très proche de la machine actuelle :

Node.js Node 24 recommandé

Gateway Mode local, accessible sur http://127.0.0.1:18789

Service Gateway installé en service utilisateur systemd, activé et lancé

Modèle par défaut openai-codex/gpt-5.5

Auth modèle OpenAI Codex via OAuth / abonnement, pas une clé API OpenAI classique

Dashboard Control UI local : http://127.0.0.1:18789/

Important : dans cette installation, “OpenAI Codex” correspond au provider openai-codex/*

avec OAuth. Ce n’est pas la même chose que le runtime natif Codex agentRuntime.id:

"codex" . Pour copier cette machine, on garde openai-codex/gpt-5.5 .

2. Pré-requis

Un compte utilisateur Linux normal, avec accès sudo si l’installateur doit poser Node ou Git.

Connexion Internet.

Un compte OpenAI/ChatGPT avec accès Codex, car l’auth se fera en OAuth.

Un terminal interactif pour ouvrir le lien OAuth pendant l’onboarding.

file:///home/pcd/.openclaw/workspace/openclaw_install_tuto.html 1/6

node --version || true

npm --version || true

OpenClaw recommande Node 24. Node 22.14+ reste supporté, mais pour reproduire cette machine

vise Node 24.

3. Installer OpenClaw

La méthode recommandée pour Linux/macOS/WSL2 :

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

Ce script détecte l’OS, installe Node si nécessaire, installe OpenClaw et peut lancer l’onboarding.

Alternative npm si Node 24 est déjà prêt

npm install -g openclaw@latest

Si openclaw n’est pas trouvé

npm prefix -g

echo "$PATH"

# Ajouter le bin global npm au shell si besoin :

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc

4. Lancer l’onboarding local avec service

Pour obtenir une Gateway locale installée comme service :

openclaw onboard --install-daemon

Choix recommandés dans l’assistant :

• Mode : local.
• Gateway auth : token généré automatiquement ou token manuel.
• Provider / auth modèle : choisir OpenAI Code / Codex subscription ou équivalent OpenAI

Codex OAuth.

• Se connecter au compte OpenAI quand le navigateur ou le lien OAuth le demande.
• Modèle par défaut : choisir openai-codex/gpt-5.5 si proposé.
• Workspace : ~/.openclaw/workspace .

file:///home/pcd/.openclaw/workspace/openclaw_install_tuto.html 2/6

Ne copie pas le token de cette machine. Chaque installation doit générer son propre

gateway.auth.token . Le tuto donne la forme de la config, pas les secrets.

5. Config minimale équivalente

Après onboarding, le fichier principal est :

La forme attendue, sans secrets, ressemble à ceci :

{

"gateway": {

"mode": "local",

"auth": {

"mode": "token",

"token": "<token généré localement>"

}

},

"agents": {

"defaults": {

"workspace": "/home/<user>/.openclaw/workspace",

"models": {

"openai-codex/gpt-5.5": {}

},

"model": {

"primary": "openai-codex/gpt-5.5"

}

}

},

"auth": {

"profiles": {

"openai-codex:<email>": {

"provider": "openai-codex",

"mode": "oauth",

"email": "<email>"

}

}

},

"plugins": {

"entries": {

"openai": { "enabled": true }

}

}

}

openclaw models status

file:///home/pcd/.openclaw/workspace/openclaw_install_tuto.html 3/6

openclaw doctor --non-interactive

Tu veux voir quelque chose comme :

Gateway : local , reachable, service systemd running.

Dashboard : http://127.0.0.1:18789/ .

Default model : openai-codex/gpt-5.5 .

Auth : provider openai-codex en OAuth OK.

openclaw dashboard

Sinon ouvre directement : http://127.0.0.1:18789/ .

7. Installer / gérer le service Gateway

Si l’onboarding n’a pas installé le service, tu peux le faire ensuite :

openclaw gateway status

Sur Linux, OpenClaw utilise normalement un service systemd utilisateur.

Chemin Rôle

~/.openclaw/openclaw.json Configuration principale Gateway/agents/modèles.

~/.openclaw/workspace Workspace de l’agent : AGENTS.md, SOUL.md,

USER.md, TOOLS.md, mémoire, etc.

~/.openclaw/agents/main/ État de l’agent main, sessions, profils d’auth,

mémoire runtime.

~/.openclaw/agents/main/agent/auth- Profils d’auth effectifs, dont OAuth Codex.

profiles.json

file:///home/pcd/.openclaw/workspace/openclaw_install_tuto.html 4/6

9. Points à personnaliser après installation

Identité/persona : modifier ~/.openclaw/workspace/IDENTITY.md , SOUL.md , USER.md .

Heartbeat : la machine actuelle a un heartbeat main de 30 min. Laisser HEARTBEAT.md vide si tu

ne veux pas d’actions périodiques.

Canaux externes : Telegram/Signal/WhatsApp/Discord se configurent ensuite, pas obligatoire

pour le webchat local.

Owner commands : si tu ajoutes un canal externe, configure commands.ownerAllowFrom pour

autoriser les commandes privilégiées uniquement à ton compte.

openclaw update

Après une mise à jour :

Symptôme Action

openclaw: command not Vérifier npm prefix -g et ajouter le dossier bin au PATH .

found

Dashboard inaccessible openclaw gateway status , puis openclaw gateway restart .

Modèle non autorisé Vérifier l’allowlist agents.defaults.models et ajouter openai-

codex/gpt-5.5 .

OAuth expiré ou KO Relancer openclaw onboard ou la configuration modèle/auth OpenAI

Codex.

Config cassée openclaw doctor . OpenClaw garde aussi une copie last-known-good

quand possible.

file:///home/pcd/.openclaw/workspace/openclaw_install_tuto.html 5/6

# Installation rapide
curl -fsSL https://openclaw.ai/install.sh | bash# Onboarding local + service

openclaw onboard --install-daemon

# Vérifications

openclaw doctor --non-interactive

# Dashboard

openclaw dashboard

# Modèle Codex comme ici

openclaw models set openai-codex/gpt-5.5

# Redémarrage Gateway

openclaw gateway restart

Checklist finale : si openclaw status affiche Gateway reachable, service running, dashboard

local, et openclaw models status affiche Default: openai-codex/gpt-5.5 avec OAuth OK,

ton installation est quasi identique à celle-ci.

file:///home/pcd/.openclaw/workspace/openclaw_install_tuto.html 6/6

• Relire chaque bloc généré.
• Ajouter ou vérifier les captures d’écran importantes.
• Tester les étapes sur une machine adaptée.
• Vérifier les liens externes et la source officielle.