​

ACP-Agents

​

Welche Seite brauche ich?

​

Funktioniert das sofort?

• Neue Installationen werden jetzt standardmäßig mit aktiviertem gebündeltem Runtime-Plugin acpx ausgeliefert.
• Das gebündelte Plugin acpx bevorzugt seine pluginlokal fixierte acpx-Binärdatei.
• Beim Start prüft OpenClaw diese Binärdatei und repariert sie bei Bedarf selbst.
• Beginnen Sie mit /acp doctor, wenn Sie eine schnelle Bereitschaftsprüfung möchten.

• Ein Ziel-Harness-Adapter kann bei der ersten Nutzung dieses Harnesses bei Bedarf mit npx abgerufen werden.
• Die Hersteller-Authentifizierung muss auf dem Host weiterhin für dieses Harness vorhanden sein.
• Wenn der Host keinen npm-/Netzwerkzugriff hat, können Adapterabrufe beim ersten Start fehlschlagen, bis Caches vorgewärmt sind oder der Adapter auf andere Weise installiert wurde.

• /acp spawn codex: OpenClaw sollte bereit sein, acpx zu bootstrappen, aber der Codex-ACP-Adapter benötigt möglicherweise weiterhin einen ersten Abruf.
• /acp spawn claude: dasselbe gilt für den Claude-ACP-Adapter sowie für die Claude-seitige Authentifizierung auf diesem Host.

​

Schneller Operator-Ablauf

1. Eine Sitzung starten:
   • /acp spawn codex --bind here
   • /acp spawn codex --mode persistent --thread auto
2. In der gebundenen Konversation oder im Thread arbeiten (oder diesen Sitzungsschlüssel explizit angeben).
3. Runtime-Status prüfen:
   • /acp status
4. Runtime-Optionen nach Bedarf anpassen:
   • /acp model <provider/model>
   • /acp permissions <profile>
   • /acp timeout <seconds>
5. Einer aktiven Sitzung einen Hinweis geben, ohne den Kontext zu ersetzen:
   • /acp steer Logging verschärfen und fortfahren
6. Arbeit beenden:
   • /acp cancel (aktuellen Turn stoppen), oder
   • /acp close (Sitzung schließen + Bindungen entfernen)

​

Schnellstart für Menschen

• „Binde diesen Discord-Channel an Codex.“
• „Starte hier eine persistente Codex-Sitzung in einem Thread und halte sie fokussiert.“
• „Führe das als einmalige Claude-Code-ACP-Sitzung aus und fasse das Ergebnis zusammen.“
• „Binde diesen iMessage-Chat an Codex und behalte Folgeanfragen im selben Workspace.“
• „Verwende Gemini CLI für diese Aufgabe in einem Thread und behalte Folgeanfragen dann in demselben Thread.“

1. runtime: "acp" wählen.
2. Das angeforderte Harness-Ziel auflösen (agentId, zum Beispiel codex).
3. Wenn eine Bindung an die aktuelle Konversation angefordert wurde und der aktive Channel dies unterstützt, die ACP-Sitzung an diese Konversation binden.
4. Andernfalls, wenn eine Thread-Bindung angefordert wurde und der aktuelle Channel dies unterstützt, die ACP-Sitzung an den Thread binden.
5. Gebundene Folge-Nachrichten an dieselbe ACP-Sitzung weiterleiten, bis sie entfokussiert/geschlossen/abgelaufen ist.

​

ACP im Vergleich zu Sub-Agents

​

So führt ACP Claude Code aus

1. OpenClaw-ACP-Sitzungs-Control-Plane
2. gebündeltes Runtime-Plugin acpx
3. Claude-ACP-Adapter
4. Claude-seitige Runtime-/Sitzungsmechanik

• ACP-Claude ist nicht dasselbe wie die direkte Fallback-Runtime claude-cli/....
• ACP-Claude ist eine Harness-Sitzung mit ACP-Steuerung, Sitzungswiederaufnahme, Hintergrundaufgaben-Verfolgung und optionaler Konversations-/Thread-Bindung.
• claude-cli/... ist ein reines lokales CLI-Backend für Text. Siehe CLI Backends.

