docs/docs/fr/cli/agents.md

read_when	summary	title	x-i18n
Vous voulez plusieurs agents isolés (espaces de travail + routage + authentification)	Référence CLI pour `openclaw agents` (list/add/delete/bindings/bind/unbind/set identity)	Agents	generated_at model provider source_hash source_path workflow 2026-04-24T07:03:13Z gpt-5.4 openai 04d0ce4f3fb3d0c0ba8ffb3676674cda7d9a60441a012bc94ff24a17105632f1 cli/agents.md 15

openclaw agents

Gérer des agents isolés (espaces de travail + authentification + routage).

Associé :

• Routage multi-agent : Routage multi-agent
• Espace de travail d’agent : Espace de travail d’agent
• Configuration de visibilité des Skills : Configuration des Skills

Exemples

openclaw agents list
openclaw agents list --bindings
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive
openclaw agents bindings
openclaw agents bind --agent work --bind telegram:ops
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
openclaw agents delete work

Liaisons de routage

Utilisez des liaisons de routage pour épingler le trafic entrant d’un canal à un agent spécifique.

Si vous souhaitez aussi différentes Skills visibles par agent, configurez agents.defaults.skills et agents.list[].skills dans openclaw.json. Voir Configuration des Skills et Référence de configuration.

Lister les liaisons :

openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json

Ajouter des liaisons :

openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

Si vous omettez accountId (--bind <channel>), OpenClaw le résout à partir des valeurs par défaut du canal et des hooks de configuration de Plugin lorsqu’ils sont disponibles.

Si vous omettez --agent pour bind ou unbind, OpenClaw cible l’agent par défaut actuel.

Comportement du périmètre de liaison

• Une liaison sans accountId correspond uniquement au compte par défaut du canal.
• accountId: "*" est le repli à l’échelle du canal (tous les comptes) et est moins spécifique qu’une liaison explicite de compte.
• Si le même agent possède déjà une liaison de canal correspondante sans accountId, et que vous effectuez ensuite une liaison avec un accountId explicite ou résolu, OpenClaw met à niveau cette liaison existante sur place au lieu d’ajouter un doublon.

Exemple :

# liaison initiale canal uniquement
openclaw agents bind --agent work --bind telegram

# mise à niveau ultérieure vers une liaison limitée à un compte
openclaw agents bind --agent work --bind telegram:ops

Après la mise à niveau, le routage pour cette liaison est limité à telegram:ops. Si vous voulez aussi le routage du compte par défaut, ajoutez-le explicitement (par exemple --bind telegram:default).

Supprimer des liaisons :

openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all

unbind accepte soit --all, soit une ou plusieurs valeurs --bind, mais pas les deux.

Surface de commande

agents

L’exécution de openclaw agents sans sous-commande équivaut à openclaw agents list.

agents list

Options :

• --json
• --bindings : inclure les règles de routage complètes, pas seulement les comptes/résumés par agent

agents add [name]

Options :

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (répétable)
• --non-interactive
• --json

Remarques :

• Le passage de tout indicateur explicite d’ajout fait basculer la commande vers le chemin non interactif.
• Le mode non interactif nécessite à la fois un nom d’agent et --workspace.
• main est réservé et ne peut pas être utilisé comme nouvel ID d’agent.

agents bindings

Options :

• --agent <id>
• --json

agents bind

Options :

• --agent <id> (par défaut : l’agent par défaut actuel)
• --bind <channel[:accountId]> (répétable)
• --json

agents unbind

Options :

• --agent <id> (par défaut : l’agent par défaut actuel)
• --bind <channel[:accountId]> (répétable)
• --all
• --json

agents delete <id>

Options :

• --force
• --json

Remarques :

• main ne peut pas être supprimé.
• Sans --force, une confirmation interactive est requise.
• L’espace de travail, l’état de l’agent et les répertoires de transcriptions de session sont déplacés vers la corbeille, et non supprimés définitivement.

Fichiers d’identité

Chaque espace de travail d’agent peut inclure un IDENTITY.md à la racine de l’espace de travail :

• Exemple de chemin : ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity lit depuis la racine de l’espace de travail (ou un --identity-file explicite)

Les chemins d’avatar sont résolus par rapport à la racine de l’espace de travail.

Définir l’identité

set-identity écrit les champs dans agents.list[].identity :

• name
• theme
• emoji
• avatar (chemin relatif à l’espace de travail, URL http(s) ou URI de données)

Options :

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

Remarques :

• --agent ou --workspace peuvent être utilisés pour sélectionner l’agent cible.
• Si vous vous appuyez sur --workspace et que plusieurs agents partagent cet espace de travail, la commande échoue et vous demande de passer --agent.
• Lorsqu’aucun champ d’identité explicite n’est fourni, la commande lit les données d’identité depuis IDENTITY.md.

Charger depuis IDENTITY.md :

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

Remplacer explicitement les champs :

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png

Exemple de configuration :

{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "OpenClaw",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/openclaw.png",
        },
      },
    ],
  },
}

Associé

• Référence CLI
• Routage multi-agent
• Espace de travail d’agent