Agenci ACP

​

Której strony potrzebuję?

​

Czy to działa od razu?

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

​

Obsługiwane cele harnessów

​

Runbook operatora

​

ACP kontra podagenci

​

Jak ACP uruchamia Claude Code

1. Płaszczyzna sterowania sesją ACP OpenClaw.
2. Oficjalny plugin środowiska uruchomieniowego @openclaw/acpx.
3. Adapter Claude ACP.
4. Mechanizmy środowiska uruchomieniowego/sesji po stronie Claude.

• Chcesz /acp spawn, wiązalne sesje, kontrolki środowiska uruchomieniowego lub trwałą pracę harnessa? Użyj ACP.
• Chcesz prostego lokalnego tekstowego trybu awaryjnego przez surowe CLI? Użyj backendów CLI.

​

Powiązane sesje

​

Model mentalny

• Powierzchnia czatu - miejsce, w którym ludzie kontynuują rozmowę (kanał Discord, temat Telegram, czat iMessage).
• Sesja ACP - trwały stan środowiska uruchomieniowego Codex/Claude/Gemini, do którego kieruje OpenClaw.
• Wątek/temat potomny - opcjonalna dodatkowa powierzchnia komunikacji tworzona tylko przez --thread ....
• Przestrzeń robocza środowiska uruchomieniowego - lokalizacja systemu plików (cwd, checkout repozytorium, przestrzeń robocza backendu), w której działa harness. Niezależna od powierzchni czatu.

​

Powiązania bieżącej konwersacji

/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

​

Trwałe powiązania kanałów

​

Model powiązań

​

Domyślne ustawienia środowiska uruchomieniowego dla każdego agenta

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (identyfikator harnessa, np. codex lub 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. Globalne domyślne ustawienia ACP (np. acp.backend)

​

Przykład

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

​

Zachowanie

• OpenClaw zapewnia, że skonfigurowana sesja ACP istnieje po dopuszczeniu specyficznym dla kanału i przed użyciem.
• Wiadomości w tym kanale, temacie lub czacie są kierowane do skonfigurowanej sesji ACP.
• Skonfigurowane powiązania ACP są właścicielami swojej trasy sesji. Rozsyłanie kanałowe typu fan-out nie zastępuje skonfigurowanej sesji ACP dla dopasowanego powiązania.
• W powiązanych konwersacjach /new i /reset resetują ten sam klucz sesji ACP w miejscu.
• Tymczasowe powiązania środowiska uruchomieniowego (na przykład tworzone przez przepływy skupienia wątku) nadal obowiązują tam, gdzie występują.
• W przypadku międzyagentowych uruchomień ACP bez jawnego cwd OpenClaw dziedziczy przestrzeń roboczą agenta docelowego z konfiguracji agenta.
• Brakujące dziedziczone ścieżki przestrzeni roboczej wracają do domyślnego cwd backendu; niebrakujące błędy dostępu są zgłaszane jako błędy uruchomienia.

​

Uruchamianie sesji 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

​

Parametry sessions_spawn

​

Tryby powiązania uruchomienia i wątku

​

Model dostarczania

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

​

Zgodność z piaskownicą

• Jeśli sesja żądająca działa w piaskownicy, uruchomienia ACP są blokowane zarówno dla sessions_spawn({ runtime: "acp" }), jak i /acp spawn.
• sessions_spawn z runtime: "acp" nie obsługuje sandbox: "require".

​

Rozpoznawanie celu sesji

1. Jawny argument celu (lub --session dla /acp steer)
   • próbuje klucza
   • następnie identyfikatora sesji w kształcie UUID
   • następnie etykiety
2. Bieżące powiązanie wątku (jeśli ta konwersacja/wątek jest powiązany z sesją ACP).
3. Zapasowe użycie bieżącej sesji żądającego.

​

Kontrolki ACP

​

Mapowanie opcji środowiska uruchomieniowego

​

harness acpx, konfiguracja Plugin i uprawnienia

​

Rozwiązywanie problemów

​

Powiązane

• Agenci ACP - konfiguracja
• Wysyłanie do agenta
• Zaplecza CLI
• Mechanizm uruchomieniowy Codex
• Środowisko wykonawcze mechanizmu uruchomieniowego Codex
• Narzędzia piaskownicy wieloagentowej
• openclaw acp (tryb mostu)
• Subagenci