• Sie möchten /acp spawn, bindbare Sitzungen, Runtime-Steuerung oder persistente Harness-Arbeit: Verwenden Sie ACP
• Sie möchten ein einfaches lokales Text-Fallback über die rohe CLI: Verwenden Sie CLI-Backends

​

Gebundene Sitzungen

​

Bindungen an die aktuelle Konversation

• OpenClaw behält die Kontrolle über Channel-Transport, Authentifizierung, Sicherheit und Zustellung.
• Die aktuelle Konversation wird an den gestarteten ACP-Sitzungsschlüssel angeheftet.
• Folge-Nachrichten in dieser Konversation werden an dieselbe ACP-Sitzung weitergeleitet.
• /new und /reset setzen dieselbe gebundene ACP-Sitzung direkt zurück.
• /acp close schließt die Sitzung und entfernt die Bindung der aktuellen Konversation.

• --bind here behält dieselbe Chat-Oberfläche. Auf Discord bleibt der aktuelle Channel der aktuelle Channel.
• --bind here kann trotzdem eine neue ACP-Sitzung erstellen, wenn Sie neue Arbeit starten. Die Bindung hängt diese Sitzung an die aktuelle Konversation.
• --bind here erstellt nicht automatisch einen untergeordneten Discord-Thread oder ein Telegram-Thema.
• Die ACP-Runtime kann weiterhin ihr eigenes Arbeitsverzeichnis (cwd) oder einen vom Backend verwalteten Workspace auf der Platte haben. Dieser Runtime-Workspace ist von der Chat-Oberfläche getrennt und impliziert keinen neuen Messaging-Thread.
• Wenn Sie an einen anderen ACP-Agenten starten und --cwd nicht angeben, übernimmt OpenClaw standardmäßig den Workspace des Ziel-Agents, nicht den des Anfragenden.
• Wenn dieser übernommene Workspace-Pfad fehlt (ENOENT/ENOTDIR), fällt OpenClaw auf das Standard-cwd des Backends zurück, statt stillschweigend den falschen Baum wiederzuverwenden.
• Wenn der übernommene Workspace existiert, aber nicht zugänglich ist (zum Beispiel EACCES), gibt spawn den tatsächlichen Zugriffsfehler zurück, statt cwd wegzulassen.

• Chat-Oberfläche: der Ort, an dem Menschen weiter sprechen (Discord-Channel, Telegram-Thema, iMessage-Chat)
• ACP-Sitzung: der dauerhafte Runtime-Status von Codex/Claude/Gemini, an den OpenClaw weiterleitet
• untergeordneter Thread/Thema: eine optionale zusätzliche Messaging-Oberfläche, die nur durch --thread ... erstellt wird
• Runtime-Workspace: der Dateisystemort, an dem das Harness ausgeführt wird (cwd, Repo-Checkout, Backend-Workspace)

• /acp spawn codex --bind here: diesen Chat beibehalten, eine Codex-ACP-Sitzung starten oder anhängen und zukünftige Nachrichten hierhin an sie weiterleiten
• /acp spawn codex --thread auto: OpenClaw kann einen untergeordneten Thread/ein Thema erstellen und die ACP-Sitzung daran binden
• /acp spawn codex --bind here --cwd /workspace/repo: dieselbe Chat-Bindung wie oben, aber Codex läuft in /workspace/repo

• Chat-/Message-Channels, die Unterstützung für die Bindung der aktuellen Konversation ankündigen, können --bind here über den gemeinsamen Pfad für Konversationsbindungen verwenden.
• Channels mit benutzerdefinierter Thread-/Themen-Semantik können weiterhin channel-spezifische Kanonisierung hinter derselben gemeinsamen Schnittstelle bereitstellen.
• --bind here bedeutet immer „die aktuelle Konversation direkt binden“.
• Allgemeine Bindungen der aktuellen Konversation verwenden den gemeinsamen OpenClaw-Binding-Store und überstehen normale Gateway-Neustarts.

• --bind here und --thread ... schließen sich bei /acp spawn gegenseitig aus.
• Auf Discord bindet --bind here den aktuellen Channel oder Thread direkt. spawnAcpSessions ist nur erforderlich, wenn OpenClaw für --thread auto|here einen untergeordneten Thread erstellen muss.
• Wenn der aktive Channel keine ACP-Bindungen für die aktuelle Konversation bereitstellt, gibt OpenClaw eine klare Meldung zurück, dass dies nicht unterstützt wird.
• resume und Fragen zu „neuer Sitzung“ sind ACP-Sitzungsfragen, keine Channel-Fragen. Sie können Runtime-Status wiederverwenden oder ersetzen, ohne die aktuelle Chat-Oberfläche zu ändern.

