vrr/openclaw
2
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-10-03 01:29:56 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 29
openclaw/extensions/acpx
History
Peter Steinberger 0fa2ffd812
fix(models): identify native app catalog sign-in failures (#156278) 
* fix(models): identify native app catalog sign-in failures

* fix(models): preserve catalog outcomes for arbitrary runtime IDs

* test(acpx): assert structured native catalog results
2026-09-23 07:32:00 +00:00
..
assets
skills/acp-router chore(deps): refresh dependencies with seven-day cutoff (#154652) 2026-09-21 16:55:54 -07:00
src fix(models): identify native app catalog sign-in failures (#156278) 2026-09-23 07:32:00 +00:00
test test(acpx): serialize fixture request dispatch (#154383) 2026-09-20 21:15:37 -07:00
AGENTS.md
doctor-contract-api.test.ts fix: prevent stale database workers across extension tests (#147986) 2026-09-14 08:26:56 -07:00
doctor-contract-api.ts
index.test.ts fix(models): identify native app catalog sign-in failures (#156278) 2026-09-23 07:32:00 +00:00
index.ts fix(gateway): apply settings without unnecessary restarts (#154792) 2026-09-21 11:50:57 -07:00
lazy-import.test.ts
openclaw.plugin.json feat(acpx): add native Copilot CLI model selection (#153799) 2026-09-21 00:20:10 +05:30
package.json fix(acpx): adopt acpx 0.19.1 runtime fixes (#155760) 2026-09-23 01:38:42 +08:00
README.md feat(acpx): add native Copilot CLI model selection (#153799) 2026-09-21 00:20:10 +05:30
register.runtime.test.ts fix(gateway): apply settings without unnecessary restarts (#154792) 2026-09-21 11:50:57 -07:00
register.runtime.ts fix(gateway): apply settings without unnecessary restarts (#154792) 2026-09-21 11:50:57 -07:00
runtime-api.ts
setup-api.ts
tsconfig.json

README.md

@openclaw/acpx

Official ACP runtime backend for OpenClaw.

ACPx lets OpenClaw run external coding harnesses through the Agent Client Protocol while OpenClaw still owns sessions, channels, delivery, permissions, and Gateway state.

Install

openclaw plugins install @openclaw/acpx

Restart the Gateway after installing or updating the plugin.

What it provides

  • ACP-backed agent runtime sessions.
  • Plugin-owned session and transport management.
  • MCP bridge helpers for OpenClaw tools and plugin tools.
  • Static runtime assets used by the ACP process bridge.

Native agents in the model picker

Install GitHub Copilot CLI, Kilo Code, OpenCode, Pi ACP, or Qwen Code and complete its login on the Gateway host, then refresh the model catalog. Choose one of its models to use that agent in ordinary chat. The agent owns its credentials; OpenClaw keeps the conversation transcript and asks for approval when the agent requests permission. Pi does not request tool approval unless an extension adds it. The same selection works in the web app and channels.

The runtime and provider IDs are acp-copilot, acp-kilocode, acp-opencode, acp-pi, and acp-qwen. Each model keeps its native ID, including any slashes. Configured ACP agent commands take precedence over installed defaults. Catalog refresh uses installed commands and does not install missing agents. Explicit ACP commands and bindings keep their existing agent names.

Models settings lists detected agents on the Gateway machine. Turn each native agent on or off there, or set plugins.entries.acpx.config.nativeAgents.<id> to false (copilot, kilocode, opencode, pi, or qwen). Missing flags are enabled. Disabling an agent prevents new native turns and catalog discovery without interrupting a running turn or deleting history. Classic ACP commands and acp.allowedAgents keep their existing behavior. Detection checks installed executables; it does not prove that an agent is logged in or can serve a model.

For GitHub Copilot CLI, run copilot login under the Gateway's OS account before refreshing the catalog. Copilot owns GitHub authentication, model access, and plan usage. Its explicitly configured BYOK providers remain CLI-owned and can incur separate API charges; OpenClaw does not select a BYOK route for it. See the Copilot setup and billing notes.

Native picker runtimes run on the Gateway host and use the native app's permissions. OpenClaw checks that execution choice before dispatching a chat turn; ACP runners do not implement OpenClaw sandboxing or workspace-only filesystem confinement.

When optional chat restrictions cannot be enforced, an administrator can choose Continue for this chat to use the native app's permissions. This grants Full Access and turns off optional sandboxing for that chat only; agent-wide and global settings stay unchanged. After a refused message, confirmation retries that message once. Confirming a model selection without a pending message does not send anything.

A creator-role-required sandbox cannot be removed, and remote execution placement is not supported. Choose a compatible runtime when those boundaries must remain. OpenClaw's Read Only, Guarded, and Workspace permission modes are not supported by these native runtimes.

Native tool permission requests still require their one-shot approval. Once approved, delegated filesystem writes do not encounter a second ACPX terminal approval gate. Classic ACP sessions keep their configured permissionMode. The ACP client's delegated filesystem remains rooted at its session cwd; this is not a sandbox for the native process's own filesystem access.

Catalog refresh closes its local connection. The native agent owns any history it creates. Reset and deletion close the local session and prevent its reuse, including after a Gateway restart. Native history stays with the agent; these operations do not delete it.

Configure

Use the ACP docs for harness-specific setup, permission modes, and model/runtime selection:

Package

  • Plugin id: acpx
  • Package: @openclaw/acpx
  • Minimum OpenClaw host: 2026.4.25