sofagent — 设备端 Agent 纪律委员
License MIT v0.93 OpenClaw First

设备端
Agent 的纪律委员

为 FDE 场景提供纪律层与反思循环——Agent 工作不看上下文、做完了不验证、同一个坑反复踩？sofagent 约束其工作习惯、从错误中沉淀教训。

GitHub 上查看 快速安装
「sofa + agent = 沙发特工——希望有一天，我们能躺在沙发上，Agent 就把活干完了」
当前能力

当前能力

sofagent 不跑你的任务，管跑你任务的 Agent。下面是在当前版本（v0.93）中已经交付的能力。

纪律层核心
所有平台生效
4 条底线 + 10 条铁律（先读后写 / 验证再干 / 谨慎修改 / 如实汇报…）
三层加载链（宪法 → 反思区 → 你的规则），整个会话永远在线
反思区（think.md）自动错题本——Agent 从错误中学习
规则定制（rules.md）——你的规则优先级最高
治理层增强
OpenClaw 专属
任务编排引擎——🔴 复杂任务自动拆解、批量执行、Loop 检查
断路器 + 步数闸——session 隔离，防止 Agent 失控
渐进减薄——同类任务根据历史成功率调整编排深度
sofagent-audit 提交时审计——扫描 git diff 对标铁律，不依赖 Agent 运行时配合
10
条行为铁律
先读后写、验证再干、谨慎修改、如实汇报……每一条都来自真实 Agent 失控的教训。不是实验室规则，是大半年每天用 Agent 踩出来的坑。
3K
token 常驻地基
不到 128K 窗口的 2.5%。三层加载链（宪法→反思→你的规则）整个会话永远在线，不吃算力、不拖速度。
0%
vs 100% 误伤率
v0.93 对照实验中，sofagent 组变量名误伤率 0%，裸 Agent 组 100%。10 组实验进行中——纪律层增量不是信仰，是可验证的事实。
架构总览

工作原理

三层加载链（常驻地基）→ 复杂度预判 → 🔴 复杂任务编排引擎点火 → 反思闭环

三层加载链 → 编排引擎
宪法
4 底线 + 10 铁律
反思区
think.md 错题本
你的规则
rules.md 最高优先级
↓
A0 复杂度预判
↙
↘
🟢🟡 简单任务 → 直接回答
🔴 复杂任务 → 编排引擎点火
↓
智能拆解
→
批量执行
→
Loop 检查
→
反思闭环
🔄 重新注入三层加载链

核心产品架构（当前交付 3/5）

层 干什么 状态
纪律层 Agent 上下文，纯 MD 文件 ✅ v0.93
执行层 daemon 常驻进程 ✅ v0.93
审计层 git diff 提交时审计 ✅ v0.93
MCP 推送层 文件监听 + 主动推送企业平台 v0.94 规划
协同层 多设备任务分发 + 联邦治理 v2.x 规划
企业工作流

从企业工作流 到 AI 节点——FDE 的完整闭环

FDE 的第一项工作不是装 Agent，是帮企业看清 workflow。看清之后——要么让 AI 自动跑，要么让 AI 辅助人。

FDE 入驻企业 → 梳理工作流 → 识别 AI 节点 → sofagent 接管
FDE 入驻企业
▼
梳理企业工作流
▼
识别 AI 可接管的节点
▼
↙
↘
🔄 自动执行 工作流中自动完成一项固定任务
⚡ 强化岗位 增强某个人的工作能力
▼
↘
▼
↙
sofagent 接管节点
OC
OpenClaw 底座
设备端 Agent 运行时，无头设备常驻运行
SF
sofagent 纪律层
4 底线 + 10 铁律：先读后写、验证再干、谨慎修改、如实汇报
SA
Sub-Agent Session
首次编排后固化，每次自动复用——不重新推理，直接执行
MC
MCP → 企业平台
钉钉 / 企微 / 飞书 / Slack / Teams — 任务完成即时通知
自动执行 — 工作流中的 AI 节点
  • 反复出现、规则明确的任务
  • 首次编排固化，之后每次自动执行
  • 不需要人盯着——AI 独立完成并汇报
强化岗位 — 增强人的能力
  • 不是替代人，是做人的 AI 副驾驶
  • Agent 辅助分析、审查、决策
  • 人做最终判断，Agent 提供弹药
固定 Sub-Agent Session + 记忆蒸馏
  • 每个 AI 节点对应一个固定的 sub-agent session
  • 定期蒸馏记忆到企业知识库
  • 防止记忆膨胀和错乱——数据主权在设备
「FDE 的第一项工作不是装 Agent，是帮企业看清 workflow。看清之后——要么让 AI 自动跑，要么让 AI 辅助人。一台无头设备 + sofagent = 企业 workflow 中一个永不掉线的节点。」
未来规划

FDE 演进路线

从设备端纪律委员到多设备联邦治理——sofagent 的演进路线清晰可追踪。

v0.93 – v0.99
近期工程化
夯实工程地基，跑通端到端链路
  • 工程迁移 bash → TypeScript
  • JSONL 结构化日志 + MCP server MVP
  • 对接 Agency Agent 模板库
  • OpenClaw 预装集成
  • 首个企业平台 webhook 接入（飞书 / Slack）
  • 45 组反转实验数据分析
  • Beta 公测：招募 20 个用户，30 天试用
v1.0
设备端纪律委员正式版
经过实验验证、全链路跑通的里程碑版本
  • 纪律层增量被实验证实
  • OpenClaw 预装 + AO compose + Agency Agent 全链路跑通
  • MCP server + 企业平台 webhook 跑通
  • daemon 在 macOS / Linux 稳定运行 ≥ 30 天
  • install → verify → 首次任务通过率 ≥ 90%
v2.x
多设备协同
FDE 完整形态——多设备联邦治理
  • 协同编排协议：Markdown 优先，人可直接阅读
  • Agent 发现与注册：内网自动发现 + 手动白名单
  • 跨设备任务分发：根据能力画像智能分派
  • 企业 Agent 知识库：多设备蒸馏记忆聚合到企业自有存储
平台支持

运行平台

sofagent 在不同平台上提供不同程度的约束与治理能力。

⭐ 推荐使用
OpenClaw — 完整治理能力
100%
Hook 自动注入宪法 + 编排引擎 + 断路器 + daemon 常驻进程 + MCP Server。sofagent 的全部能力在 OpenClaw 上完整交付。
WorkBuddy
核心约束生效（@skill 加载），编排引擎可手动装 npm
Codex / Hermes / Claude Code
核心约束手动粘贴种子指令生效，无编排引擎
如果现有平台不是 OpenClaw
装个 OpenClaw + sofagent，把老平台当 sub-agent 用
💡 如果现有平台不是 OpenClaw → 装个 OpenClaw + sofagent，把老平台当 sub-agent 用
快速开始

安装 只需一条命令

完整安装包含 OpenClaw 底座、编排引擎、审计 hook。也可以选择 Lite 版 30 秒获得宪法层约束。

完整安装
$ git clone https://github.com/KongFangXun/sofagent.git
$ cd sofagent && bash sofagent/scripts/install.sh
Lite 版（30 秒，仅宪法层）
$ bash sofagent/scripts/install.sh --lite
OpenClaw
WorkBuddy
Claude Code
Codex
Hermes Agent