Agents ACP

​

Quelle page me faut-il ?

​

Cela fonctionne-t-il directement ?

openclaw plugins install @openclaw/acpx
openclaw config set plugins.entries.acpx.enabled true

​

Cibles de harnais prises en charge

​

Guide d’exploitation

​

ACP par rapport aux sous-agents

​

Fonctionnement d’ACP avec Claude Code

1. Plan de contrôle de session ACP OpenClaw.
2. Plugin de runtime officiel @openclaw/acpx.
3. Adaptateur ACP Claude.
4. Mécanismes de runtime/session côté Claude.

• Vous voulez /acp spawn, des sessions liables, des contrôles de runtime ou un travail de harnais persistant ? Utilisez ACP.
• Vous voulez un simple secours local en texte via la CLI brute ? Utilisez les backends CLI.

​

Sessions liées

​

Modèle mental

• Surface de chat - l’endroit où les personnes continuent à parler (canal Discord, sujet Telegram, chat iMessage).
• Session ACP - l’état durable du runtime Codex/Claude/Gemini vers lequel OpenClaw route.
• Fil/sujet enfant - une surface de messagerie supplémentaire optionnelle créée uniquement par --thread ....
• Espace de travail du runtime - l’emplacement du système de fichiers (cwd, checkout de dépôt, espace de travail backend) où le harnais s’exécute. Indépendant de la surface de chat.

​

Liaisons à la conversation actuelle

/codex bind                                              # liaison Codex native, route les futurs messages ici
/codex model gpt-5.4                                     # ajuste le fil Codex natif lié
/codex stop                                              # contrôle le tour Codex natif actif
/acp spawn codex --bind here                             # secours ACP explicite pour Codex
/acp spawn codex --thread auto                           # peut créer un fil/sujet enfant et s’y lier
/acp spawn codex --bind here --cwd /workspace/repo       # même liaison de chat, Codex s’exécute dans /workspace/repo

​

Liaisons de canal persistantes

​

Modèle de liaison

​

Valeurs par défaut du runtime par agent

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (id de harnais, par exemple codex ou claude)
• agents.list[].runtime.acp.backend
• agents.list[].runtime.acp.mode
• agents.list[].runtime.acp.cwd

1. bindings[].acp.*
2. agents.list[].runtime.acp.*
3. Valeurs par défaut ACP globales (par exemple acp.backend)

​

Exemple

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
      },
      {
        id: "claude",
        runtime: {
          type: "acp",
          acp: { agent: "claude", backend: "acpx", mode: "persistent" },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "discord",
        accountId: "default",
        peer: { kind: "channel", id: "222222222222222222" },
      },
      acp: { label: "codex-main" },
    },
    {
      type: "acp",
      agentId: "claude",
      match: {
        channel: "telegram",
        accountId: "default",
        peer: { kind: "group", id: "-1001234567890:topic:42" },
      },
      acp: { cwd: "/workspace/repo-b" },
    },
    {
      type: "route",
      agentId: "main",
      match: { channel: "discord", accountId: "default" },
    },
    {
      type: "route",
      agentId: "main",
      match: { channel: "telegram", accountId: "default" },
    },
  ],
  channels: {
    discord: {
      guilds: {
        "111111111111111111": {
          channels: {
            "222222222222222222": { requireMention: false },
          },
        },
      },
    },
    telegram: {
      groups: {
        "-1001234567890": {
          topics: { "42": { requireMention: false } },
        },
      },
    },
  },
}

​

Comportement

• OpenClaw s’assure que la session ACP configurée existe après l’admission propre au canal et avant son utilisation.
• Les messages dans ce canal, ce sujet ou cette discussion sont routés vers la session ACP configurée.
• Les liaisons ACP configurées possèdent leur route de session. La diffusion en éventail du canal ne remplace pas la session ACP configurée pour une liaison correspondante.
• Dans les conversations liées, /new et /reset réinitialisent sur place la même clé de session ACP.
• Les liaisons d’exécution temporaires (par exemple celles créées par des flux de focalisation sur un fil) continuent de s’appliquer lorsqu’elles sont présentes.
• Pour les créations ACP inter-agents sans cwd explicite, OpenClaw hérite l’espace de travail de l’agent cible depuis la configuration de l’agent.
• Les chemins d’espace de travail hérités manquants reviennent au cwd par défaut du backend ; les échecs d’accès non manquants apparaissent comme des erreurs de création.

​

Démarrer des sessions ACP

{
  "task": "Open the repo and summarize failing tests",
  "runtime": "acp",
  "agentId": "codex",
  "thread": true,
  "mode": "session"
}

/acp spawn codex --mode persistent --thread auto
/acp spawn codex --mode oneshot --thread off
/acp spawn codex --bind here
/acp spawn codex --thread here

​

Paramètres de sessions_spawn

​

Modes de liaison et de fil de création

​

Modèle de livraison

{
  "task": "Continue where we left off - fix the remaining test failures",
  "runtime": "acp",
  "agentId": "codex",
  "resumeSessionId": "<previous-session-id>"
}

​

Compatibilité avec le bac à sable

• Si la session demandeuse est placée en bac à sable, les créations ACP sont bloquées pour sessions_spawn({ runtime: "acp" }) comme pour /acp spawn.
• sessions_spawn avec runtime: "acp" ne prend pas en charge sandbox: "require".

​

Résolution de la cible de session

1. Argument de cible explicite (ou --session pour /acp steer)
   • essaie la clé
   • puis l’identifiant de session au format UUID
   • puis le libellé
2. Liaison du fil de discussion actuel (si cette conversation/ce fil est lié à une session ACP).
3. Repli sur la session demandeuse actuelle.

​

Contrôles ACP

​

Correspondance des options de runtime

​

Harness acpx, configuration du plugin et autorisations

​

Dépannage

​

Liens associés

• Agents ACP - configuration
• Envoi à l’agent
• Backends CLI
• Harnais Codex
• Runtime du harnais Codex
• Outils de sandbox multi-agent
• openclaw acp (mode pont)
• Sous-agents