OpenClaw 当前部署逻辑与架构

面向你当前机器与仓库实践的执行导向说明,强调路由规则、执行闭环与日常操作标准。

多 Agent 形态:主控 + 角色 Agent 协作
通信入口:Telegram 群组/频道绑定路由
发布链路:collect-stone-lab 自动部署到 Cloudflare

概览

当前 Agent 布局

主控 Agent 负责统一接入、路由和上下文治理;角色 Agent 负责具体领域执行。

main mojia-luban mojia-notebooklm mojia-youmind mojia-zhangliang meta-mozi

核心执行主线

消息进入后先做绑定路由,再由目标 Agent 推理并调工具,经过安全与审批关卡后执行,最后回写响应。

可追踪 可回滚 高风险动作需确认

系统分层

入口网关(本地回环)

gateway 以本地 loopback 方式收敛请求,减少跨网络暴露面,统一做会话识别与消息标准化。

绑定路由

根据 Telegram 群组/频道与 Agent 的绑定表决定处理者;未命中则交主控或默认策略。

工具与技能

本地工具层提供 read/write/exec/browser;skills 封装重复工作流;memory 保持任务连续性。

Agent 编排

主 Agent 可下发给 subagents 或 ACP 流程节点,拆分任务并回收结果,最终汇总输出。

仓库与自动部署

`collect-stone-lab` 作为 Web 内容仓库,`push main` 触发 Cloudflare 相关自动构建与发布链路。

运行治理

每次发布前检查变更范围、命名与风险标签;发布后验证页面可达和关键路径可用。

消息路由

Telegram 入口
群组/频道消息进入
Binding 命中
按会话映射角色 Agent
Mention 策略
@指定角色优先触发
主控兜底
无绑定或冲突时裁决
执行分配
单 Agent 或多 Agent 协作
响应回写
回到原会话上下文

实操建议:在多人群中默认只响应被 @ 的角色 Agent;需要跨角色联动时,由主控发起并在回复中标记来源。

执行闭环

1. 消息入站:规范化输入,提取会话、角色、任务意图与上下文片段。
2. 路由绑定:依据频道/群组绑定与 mention 规则确定主处理 Agent。
3. 推理与工具:Agent 选择本地工具、技能、memory 或 subagents/ACP 进行分解执行。
4. 安全与审批:高风险动作(写入、执行、外发)进入确认门;低风险动作自动放行。
5. 执行与校验:运行命令或修改内容后进行结果检查,必要时重试或回滚。
6. 响应输出:按原会话返回结论、关键证据与下一步建议,保持可追踪链路。

安全策略

默认保护面

本地 loopback 优先、最小权限执行、修改前确认目标文件范围、变更后立即验证。

审批触发条件

涉及批量写入、删除、外网发布、凭据相关操作时,应要求人工确认并保留操作日志。

你的默认工作流

日常节奏(推荐)

早上先看绑定会话待办与失败重试记录;白天按角色分工执行并在群内明确 @ 目标 Agent;收尾阶段统一提交、发布与验收。

最佳实践清单

1) 会话里先声明目标和输出格式。2) 高风险动作先 dry-run。3) 同一任务保持单线程主 Agent,避免重复写入。4) 每次发布附带最小可复现说明。

发布前检查

确认 `git status` 干净、提交信息可追踪、关键页面本地可打开,再执行 `push main` 触发自动部署。

常见问题

Q1:同一群里多个 Agent 会不会抢答?

按 mention 优先和绑定策略处理。未 @ 时建议只让主控回复,再由主控分派给角色 Agent。

Q2:什么时候启用 subagents/ACP?

当任务跨工具、多阶段或需要并行验证时启用。简单任务保持单 Agent 可降低复杂度。

Q3:部署后如何快速确认是否生效?

先检查目标 URL 可访问,再验证核心交互(标签切换、折叠面板、移动端布局)是否正常。