openclaw/acpx

解决的问题

acpx 提供了一个统一的无头命令行接口，用于与遵循 Agent Client Protocol (ACP) 的各种 AI 编码代理进行交互。它消除了为不同代理使用各自不一致终端接口的需求，提供了一种标准化的方式来管理持久会话、一次性执行以及用于自动化的机器可读输出。

运作方式

它作为 ACP 兼容服务器的客户端运作。用户可以选择特定的代理（例如 Codex、Pi 或 Claude Code）并通过 CLI 发送提示。该工具在本地（~/.acpx/ 下）管理会话状态，允许在多个提示之间保持上下文。它还支持“流程”（flows）——即结合 AI 回合与确定性逻辑及检查点的 TypeScript 工作流。

目标受众

希望标准化如何从终端触发 AI 编码代理，或通过其运行时库将代理能力嵌入其他应用程序的开发人员与编排者。

特色亮点

• 统一接口：在多个不同的 AI 代理之间使用一致的命令格式。
• 会话管理：支持持久化、具名的会话，以维护上下文与并行工作流。
• 自动化友好：提供用于机器可读事件的 NDJSON 输出，包含工具调用与差异（diffs），而非终端转义序列。
• 可扩展工作流：包含用于创建多步骤 TypeScript 工作流的流程系统。
• 灵活权限：提供可配置的权限模式，以控制代理对文件系统的访问。