Pas besoin de fichier de config : configurez OpenClaw entièrement depuis l'interface web

4 min read

Trop de tutoriels vous font éditer du JSON dès le premier jour, puis s'étonnent que les débutants fuient. Cet article montre la bonne nouvelle : il existe une interface sur laquelle cliquer.

Ce que vous allez apprendre

  • Ouvrir l'interface web et terminer l'authentification
  • Comprendre le mode formulaire vs le mode Raw JSON
  • Configurer le routage multi-espaces depuis l'interface
  • Savoir où se trouvent les principales fonctionnalités

Ouvrir l'interface web

Étape 1 : vérifier que la Gateway tourne

openclaw gateway

Étape 2 : ouvrir le navigateur

http://127.0.0.1:18789/

Si vous avez configuré un basePath, par ex. /openclaw :

http://127.0.0.1:18789/openclaw

Étape 3 : gérer l'authentification

Ce que vous voyez Solution
pairing required Exécutez openclaw devices list, puis openclaw devices approve <requestId>
Demande de token Collez le token de la configuration initiale

💡 Vous pouvez changer la langue de l'interface dans la section Access.


Deux façons d'éditer la config : formulaire vs Raw JSON

Allez sur la page Config et vous verrez deux modes d'édition :

Mode formulaire : champs structurés visuellement, idéal pour les débutants ou les petites modifications.

Mode Raw JSON : édition directe de la config, pour les utilisateurs avancés ou les grosses modifications.

Les deux modes éditent le même fichier : ~/.openclaw/openclaw.json.


Configuration la plus courante : groupes Telegram différents, assistants différents

Scénario A : Même bot, groupes différents, espaces de travail différents

Passez en Raw JSON et ajoutez cette structure :

{
  "agents": {
    "list": [
      { "id": "main",      "name": "Principal",      "workspace": "~/.openclaw/workspace-main",      "default": true },
      { "id": "project-a", "name": "Projet A", "workspace": "~/.openclaw/workspace-project-a" },
      { "id": "project-b", "name": "Projet B", "workspace": "~/.openclaw/workspace-project-b" }
    ]
  },
  "bindings": [
    { "agentId": "project-a", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1001234567890" } } },
    { "agentId": "project-b", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1009876543210" } } },
    { "agentId": "main",      "match": { "channel": "telegram" } }
  ],
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "votre token de bot",
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

Comment trouver l'ID du groupe ?

  • Méthode 1 : envoyez un message dans le groupe et exécutez openclaw logs --follow, puis regardez chat.id
  • Méthode 2 : transférez un message à @userinfobot

Scénario B : Comptes bot différents, espaces de travail différents

{
  "agents": {
    "list": [
      { "id": "main",   "workspace": "~/.openclaw/workspace-main" },
      { "id": "alerts", "workspace": "~/.openclaw/workspace-alerts" }
    ]
  },
  "bindings": [
    { "agentId": "main",   "match": { "channel": "telegram", "accountId": "default" } },
    { "agentId": "alerts", "match": { "channel": "telegram", "accountId": "alerts" } }
  ],
  "channels": {
    "telegram": {
      "accounts": {
        "default": { "botToken": "123456:ABC...", "dmPolicy": "pairing" },
        "alerts":  { "botToken": "987654:XYZ...", "dmPolicy": "allowlist", "allowFrom": ["tg:123456789"] }
      }
    }
  }
}

N'oubliez pas d'enregistrer

Cliquez sur Save / Apply. OpenClaw va :

  1. Valider la config
  2. L'appliquer, en général avec rechargement à chaud

⚠️ En cas de conflit baseHash, la config a été modifiée ailleurs. Rechargez la config et réessayez.


Que peut faire d'autre l'interface web ?

Section Rôle
Chat Discuter directement avec l'assistant dans le navigateur
Sessions Consulter et gérer les sessions
Cron Ajouter, modifier ou exécuter des jobs planifiés
Skills Activer, désactiver et installer des skills
Channels Voir le statut des canaux
Debug / Logs Voir les logs et exécuter des actions RPC manuelles

Aide-mémoire

Je veux... Où regarder dans l'interface web
Router différents groupes Telegram vers différents espaces Config → Raw JSON → agents + bindings
Router différents comptes bot vers différents espaces Config → channels.telegram.accounts + bindings
Changer le token du bot Config → channels.telegram.botToken
Gérer les planifications Onglet Cron
Voir les logs en direct Onglet Debug / Logs

L'idée à retenir : le routage par espace de travail est toujours décidé par agents et bindings. L'interface web ne fait que vous donner une façon plus conviviale de les éditer.


Lectures complémentaires