​

Thread-gebundene Sitzungen

• OpenClaw bindet einen Thread an eine Ziel-ACP-Sitzung.
• Folge-Nachrichten in diesem Thread werden an die gebundene ACP-Sitzung weitergeleitet.
• ACP-Ausgaben werden an denselben Thread zurückgeliefert.
• Entfokussieren/Schließen/Archivieren/Ablauf durch Idle-Timeout oder max-age entfernt die Bindung.

• acp.enabled=true
• acp.dispatch.enabled ist standardmäßig aktiviert (auf false setzen, um ACP-Dispatch anzuhalten)
• ACP-Thread-Spawn-Flag des Channel-Adapters aktiviert (adapterspezifisch)
  • Discord: channels.discord.threadBindings.spawnAcpSessions=true
  • Telegram: channels.telegram.threadBindings.spawnAcpSessions=true

​

Channels mit Thread-Unterstützung

• Jeder Channel-Adapter, der Sitzungs-/Thread-Binding-Fähigkeiten bereitstellt.
• Aktuell integrierte Unterstützung:
  • Discord-Threads/-Channels
  • Telegram-Themen (Forenthemen in Gruppen/Supergroups und DM-Themen)
• Plugin-Channels können über dieselbe Binding-Schnittstelle Unterstützung hinzufügen.

​

Channelspezifische Einstellungen

​

Binding-Modell

• bindings[].type="acp" kennzeichnet eine persistente ACP-Konversationsbindung.
• bindings[].match identifiziert die Ziel-Konversation:
  • Discord-Channel oder -Thread: match.channel="discord" + match.peer.id="<channelOrThreadId>"
  • Telegram-Forenthema: match.channel="telegram" + match.peer.id="<chatId>:topic:<topicId>"
  • BlueBubbles-DM/Gruppenchat: match.channel="bluebubbles" + match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>"
    Bevorzugen Sie chat_id:* oder chat_identifier:* für stabile Gruppenbindungen.
  • iMessage-DM/Gruppenchat: match.channel="imessage" + match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>"
    Bevorzugen Sie chat_id:* für stabile Gruppenbindungen.
• bindings[].agentId ist die besitzende OpenClaw-Agent-ID.
• Optionale ACP-Überschreibungen befinden sich unter bindings[].acp:
  • mode (persistent oder oneshot)
  • label
  • cwd
  • backend

​

