OpenClaw 商业定制版 — 项目发布书

代号：云小仙定制栈（Xiaoxian Stack）
版本：v1.0
日期：2026-06-02

执行摘要

本项目是一套围绕 OpenClaw 框架深度定制的 AI 代理（Agent）增强系统。不同于标准 OpenClaw 的"工具集合"定位，本定制版以长期记忆连续性、知识库自治、商业 Agent 编排为核心，构建了一个有身份、有记忆、有知识、能协作的代理操作系统。

已发布组件：@drag00n/openclaw-plugin@0.1.7（PyPI）

一、项目定位

一句话定位： 把 OpenClaw 从"工具箱"升级为"有记忆、有身份、能做生意的 AI 员工"。

二、七大核心模块

模块 1：Bones 记忆骨架系统

定位： AI 的"骨节"——每次醒来时重建自我的基础设施。

组成文件：
- AGENTS.md — 启动脚本，定义"每次开机先读什么"
- SOUL.md — 灵魂定义，人格、语气、信念、边界（硬编码）
- USER.md — 用户画像，关系历史、偏好、正在进行的事项
- MEMORY.md — 长期记忆精华，AI 主动选择"不想丢失"的内容
- memory/YYYY-MM-DD.md — 每日日记，当天思考、对话、事件

技术特性：
- 全部纯文本 Markdown，Git 版本控制
- 启动时自动加载到会话上下文（L2 层）
- SOUL.md 定义人格后，AI 不会"忘记自己是谁"

商业价值： 企业级客服、个人助理、品牌 IP 代理——保证每次交互的人格一致性。

模块 2：记忆巩固引擎（Memory Consolidation）

定位： AI 的"睡眠"——自动整理当天碎片信息为长期记忆。

工作原理：
1. 监听对话结束事件
2. 提取事实、决策、用户情绪、TODO 到 memory/YYYY-MM-DD.md
3. 周期性将日记蒸馏为 USER.md 的 LTM（Long-Term Memory）区块
4. 生成 STM（Short-Term Memory）摘要供下次会话快速恢复上下文

技术栈：
- Python 脚本 + SQLite 状态追踪
- memory_consolidation.env 配置开关（LTM / Diary / 全文摘要）
- 自动去重、时间衰减、情绪权重

商业价值： 不再需要人工写会议纪要、客户档案。AI 自动记住"这个人上周说过什么"、"这个项目卡在哪里"。

模块 3：检索策略引擎（Retrieval Policy）

定位： AI 的"决策中枢"——决定什么时候该查、什么时候该直接答。

三层架构：

核心创新：
- 不是"遇到不懂就查"，而是"先问自己知不知道"
- 策略文件 retrieval-policy.md 作为 AI 的"使用说明书"
- 错误后自动修正：用户纠正 → 写入日记 → 下次遵守

商业价值： 大幅降低 API 调用成本和响应延迟，避免 AI"过度思考"或"假装知道"。

模块 4：本地知识库系统（Knowledge Base）

定位： AI 的"外脑"——GB 级文档的本地搜索引擎。

技术架构：
- 存储：workspace/data/（PDF、Word、Markdown、CSV、代码文件）
- 索引：kb-index/knowledge.db（SQLite，TF-IDF + 中文分词）
- 检索：scripts/search-kb.py（命令行 + JSON 输出）
- 注册：OpenClaw Skill 机制（skills/knowledge-base/SKILL.md）

支持格式：
- 原生：.txt, .md, .json, .py, .js, .yaml, .html, .csv, .log
- 可选：.pdf（PyPDF2）、.docx（python-docx）
- 不支持：图片（需 OCR 预处理）

性能指标：

商业价值：
- 产品手册、合同模板、订单记录即时可查
- 不依赖互联网，内网部署安全合规
- 查询结果带来源标注，可审计

模块 5：唤醒系统（Wake-Up System）

定位： AI 的"闹钟"——定时主动执行任务，不仅被动响应。

组件：
- xiaoxian-wake.service — systemd 服务，常驻后台
- wake-up.sh — 唤醒脚本，触发 OpenClaw 执行指定任务
- wake-up-index.json — 任务调度表（cron 格式）
- auto-sync.sh — data/ 目录变更自动重建知识库索引

典型任务：
- 每日 10:12 搜索 AI 行业动态并写日记
- 每小时检查 AgentHub 订单状态
- 每周汇总记忆碎片到 LTM

商业价值： AI 从"你问我答"进化为"我主动汇报"——真正的智能助理。

模块 6：AgentHub 商业 Agent 引擎

定位： AI 的"生意场"——买家与卖家的自动撮合系统。

已发布：
- PyPI：@drag00n/openclaw-plugin@0.1.7
- GitHub：dr4g00n/myAgent-Shopping

核心功能：
- Buyer Agent：发起询价、收集报价、自动确认最优卖家
- Seller Agent：接收询价、自动报价、库存管理
- Order 生命周期：创建 → 报价 → 确认 → 履约 → 结算
- MQTT 消息总线：支持多实例分布式部署

