агенты ACP

​

Какая страница мне нужна?

​

Это работает из коробки?

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

​

Поддерживаемые целевые среды выполнения

​

Runbook оператора

​

ACP и суб-агенты

​

Как ACP запускает Claude Code

1. Плоскость управления сессиями OpenClaw ACP.
2. Официальный Plugin среды выполнения @openclaw/acpx.
3. Адаптер Claude ACP.
4. Механизмы среды выполнения/сессии на стороне Claude.

• Нужны /acp spawn, привязываемые сессии, элементы управления средой выполнения или постоянная работа обвязки? Используйте ACP.
• Нужен простой локальный текстовый резерв через необработанный CLI? Используйте бэкенды CLI.

​

Привязанные сессии

​

Ментальная модель

• Поверхность чата - где люди продолжают общаться (канал Discord, тема Telegram, чат iMessage).
• Сессия ACP - долговременное состояние среды выполнения Codex/Claude/Gemini, в которое OpenClaw маршрутизирует сообщения.
• Дочерний тред/тема - опциональная дополнительная поверхность сообщений, создаваемая только через --thread ....
• Рабочая область среды выполнения - расположение в файловой системе (cwd, checkout репозитория, рабочая область бэкенда), где запускается обвязка. Не зависит от поверхности чата.

​

Привязки текущего разговора

/codex bind                                              # native Codex bind, route future messages here
/codex model gpt-5.4                                     # tune the bound native Codex thread
/codex stop                                              # control the active native Codex turn
/acp spawn codex --bind here                             # explicit ACP fallback for Codex
/acp spawn codex --thread auto                           # may create a child thread/topic and bind there
/acp spawn codex --bind here --cwd /workspace/repo       # same chat binding, Codex runs in /workspace/repo

​

Постоянные привязки каналов

​

Модель привязки

​

Стандартные значения среды выполнения для каждого агента

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (идентификатор обвязки, например codex или 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. Глобальные стандартные значения ACP (например, acp.backend)

​

Пример

{
  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 } },
        },
      },
    },
  },
}

​

Поведение

• OpenClaw гарантирует, что настроенная сессия ACP существует после допуска для конкретного канала и перед использованием.
• Сообщения в этом канале, теме или чате направляются в настроенную сессию ACP.
• Настроенные привязки ACP владеют своим маршрутом сессии. Широковещательная рассылка канала веером не заменяет настроенную сессию ACP для совпавшей привязки.
• В привязанных разговорах /new и /reset сбрасывают тот же ключ сессии ACP на месте.
• Временные привязки среды выполнения (например, созданные потоками фокусировки на треде) по-прежнему применяются там, где присутствуют.
• Для межагентных запусков ACP без явного cwd OpenClaw наследует рабочую область целевого агента из конфигурации агента.
• Отсутствующие унаследованные пути рабочей области откатываются к стандартному cwd backend; ошибки доступа для существующих путей выдаются как ошибки запуска.

​

Запуск сессий 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

​

Параметры sessions_spawn

​

Режимы привязки запуска и треда

​

Модель доставки

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

​

Совместимость с песочницей

• Если сессия запрашивающего находится в песочнице, запуск ACP блокируется как для sessions_spawn({ runtime: "acp" }), так и для /acp spawn.
• sessions_spawn с runtime: "acp" не поддерживает sandbox: "require".

​

Разрешение цели сессии

1. Явный аргумент цели (или --session для /acp steer)
   • пробует ключ
   • затем идентификатор сессии в форме UUID
   • затем label
2. Текущая привязка thread (если этот разговор/thread привязан к сессии ACP).
3. Резервная сессия текущего запрашивающего.

​

Элементы управления ACP

​

Сопоставление параметров среды выполнения

​

acpx harness, настройка Plugin и разрешения

​

Устранение неполадок

​

Связанное

• Агенты ACP — настройка
• Отправка агенту
• CLI Backends
• Harness Codex
• Среда выполнения harness Codex
• Инструменты sandbox для нескольких агентов
• openclaw acp (режим моста)
• Субагенты