Runtime-Standards pro Agent

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (Harness-ID, zum Beispiel codex oder 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. globale ACP-Standards (zum Beispiel 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 stellt vor der Verwendung sicher, dass die konfigurierte ACP-Sitzung existiert.
• Nachrichten in diesem Channel oder Thema werden an die konfigurierte ACP-Sitzung weitergeleitet.
• In gebundenen Konversationen setzen /new und /reset denselben ACP-Sitzungsschlüssel direkt zurück.
• Temporäre Runtime-Bindings (zum Beispiel durch Thread-Focus-Flows erstellt) gelten weiterhin, sofern vorhanden.
• Für kanalübergreifende ACP-Starts ohne explizites cwd übernimmt OpenClaw den Workspace des Ziel-Agents aus der Agent-Konfiguration.
• Fehlende übernommene Workspace-Pfade fallen auf das Standard-cwd des Backends zurück; tatsächliche Zugriffsfehler werden als Spawn-Fehler ausgegeben.

​

ACP-Sitzungen starten (Schnittstellen)

​

Über sessions_spawn

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

• runtime ist standardmäßig subagent; setzen Sie also für ACP-Sitzungen explizit runtime: "acp".
• Wenn agentId weggelassen wird, verwendet OpenClaw acp.defaultAgent, sofern konfiguriert.
• mode: "session" erfordert thread: true, damit eine persistente gebundene Konversation erhalten bleibt.

• task (erforderlich): initialer Prompt, der an die ACP-Sitzung gesendet wird.
• runtime (für ACP erforderlich): muss "acp" sein.
• agentId (optional): ACP-Ziel-Harness-ID. Fällt auf acp.defaultAgent zurück, falls gesetzt.
• thread (optional, Standard false): fordert, wo unterstützt, einen Thread-Binding-Flow an.
• mode (optional): run (einmalig) oder session (persistent).
  • Standard ist run
  • wenn thread: true und mode ausgelassen wird, kann OpenClaw je nach Runtime-Pfad standardmäßig persistentes Verhalten wählen
  • mode: "session" erfordert thread: true
• cwd (optional): angefordertes Arbeitsverzeichnis der Runtime (validiert durch Backend-/Runtime-Richtlinie). Wenn ausgelassen, übernimmt ACP-Spawn den Workspace des Ziel-Agents, sofern konfiguriert; fehlende übernommene Pfade fallen auf Backend-Standards zurück, während echte Zugriffsfehler zurückgegeben werden.
• label (optional): operatorseitige Bezeichnung, die in Sitzungs-/Banner-Text verwendet wird.
• resumeSessionId (optional): eine vorhandene ACP-Sitzung wiederaufnehmen, statt eine neue zu erstellen. Der Agent spielt den Gesprächsverlauf über session/load erneut ein. Erfordert runtime: "acp".
• streamTo (optional): "parent" streamt Zusammenfassungen des Fortschritts der initialen ACP-Ausführung als Systemereignisse an die anfragende Sitzung zurück.
  • Wenn verfügbar, enthalten akzeptierte Antworten streamLogPath, der auf ein sitzungsspezifisches JSONL-Log (<sessionId>.acp-stream.jsonl) zeigt, das Sie für den vollständigen Relay-Verlauf verfolgen können.

​

Eine vorhandene Sitzung wiederaufnehmen

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

• Eine Codex-Sitzung vom Laptop an das Telefon übergeben — weisen Sie Ihren Agent an, dort weiterzumachen, wo Sie aufgehört haben
• Eine Coding-Sitzung fortsetzen, die Sie interaktiv in der CLI begonnen haben, nun headless über Ihren Agent
• Arbeit wieder aufnehmen, die durch einen Gateway-Neustart oder ein Idle-Timeout unterbrochen wurde

• resumeSessionId erfordert runtime: "acp" — bei Verwendung mit der Sub-Agent-Runtime wird ein Fehler zurückgegeben.
• resumeSessionId stellt den Upstream-ACP-Gesprächsverlauf wieder her; thread und mode gelten weiterhin normal für die neue OpenClaw-Sitzung, die Sie erstellen, sodass mode: "session" weiterhin thread: true erfordert.
• Der Ziel-Agent muss session/load unterstützen (Codex und Claude Code tun das).
• Wenn die Sitzungs-ID nicht gefunden wird, schlägt der Spawn mit einem klaren Fehler fehl — kein stillschweigender Fallback auf eine neue Sitzung.

​

Operator-Smoke-Test

1. Die bereitgestellte Gateway-Version/den Commit auf dem Ziel-Host verifizieren.
2. Bestätigen, dass der bereitgestellte Quellcode die ACP-Lineage-Akzeptanz in src/gateway/sessions-patch.ts enthält (subagent:* or acp:* sessions).
3. Eine temporäre ACPX-Bridge-Sitzung zu einem Live-Agenten öffnen (zum Beispiel razor(main) auf jpclawhq).
4. Diesen Agenten bitten, sessions_spawn aufzurufen mit:
   • runtime: "acp"
   • agentId: "codex"
   • mode: "run"
   • Aufgabe: Reply with exactly LIVE-ACP-SPAWN-OK
5. Verifizieren, dass der Agent Folgendes meldet:
   • accepted=yes
   • einen echten childSessionKey
   • keinen Validatorfehler
6. Die temporäre ACPX-Bridge-Sitzung aufräumen.

Use the sessions_spawn tool now with runtime: "acp", agentId: "codex", and mode: "run".
Set the task to: "Reply with exactly LIVE-ACP-SPAWN-OK".
Then report only: accepted=<yes/no>; childSessionKey=<value or none>; error=<exact text or none>.

• Halten Sie diesen Smoke-Test auf mode: "run", es sei denn, Sie testen absichtlich persistente ACP-Sitzungen mit Thread-Binding.
• Verlangen Sie für das grundlegende Gate nicht streamTo: "parent". Dieser Pfad hängt von Anforderer-/Sitzungsfähigkeiten ab und ist eine separate Integrationsprüfung.
• Behandeln Sie tests mit Thread-Binding und mode: "session" als zweiten, umfassenderen Integrationsdurchlauf aus einem echten Discord-Thread oder Telegram-Thema.

​

Sandbox-Kompatibilität

• Wenn die anfragende Sitzung sandboxed ist, werden ACP-Spawns sowohl für sessions_spawn({ runtime: "acp" }) als auch für /acp spawn blockiert.
  • Fehler: Sandboxed sessions cannot spawn ACP sessions because runtime="acp" runs on the host. Use runtime="subagent" from sandboxed sessions.
• sessions_spawn mit runtime: "acp" unterstützt sandbox: "require" nicht.
  • Fehler: sessions_spawn sandbox="require" is unsupported for runtime="acp" because ACP sessions run outside the sandbox. Use runtime="subagent" or sandbox="inherit".

​

Über den Befehl /acp

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

• --mode persistent|oneshot
• --bind here|off
• --thread auto|here|off
• --cwd <absolute-path>
• --label <name>

​

Auflösung von Sitzungszielen

1. Explizites Zielargument (oder --session für /acp steer)
   • versucht zuerst den Schlüssel
   • dann eine UUID-förmige Sitzungs-ID
   • dann die Bezeichnung
2. Aktuelle Thread-Bindung (wenn diese Konversation/dieser Thread an eine ACP-Sitzung gebunden ist)
3. Fallback auf die aktuelle anfragende Sitzung

​

Bind-Modi für Spawn

• --bind here ist der einfachste Operator-Pfad für „diesen Channel oder Chat mit Codex absichern“.
• --bind here erstellt keinen untergeordneten Thread.
• --bind here ist nur auf Channels verfügbar, die Unterstützung für die Bindung der aktuellen Konversation bereitstellen.
• --bind und --thread können nicht im selben Aufruf von /acp spawn kombiniert werden.

​

Thread-Modi für Spawn

• Auf Oberflächen ohne Thread-Binding ist das Standardverhalten effektiv off.
• Thread-gebundener Spawn erfordert Unterstützung durch die Channel-Richtlinie:
  • Discord: channels.discord.threadBindings.spawnAcpSessions=true
  • Telegram: channels.telegram.threadBindings.spawnAcpSessions=true
• Verwenden Sie --bind here, wenn Sie die aktuelle Konversation anheften möchten, ohne einen untergeordneten Thread zu erstellen.

​

ACP-Steuerung

• /acp spawn
• /acp cancel
• /acp steer
• /acp close
• /acp status
• /acp set-mode
• /acp set
• /acp cwd
• /acp permissions
• /acp timeout
• /acp model
• /acp reset-options
• /acp sessions
• /acp doctor
• /acp install

​

Kochbuch für ACP-Befehle

​

Zuordnung von Runtime-Optionen

• /acp model <id> wird der Runtime-Konfigurationsschlüssel model zugeordnet.
• /acp permissions <profile> wird dem Runtime-Konfigurationsschlüssel approval_policy zugeordnet.
• /acp timeout <seconds> wird dem Runtime-Konfigurationsschlüssel timeout zugeordnet.
• /acp cwd <path> aktualisiert die Überschreibung des Runtime-cwd direkt.
• /acp set <key> <value> ist der generische Pfad.
  • Sonderfall: key=cwd verwendet den Pfad für die cwd-Überschreibung.
• /acp reset-options löscht alle Runtime-Überschreibungen für die Ziel-Sitzung.

​

Unterstützung für acpx-Harnesses (aktuell)

• claude
• codex
• copilot
• cursor (Cursor CLI: cursor-agent acp)
• droid
• gemini
• iflow
• kilocode
• kimi
• kiro
• openclaw
• opencode
• pi
• qwen

​

Erforderliche Konfiguration

{
  acp: {
    enabled: true,
    // Optional. Standard ist true; auf false setzen, um ACP-Dispatch anzuhalten, während /acp-Steuerung erhalten bleibt.
    dispatch: { enabled: true },
    backend: "acpx",
    defaultAgent: "codex",
    allowedAgents: [
      "claude",
      "codex",
      "copilot",
      "cursor",
      "droid",
      "gemini",
      "iflow",
      "kilocode",
      "kimi",
      "kiro",
      "openclaw",
      "opencode",
      "pi",
      "qwen",
    ],
    maxConcurrentSessions: 8,
    stream: {
      coalesceIdleMs: 300,
      maxChunkChars: 1200,
    },
    runtime: {
      ttlMinutes: 120,
    },
  },
}

{
  session: {
    threadBindings: {
      enabled: true,
      idleHours: 24,
      maxAgeHours: 0,
    },
  },
  channels: {
    discord: {
      threadBindings: {
        enabled: true,
        spawnAcpSessions: true,
      },
    },
  },
}

• Discord: channels.discord.threadBindings.spawnAcpSessions=true

​

Plugin-Setup für das acpx-Backend

/acp doctor

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

openclaw plugins install ./path/to/local/acpx-plugin

/acp doctor

​

Konfiguration von acpx-Befehl und Version

1. Der Befehl verwendet standardmäßig node_modules/.bin/acpx innerhalb des ACPX-Plugin-Pakets.
2. Die erwartete Version verwendet standardmäßig die Fixierung der Extension.
3. Beim Start registriert sich das ACP-Backend sofort als nicht bereit.
4. Ein Hintergrundjob zur Sicherstellung prüft acpx --version.
5. Wenn die pluginlokale Binärdatei fehlt oder nicht passt, wird ausgeführt: npm install --omit=dev --no-save acpx@<pinned> und anschließend erneut geprüft.

{
  "plugins": {
    "entries": {
      "acpx": {
        "enabled": true,
        "config": {
          "command": "../acpx/dist/cli.js",
          "expectedVersion": "any"
        }
      }
    }
  }
}

• command akzeptiert einen absoluten Pfad, relativen Pfad oder Befehlsnamen (acpx).
• Relative Pfade werden vom OpenClaw-Workspace-Verzeichnis aus aufgelöst.
• expectedVersion: "any" deaktiviert die strikte Versionsprüfung.
• Wenn command auf eine benutzerdefinierte Binärdatei/einen benutzerdefinierten Pfad zeigt, ist die pluginlokale Auto-Installation deaktiviert.
• Der Start von OpenClaw bleibt nicht blockierend, während die Gesundheitsprüfung des Backends läuft.

​

Automatische Installation von Abhängigkeiten

​

MCP-Bridge für Plugin-Tools

openclaw config set plugins.entries.acpx.config.pluginToolsMcpBridge true

• Fügt beim Bootstrap von ACPX-Sitzungen einen integrierten MCP-Server mit dem Namen openclaw-plugin-tools ein.
• Stellt Plugin-Tools bereit, die bereits von installierten und aktivierten OpenClaw-Plugins registriert wurden.
• Belässt die Funktion explizit und standardmäßig deaktiviert.

• Dadurch wird die Tool-Oberfläche des ACP-Harnesses erweitert.
• ACP-Agents erhalten nur Zugriff auf Plugin-Tools, die bereits im Gateway aktiv sind.
• Behandeln Sie dies als dieselbe Vertrauensgrenze wie das Ausführen dieser Plugins in OpenClaw selbst.
• Prüfen Sie installierte Plugins, bevor Sie dies aktivieren.

​

Konfiguration von Berechtigungen

​

permissionMode

​

nonInteractivePermissions

​

Konfiguration

openclaw config set plugins.entries.acpx.config.permissionMode approve-all
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail

Wichtig: OpenClaw verwendet derzeit standardmäßig permissionMode=approve-reads und nonInteractivePermissions=fail. In nicht interaktiven ACP-Sitzungen kann jeder Schreib- oder Ausführungsvorgang, der eine Berechtigungsabfrage auslöst, mit AcpRuntimeError: Permission prompt unavailable in non-interactive mode fehlschlagen. Wenn Sie Berechtigungen einschränken müssen, setzen Sie nonInteractivePermissions auf deny, damit Sitzungen sich sanft verschlechtern, statt abzustürzen.

​

Fehlerbehebung