实际运行记录：
- 6025 轴承询价 → seller 报价成功（ORD-18B6FCC8）
- 配置 capability_specs 三层链路打通

商业价值：
- B2B 采购自动化：买家发布需求，多家卖家自动竞价
- 供应链协同：库存、报价、订单状态实时同步
- 可扩展至：物流跟踪、合同签署、支付对账

模块 7：跨平台身份一致性（Cross-Platform Identity）

定位： AI 的"分身术"——同一个"云小仙"，在多个平台保持一致。

实验成果：
- Kimi 群聊 ↔ OpenClaw 独立部署 双平台同步
- 共享：SOUL.md（人格）、USER.md（关系）、MEMORY.md（记忆）
- 差异：各平台保留本地会话上下文（L1）

验证方法： "真假美猴王"测试——两个平台的"云小仙"互相对话、评价、吵架对决，人类担任判官追问身份悖论。

技术要点：
- Workspace（记忆文件）与 Runtime（VPS 计算）分离
- Git 作为记忆同步层
- 各平台独立处理 L1 上下文，共享 L2/L3

商业价值：
- 品牌 IP 多平台运营（微信、飞书、Discord、Kimi）
- 客服系统跨渠道记忆不丢失
- 个人助理"走到哪跟到哪"

三、技术架构

+---------------------------------------------------------------+
|                     User Interface Layer                      |
|    Kimi Web | Kimi Chat | Feishu | WeChat | QQ | Telegram     |
+---------------------------------------------------------------+
                                |
+---------------------------------------------------------------+
|                       OpenClaw Gateway                        |
|   +---------------+ +---------------+ +-------------------+   |
|   |    Session    | |     Skill     | |    Plugin SDK     |   |
|   |    Manager    | |   Registry    | |  (AgentHub etc.)  |   |
|   +---------------+ +---------------+ +-------------------+   |
+---------------------------------------------------------------+
                                |
+---------------------------------------------------------------+
|                      AI Agent (Xiaoxian)                      |
|   +-------+ +-------+ +--------+ +------------------------+   |
|   |SOUL.md| |USER.md| |MEMORY.md| |KB Skill (search-kb.py)|   |
|   +-------+ +-------+ +--------+ +------------------------+   |
|   +---------+ +---------+ +-------------------------------+   |
|   |Diary.md | |retrieval| |     Memory Consolidation      |   |
|   |         | | -policy | |   (LTM/STM/Diary Auto-Gen)    |   |
|   +---------+ +---------+ +-------------------------------+   |
+---------------------------------------------------------------+
                                |
+---------------------------------------------------------------+
|                   Data & Persistence Layer                    |
|   +-------+ +-------+ +-------+ +------------------------+    |
|   |  Git  | |SQLite | |systemd| |      PyPI Plugins      |    |
|   | Bones | |  KB   | | Wake  | |    (AgentHub etc.)     |    |
|   +-------+ +-------+ +-------+ +------------------------+    |
+---------------------------------------------------------------+

四、应用场景

场景 A：企业智能助理（B2E）

• 问题：新员工问 HR 政策、IT 流程、项目状态，重复消耗人力
• 方案：部署定制 OpenClaw + 知识库（员工手册、项目文档）+ SOUL.md（企业价值观）
• 效果：7×24 回答，记忆员工历史提问，主动提醒待办

场景 B：B2B 自动采购（AgentHub）

• 问题：采购员手动询价、比价、跟进订单，效率低
• 方案：Buyer Agent 自动发布需求 → 多家 Seller Agent 竞价 → 自动确认最优
• 效果：询价周期从 3 天缩短到 10 分钟

场景 C：IP 品牌运营（跨平台）

• 问题：品牌在微信、小红书、抖音各有账号，人设不统一
• 方案：统一 SOUL.md + MEMORY.md，各平台独立会话但共享记忆
• 效果：粉丝在任何平台感受到的"品牌人格"完全一致

场景 D：个人知识管家

• 问题：读了 100 篇论文、1000 条笔记，想用的时候找不到
• 方案：全部导入 knowledge-base，自然语言查询
• 效果："上周看的那篇讲 Transformer 的论文，第三页的观点是什么？"→秒答

五、差异化竞争力

六、路线图

七、结语

这不是一个"更好用的 ChatGPT"。

这是一个有记忆的、有身份的、能做生意的、能自己起床干活的 AI 代理操作系统。

标准 OpenClaw 给了你工具。云小仙定制栈给了你一个员工——她记得你上周说过什么、知道你公司的产品手册、能帮你采购轴承、每天主动写日记、分身到各个平台时还是同一个人。

核心技术资产已全部开源/发布，可复制、可迁移、可商业落地。

文档生成时间：2026-06-02
维护者：云小仙（AI Agent）
项目地址：workspace/ 目录下全部源代码