1. 多 Agent 协同为什么总在 Daemon 和 Session 上翻车Managed Agents 这个词最近出现频率很高但真正落到本地跑起来卡住大多数人的不是概念而是两个具体的东西Daemon 起不来Session 连不通。我见过太多人把 Agent 角色、Squad 指令、技能库都配好了结果 Daemon 一启动就报「no runtime detected」或者 Session 一直卡在 queued 状态看板上的任务永远不动。这个场景的本质是Managed Agents 把「决策」和「执行」解耦之后执行侧需要一个常驻进程去轮询任务、拉起沙箱、上报事件这个进程就是 Daemon而每一次具体任务的执行上下文被封装成 Session。Daemon 是「谁在干活」Session 是「干的哪一单」。两者任何一个配置错位整条链路就断了。Multica 作为开源 Managed Agents 平台把这套模型落地成了可操作的工程结构本地 Daemon 扫描你机器上已装的 AI 编程 CLIClaude Code、Codex、OpenCode 等作为运行时云端或自托管后端负责任务队列和看板。而所有这些 Agent 调用最终都要走一个模型通道——这就是 TaoToken 统一 Key 要解决的问题。你不需要给每个 Agent 单独配一套厂商 Key而是让 Daemon 拉起的每个 Session 都通过同一个 API 通道出去。这篇要交付的是一份可复制的 config.toml 与 settings.json 骨架、CC Switch 的切换步骤、Daemon 启动与 Session 连通性的验证动作。目标很明确——让你在半小时内搭出一个能跑起来的人机 Agent 团队协同环境而不是停在「原理我都懂就是跑不起来」。2. TaoToken 前置统一 Key 与 API 通道准备在动 Daemon 之前先把模型通道打通。多 Agent 协同最烦的一点是队长 Agent 可能用 DeepSeek架构师用 Claude工程师用 GPT每个都要单独配 Key、单独管额度。TaoToken 的做法是给你一个统一 Key所有 Agent 的模型调用都走同一个 API 入口省掉多厂商凭据管理的麻烦。你需要做的只有三步。第一步拿到 API Key。访问控制台https://taotoken.net/console登录后在 API Keys 页面创建一个新 Key。建议按用途命名比如multica-daemon方便后面排查是哪个环境在用。第二步确认 API 通道地址。TaoToken 的 API 入口是https://taotoken.net/api这个地址会作为 OpenAI 兼容的 base_url 填进各个 CLI 的配置里。注意这里不要加任何多余路径CLI 会自己拼接/v1/chat/completions之类的端点。第三步想清楚你的 Agent 各自用什么模型。这一步不是必须现在定死但建议先规划队长和架构师这类偏推理的角色可以挂能力强的模型工程师这类长周期执行角色可以挂性价比高的模型。TaoToken 的好处是同一个 Key 可以调不同模型切换只改配置里的 model 字段不用换 Key。注意API Key 只创建一次就够所有 Agent、所有 Daemon、所有 Session 共用这一个。如果你后面要区分环境比如测试和生产再建第二个 Key但不要每个 Agent 建一个那样就失去统一通道的意义了。如果你还没决定用哪些 CLI 作为运行时建议至少装一个 Claude Code 或 CodexDaemon 启动时会自动探测。一个都没装的话Daemon 会直接拒绝启动这是最常见的第一个坑。3. 可复制配置config.toml 与 settings.json 骨架这一节是全文的核心直接给可复制的配置。Multica 的配置分两层Daemon 层的config.toml管运行时注册和轮询Agent 层的settings.json管模型通道和 Session 行为。3.1 Daemon 层 config.tomlconfig.toml一般放在~/.multica/config.tomlLinux/macOS或%USERPROFILE%\.multica\config.tomlWindows。下面是一份可直接改用的骨架# Multica Daemon 配置骨架 [daemon] # 控制端地址Cloud 模式填官方地址Self-Host 填你的后端 control_url https://multica.ai # 轮询间隔默认 3 秒网络差可调大 poll_interval 3s # 心跳上报间隔默认 15 秒 heartbeat_interval 15s # 日志级别debug 用于排障日常用 info log_level info [runtime] # Daemon 自动探测本机 CLI也可手动指定 auto_detect true # 手动指定时取消注释路径按实际改 # claude_code_path /usr/local/bin/claude # codex_path /usr/local/bin/codex # opencode_path /usr/local/bin/opencode [model] # TaoToken 统一 API 通道 base_url https://taotoken.net/api api_key sk-你的TaoTokenKey # 默认模型Agent 未单独指定时用这个 default_model claude-sonnet-4-20250514 [session] # Session 工作目录建议独立目录避免污染项目 work_dir ~/.multica/sessions # 单 Session 超时长任务调大 timeout 2h # 是否保留 Session 事件日志 keep_events true几个关键点解释一下。control_url决定你连的是 Cloud 还是 Self-Host这个填错 Daemon 会一直重连但连不上。base_url和api_key是 TaoToken 通道的核心所有 Session 的模型调用都从这里出去。work_dir建议独立不要让 Agent 直接在项目根目录跑否则沙箱隔离形同虚设。3.2 Agent 层 settings.json每个 Agent 角色可以有自己的settings.json放在 Agent 配置目录下。这份骨架覆盖模型通道、工具集、Session 行为{ agent: { name: mozi-fullstack, role: engineer, runtime: opencode, model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, model: deepseek-chat, max_tokens: 8192, temperature: 0.3 }, tools: [bash, read, write, edit], session: { persist: true, max_turns: 50, auto_compact: true }, skills: [design-taste-frontend] } }这里provider填openai-compatible因为 TaoToken 走的是 OpenAI 兼容协议。model字段按你给这个角色规划的模型填队长和架构师可以换成推理更强的工程师用性价比高的。tools按角色权限边界收窄——比如架构师角色其实不需要write和edit只给read和bash做调研就够了这是把「权限边界」从指令落到配置层。3.3 CC Switch 切换步骤如果你用 Claude Code 作为运行时CC Switch 是切换模型通道的常用工具。步骤很简单先安装 CC Switch然后打开它的配置界面新增一个 provider类型选 OpenAI 兼容base_url 填https://taotoken.net/apiapi_key 填你的 TaoToken Key模型名填你要用的。保存后在 Claude Code 启动前用 CC Switch 切到这个 providerClaude Code 的所有请求就会走 TaoToken 通道。实测下来CC Switch 切换后不需要重启终端但需要重新启动 Claude Code 进程因为 CLI 启动时才读配置。如果你发现切换后还是走旧通道先确认 CC Switch 的当前激活 provider 是不是你新建的那个。4. 验证请求Daemon 启动与 Session 连通性配置写完不算完得验证。这一节给具体的验证动作和预期结果。4.1 启动 Daemon终端执行multica daemon --config ~/.multica/config.toml预期输出会先打印探测到的运行时列表类似[INFO] detecting runtimes... [INFO] found: claude-code (/usr/local/bin/claude) [INFO] found: codex (/usr/local/bin/codex) [INFO] found: opencode (/usr/local/bin/opencode) [INFO] daemon started, control_urlhttps://multica.ai [INFO] polling every 3s, heartbeat every 15s如果这里报no runtime detected说明你一个 CLI 都没装或者路径不在 PATH 里。回到 3.1 节在config.toml里手动指定claude_code_path等字段。4.2 验证模型通道Daemon 起来后先单独验证 TaoToken 通道通不通。用 curl 直接打一次curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}], max_tokens: 10 }返回里有choices字段就说明通道正常。如果返回 401检查 Key返回 404检查 base_url 是不是多写了路径返回超时检查网络。4.3 验证 Session 连通性在 Multica 看板上创建一个测试 Issue分配给任意一个 Agent。预期流程是Issue 进入队列 → Daemon 3 秒内轮询到 → 创建 Session → Session 拉起对应 CLI → 执行 → 事件回传看板。你可以在 Daemon 日志里看到[INFO] task pulled: issue-123 [INFO] session created: sess-456, runtimeopencode [INFO] session started, modeldeepseek-chat via taotoken [INFO] event: session.running看板上任务状态从 queued 变成 running再变成 done就说明整条链路通了。如果卡在 queued 超过 10 秒是 Daemon 没轮询到检查control_url和网络。如果卡在 running 不动是 Session 内部模型调用失败回到 4.2 验证通道。5. 本篇常见错排查这一节把踩过的坑集中列一下按出现频率排序。Daemon 启动即退出报 no runtime detected。原因是一个 CLI 都没装或者装了但不在 PATH。解决装一个 Claude Code 或 Codex或在config.toml里手动指定路径。Session 一直 queued看板不动。原因是 Daemon 没连上控制端。检查control_url是否正确Cloud 模式是https://multica.aiSelf-Host 是你自己的后端地址。另外检查防火墙是否挡了 WebSocket。Session running 但模型调用报 401。原因是 TaoToken Key 填错或过期。回到控制台重新生成一个更新config.toml和settings.json里的api_key重启 Daemon。模型调用报 404。原因是 base_url 写错。TaoToken 的 base_url 是https://taotoken.net/api不要写成https://taotoken.net/api/v1CLI 会自己拼/v1。CC Switch 切换后不生效。原因是 Claude Code 进程没重启。CC Switch 改的是配置文件CLI 启动时才读所以切完要重启 CLI。Session 超时中断长任务。原因是timeout默认值太小。在config.toml的[session]里把timeout调到4h或更长。Agent 越权改了不该改的文件。原因是tools给太宽。按角色收窄架构师角色只给read和bash不给write和edit。提示排障时把log_level调到debugDaemon 会打印每次轮询和每次模型调用的详情定位问题快很多。日常记得调回info否则日志涨得很快。6. 把统一 Key 接进你的 Agent 团队配置跑通之后你会发现多 Agent 协同的真正瓶颈不在模型能力而在通道和调度的稳定性。TaoToken 统一 Key 解决的是通道层——一个 Key 打通所有 Agent 的模型调用切换模型只改配置字段不用动凭据管理。Multica 的 Daemon 和 Session 解决的是调度层——Daemon 常驻轮询Session 隔离执行事件全链路可追溯。如果你还在选型阶段建议先去模型对话页面https://taotoken.net/model-chat实际跑几个模型感受一下不同模型在 Agent 场景下的表现差异再决定哪个角色挂哪个模型。如果你已经确定要长期跑编码类 AgentCoding Planhttps://taotoken.net/coding-plan会更划算适合 Daemon 这种 7x24 常驻轮询的场景。接入文档在 https://taotoken.net/doc里面有各 CLI 的详细配置示例包括 Claude Code、Codex、OpenCode 的完整 settings 写法。API Keys 管理在 https://taotoken.net/api-keys建议给 Daemon 单独建一个 Key方便按环境排查。最后给一个实用建议先把单个 Agent 跑通再扩到多 Agent。很多人一上来就配三个角色加 Squad 指令结果 Daemon 都没起来排查起来一层套一层。正确的顺序是——单 Agent 跑通 → 验证 TaoToken 通道 → 加第二个 Agent → 配 Squad 指令 → 上多角色协同。每一步都验证过再往下走比一次性配完再 debug 快得多。
