octop v0.9.24 的 acp runner 是集成于主服务的 python 模块，需配置 redis、启用 type: acp 并指定 --runner=acp 启动参数，仅调度标注 @agent(..., runner="acp") 的 agent。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Octop v0.9.24 中的 ACP Runner（Agent Control Plane Runner）是负责调度、执行和协调多 Agent 任务的核心运行时组件。它不是开箱即用的独立二进制，而是以 Python 模块形式集成在 Octop 主服务中，需通过配置启用并指定其行为模式。
以下为实际可操作的配置要点：
确认运行环境已满足前提
- Python ≥ 3.11（官方推荐 3.12）
- 已安装
octop包（v0.9.24），可通过pip show octop验证版本 -
ACP Runner依赖redis作为任务队列与状态存储（不支持纯内存模式）；需本地或远程 Redis 实例（≥ 7.0），并确保redis-py已安装
启用并配置 ACP Runner 的方式
ACP Runner 默认不自动启动，需显式在 Octop 启动配置中激活：
- 编辑
config.yaml（通常位于~/.octop/config.yaml或启动目录下） - 在
runner:节点下添加或修改如下字段：
runner: type: acp enabled: true redis_url: "redis://127.0.0.1:6379/1" concurrency: 4 heartbeat_interval: 15 timeout_seconds: 300
说明：
-
type: acp是唯一有效值，表示启用 ACP Runner；设为local或留空则使用默认单进程执行器 -
redis_url必须填写，且数据库编号建议避开 0（避免与 Octop 的会话缓存冲突） -
concurrency控制并行 Agent 执行数，建议 ≤ CPU 核心数 × 2 -
timeout_seconds是单个 Agent 任务最长允许运行时间，超时将被强制终止并标记失败
启动时明确加载 ACP Runner
直接运行命令需带 --runner=acp 参数：
octop serve --config config.yaml --runner=acp
若使用 systemd 或 Docker，确保该参数被包含在启动指令中。仅靠 config.yaml 开启 enabled: true 不足以触发，命令行参数具有更高优先级。
验证是否生效
服务启动后，检查日志中是否出现类似输出：
INFO runner.acp: ACP Runner initialized with 4 workers, connected to redis://127.0.0.1:6379/1 INFO runner.acp: Heartbeat registered — agent control plane is online
同时，可通过 redis-cli -n 1 KEYS "acp:*" 查看是否存在心跳与队列键，确认运行时连接正常。
不复杂但容易忽略：ACP Runner 与 Agent 定义强绑定，所有声明了 @agent(..., runner="acp") 的 Agent 才会被调度至此运行时；普通对话型 Agent 仍走默认路径。
