openclaw/acpx

解决的问题

acpx 为与各种 AI 编码代理交互提供了一个统一的、无头的命令行界面。通过实现 Agent Client Protocol (ACP)，它消除了为不同代理使用不同终端界面的需要，使开发者能够在多个 ACP 兼容代理之间统一管理持久会话、权限和机器可读输出。

工作原理

该工具作为 Agent Client Protocol (ACP) 的客户端运行。它为 Codex、Claude Code、Gemini CLI 和 OpenClaw 等代理提供内置启动配置文件，同时也支持自定义 ACP 服务器。它会将会话状态存储在 ~/.acpx/ 中，以在提示之间保持上下文，并通过 exec 命令支持持久会话和无状态的“一次性”运行。

适用人群

希望通过 CLI 以标准化方式与 AI 编码代理交互、自动化代理工作流，并在不同代理提供商之间保持一致会话管理的开发者和编排者。

主要亮点

• 统一接口：在不同 AI 代理（如 Codex、Claude、Gemini）之间使用相同的命令结构。
• 持久会话：在多个提示之间保持上下文，并支持并行的命名工作流。
• 一次性运行：无需保存会话历史即可执行无状态运行。
• 自动化友好：支持 NDJSON 输出，以机器可读事件（包括工具调用和差异）代替终端转义序列。
• 自动化流程：可执行结合 AI 交互与确定性操作和检查点的 TypeScript 工作流。
• 细粒度权限控制：可控制代理操作的文件系统边界和审批策略。