Agenci ACP

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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 runtime @openclaw/acpx.
3. Adapter ACP Claude.
4. Mechanizmy runtime/sesji po stronie Claude.

• Chcesz /acp spawn, powiązywalne sesje, kontrolki runtime albo trwałą pracę uprzęży? Użyj ACP.
• Chcesz prostą lokalną tekstową ścieżkę awaryjną przez surowe CLI? Użyj backendów CLI.

​

Sesje powiązane

​

Model mentalny

• Powierzchnia czatu - miejsce, w którym ludzie kontynuują rozmowę (kanał Discord, temat Telegram, czat iMessage).
• Sesja ACP - trwały stan runtime Codex/Claude/Gemini, do którego OpenClaw kieruje komunikację.
• Wątek/temat podrzędny - opcjonalna dodatkowa powierzchnia komunikacji tworzona tylko przez --thread ....
• Obszar roboczy runtime - lokalizacja systemu plików (cwd, checkout repozytorium, obszar roboczy backendu), w której działa uprząż. 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 runtime dla agenta

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (identyfikator uprzęży, np. codex albo 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 przed użyciem.
• Wiadomości w tym kanale lub temacie są kierowane do skonfigurowanej sesji ACP.
• W powiązanych konwersacjach /new i /reset resetują ten sam klucz sesji ACP w miejscu.
• Tymczasowe powiązania środowiska uruchomieniowego (na przykład utworzone przez przepływy skupienia wątku) nadal mają zastosowanie tam, gdzie są obecne.
• W przypadku uruchomień ACP między agentami bez jawnego cwd, OpenClaw dziedziczy obszar roboczy agenta docelowego z konfiguracji agenta.
• Brakujące odziedziczone ścieżki obszaru roboczego 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 i wątku przy uruchamianiu

​

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, tworzenie ACP jest blokowane zarówno dla sessions_spawn({ runtime: "acp" }), jak i /acp spawn.
• sessions_spawn z runtime: "acp" nie obsługuje sandbox: "require".

​

Rozwiązywanie 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 rozmowa/wątek jest powiązana z sesją ACP).
3. Zapasowa bieżąca sesja żądająca.

​

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
• Backendy CLI
• Harness Codex
• Środowisko uruchomieniowe harnessu Codex
• Narzędzia sandboxu wieloagentowego
• openclaw acp (tryb mostu)
• Subagenci