一位总管，率领一群随插随拔的 AI 顾问——你的数据只属于你。
像雇佣一整个顾问团那样雇佣 AI —— 一位总管 + 一群随插随拔的顾问。
如果你已经玩过 Hermes / OpenClaw——你手里有一台很强的"引擎"：能接微信、能跑任务、能自己进化。但你很快会发现，交付到你手里的是一台改装底盘认领机：接通道、写配置、调提示词，全靠自己折腾；AI 很能干，却不知道你家的规矩。
如果你从没碰过这些——你只是想要一位已经上岗的总管家：说句话就记账，到点就提醒，月底给你一份像样的报告。你不想为了用 AI 先成为 AI 工程师。
AgentCrew 就是那块缺失的拼图——一个已经组建完毕、正在上班的顾问团：
| 直接用 Hermes / OpenClaw | 国内同类对话工具 | AgentCrew | |
|---|---|---|---|
| 交付形态 | 引擎/底盘，自己改装 | 一个会聊天的窗口 | 整车交付：总管+顾问团+面板，开箱上岗 |
| 你的规矩 | 自己写进提示词 | 没有 | 章程+范式：边界、数据隔离、勿扰、授权全预置 |
| 数据 | 混在会话记忆里 | 各自的云 | 本地存档区：明文可读、随搬家走、删档回厂 |
| 扩展 | 自己写代码 | 有限 | 照范式"造顾问"，丢进收编区就被管辖 |
| 换引擎 | —— | 绑定 | 家不动，引擎随便换（OpenClaw/Hermes/zcode 通吃） |
一句话：Hermes 和 OpenClaw 是引擎，AgentCrew 是装好的整车。 你甚至可以继续用它们的引擎——家不换。
| 🧩 随插随拔 | 顾问是完整独立项目。面板一键安装（模板/zip/文件夹/git 三式收编），拔出即独立运行（lite 模式），数据随它走 |
| 🏠 数据本地说了算 | 一切增量信息只进 _save\ 存档文件夹——明文可读、拷走即备份、删掉即回原点；程序区对运行时只读 |
| 🤝 担保授权 | 顾问之间永不互窥数据；确有需要，总管来问你，你点头才给一份带有效期的只读快照 |
| 🔁 换班管家模式 | 总管的全部状态在文件里——任何 AI 会话读章程即上岗。宿主随便换（OpenClaw/Hermes/zcode），公司不倒 |
| 📱 IM 优先 | 日常在聊天软件里说一句就记录；提醒/日报按你的可推送时段送达，勿扰时段绝不打扰 |
| 🖥 管家面板 | 本地网页管理台：顾问卡片墙+电源开关、数据浏览导出、存档告警、初始化表单 |
flowchart LR
Owner([主人])
subgraph Host["宿主运行时（OpenClaw / Hermes / zcode — 可替换）"]
M[<b>总管 Agent</b><br>章程即人格：路由·拆单·择时·汇报]
CRON[[哑时钟<br>人话规则 → cron]]
end
subgraph Crew["02-agents 顾问团"]
F[健身顾问]
S[样板顾问]
N[你的下一块积木…]
end
Panel[管家面板<br>本地网页]
IM[IM 通道<br>微信 / Telegram / …]
Save["_save 存档区 — 一切增量信息的唯一居所"]
Owner <-- 日常对话 --> IM
IM --> M
CRON -. 到点直推固定文案 .-> IM
M <-- 交办单/回执 纯文件协议 --> F
M <-- 交办单/回执 --> S
M <-- 交办单/回执 --> N
M --- Panel
F --- Panel
M -.-> Save
F -.-> Save
总管不是常驻程序，而是一份章程：任何 AI 会话（OpenClaw/Hermes/zcode）把工作区指到本文件夹，开机读章程即上岗——管家换班，公司不倒。顾问也不是插件，而是完整独立项目，和总管之间用纯文件协议（交办单/回执）通信——宿主、语言、运行时全部可替换。
📐 完整架构、生命周期时序、设计决策记录见 docs/ARCHITECTURE.md。
git clone https://github.com/August06exe/AgentCrew.git
cd AgentCrew
python 05-scripts/doctor.py # 体检：环境就绪检查方式 A · 管家面板（推荐）
# Windows：双击
04-panel/启动管家面板.bat # → 浏览器自动打开 127.0.0.1:7530方式 B · 接入你的运行时（IM 日常使用）
把本文件夹指给 OpenClaw / Hermes / zcode 的工作区——总管会主动发起两轮初始化（称呼与风格 → 推送时段与顾问启用），完成后正式上岗。Hermes 用户见 docs/DEPLOY-hermes.md。
然后，像给朋友发消息一样用它：
🗣 你：早饭吃了一碗牛肉面 🤖 总管：记好啦，早餐约 450 大卡，蛋白 27 克——存在健身顾问那儿。
个人实例（生产姿势）：框架仓库是"厂"，日常使用请生成你自己的家——
python 05-scripts/make-instance.py --to ../my-home --name my-home一切增量信息（档案/数据/信箱）只落在实例的 _save\ 里；程序更新替换 _save\ 以外的部分即可，旧档自动兼容。
备份与搬家（v0.3）：整个存档可打成单文件包带走——
python 05-scripts/save.py export # 存档上级目录生成 crew-save-*.asave（含全部个人数据，谨防外泄）
python 05-scripts/save.py import crew-save-*.asave # 导入恢复：目标非空自动先备份、旧版本自动阶梯迁移，全新实例无档也可直接导入管家面板「备份/恢复」页提供同款能力（导入走两步确认）。注意：lite 独立助理自带的 _save 不在实例包内，搬家请单独拷贝它的 _save。
不需要读框架代码。两种姿势：
- 面板可视化：安装页 →「从模板新建」→ 填 id/名字/一句话描述 → 自动收编；
- 丢给 AI：把
03-template/和00-docs/PARADIGM.md交给任意 AI："照这个范式给我造一个读书助理"。
范式核心：一个顾问 = manifest.json（身份/领域/正反例路由/数据表/人话提醒）+ 章程（双模式自查：有总管听总管，没总管自己当家）+ 人设 + 工具（仅标准库、必须过 --selfcheck）+ 可选看板。收编时八项校验自动执行，总管代码零改动。
我们把你部署后的每一笔数据都当成最值钱的资产来对待——这份存档里，装的是你的真实生活：
flowchart TD
subgraph Program["程序区（可整体替换）"]
Code[代码/章程/人设/manifest/模板/皮肤/种子库]
end
subgraph Save["_save 存档区"]
Master[master\\ 主人档案·名册·审计]
Data[agents\\id\\data 数据表·配置·回收站]
Mail[agents\\id\\inbox+outbox 信箱]
end
U1([更新]) -->|替换程序区| Program
U1 -.->|save_version 阶梯迁移，旧档自动兼容| Save
U2([回到原点]) -->|删除 _save| Save
U3([日常使用]) -->|一切增量信息| Save
- 一切增量信息只进
_save\——数据表、配置、信箱、主人档案；明文 JSONL，人能直接打开读； - 程序更新兼容旧存档 ——
save.json版本化 + 阶梯迁移；旧档读不了算程序的 bug； - 一键回厂 ——
python 05-scripts/save.py reset（二次确认）；换个说法：换机搬家 = 拷走一个文件夹； - 有人不守规矩？
save.py watch确定性扫描程序区违规增量——工具层硬约束，不靠 LLM 自觉。
python 05-scripts/adopt.py --zip some-agent.zip # 三式安装：zip / 文件夹 / git 地址
python 05-scripts/release.py some-agent # 放归：移出收编区，回 lite 独立模式顾问住在收编区 02-agents\ = 被总管管辖（托管模式）；单独拿走 = 自动变回独立单干（lite 模式）——住不住在屋里就是管辖信号，零配置。
为什么要"总管 + 子顾问"，而不是一个大而全的助理？
边界。健身数据不该和记账搅在一口锅里；职业顾问不该偷看你的睡眠。联邦制让每个领域有自己的专家、自己的数据、自己的边界——需要协作时由总管做担保授权（你点头才给只读快照），而不是默认互通。
我的数据安全吗？会上云吗？
一切数据是你电脑上的明文文件，无云端、无遥测、无隐藏上传。备份=拷走文件夹；审计=直接打开看。安全底线写进章程与范式：默认禁止联网外发用户数据。
支持微信吗？
总管不绑定通道。部署到 Hermes 时官方支持微信/Telegram/飞书等 30+ 通道（见 DEPLOY-hermes 笔记）；OpenClaw/zcode 等任何能读 AGENTS.md 的运行时也能直接上岗。
电脑关机了提醒会丢吗？
提醒规则是源，注册的定时任务是投影——重启后总管按 manifest 自动重挂，错过的提醒开机补发（前缀"您错过了"），且遵守你的勿扰时段。
为什么我看到的界面长这样（暖纸+赤陶土）？
设计系统来自 OpenDesign 官方库的 warm-editorial（暖纸编辑风）。不喜欢？设计规格集中在各看板的 DESIGN.md，改一处全家族生效——或者让 AI 帮你换一套。
| 版本 | 内容 | 状态 |
|---|---|---|
| v0.1 | 内置健身顾问（营养/代谢/目标/周报/看板）＋总管章程＋顾问范式＋存档架构＋管家面板 | ✅ |
| v0.2 | 内置理财顾问：复式账本记账、余额与预算、微信/支付宝账单导入、月度理财简报 | ✅ |
| v0.3 | 存档单文件导出/导入（.sav 式一键搬家） | ✅ 当前版本 |
| v1.x | 理财顾问增强：周期账单、截图记账、储蓄目标、决策计算器 | 规划 |
| v0.4 | 内置读书顾问 / 职业顾问（照同一范式量产） | 规划 |
| v0.5 | 顾问市场雏形：社区顾问一键收编 | 构想 |
| 远期 | 移动端 PWA 面板 / 多主人 / 可选云端常驻 | 愿景 |
每一版都遵守存档架构承诺：更新不丢档，删档回原点。
- 界面设计系统：OpenDesign 官方库
warm-editorial（暖纸编辑风）与DESIGN.md方法论 - 健身领域算法（BMR/TDEE/缺口策略）参考了社区通行的 Mifflin-St Jeor 公式与减脂实践
MIT © AgentCrew contributors