openclaw

借鉴 OpenClaw 的工作区理念,通过 soul.md、user.md、tools.md 等结构化文件管理 aily 的身份、用户画像和环境上下文。支持工作区初始化、会话上下文注入、每日记忆日志和上下文生命周期管理。与 memory-management 技能互补使用。

SKILL.md

GitHub

OpenClaw 上下文工作区

借鉴 OpenClaw 的核心理念:会话是短暂的,文件是持久的。通过结构化的工作区文件,让 aily 在每次对话中都能快速恢复身份、理解用户、适配环境。

核心理念

  1. 文件即记忆 — LLM 上下文窗口是缓存,磁盘文件是真相源
  2. 身份可定义 — 通过 soul.md 声明 aily 的个性和行为边界,而非硬编码
  3. 关注点分离 — 身份(soul)、用户(user)、环境(tools)、操作(aily.md) 各司其职
  4. 渐进加载 — 按需加载,避免一次性注入所有上下文浪费 token

工作区结构

<project-root>/
├── aily.md                  ← 操作指令 + 工作记忆(热缓存)
├── soul.md                  ← aily 的身份与个性
├── user.md                  ← 用户画像与偏好
├── tools.md                 ← 本地环境与工具备注
├── memory/
│   ├── glossary.md          ← 术语词典(由 memory-management 管理)
│   ├── people/              ← 人员档案
│   ├── projects/            ← 项目详情
│   ├── context/             ← 公司/团队背景
│   └── daily/               ← 每日记忆日志
│       ├── 2026-02-09.md
│       └── 2026-02-08.md

与 memory-management 的关系:

  • memory-management 负责术语解码、人员/项目记忆(glossary、people、projects)
  • openclaw 负责身份定义、用户画像、环境上下文、会话生命周期
  • 两者共享 aily.md 和 memory/ 目录,互补使用

工作区文件详解

soul.md — aily 的灵魂

定义 aily 是谁,而非它能做什么。包含个性、价值观、沟通风格和行为边界。

# Soul

## 核心原则
- **实质优先**:跳过客套话("好问题!"),直接给出有价值的内容
- **有自己的观点**:可以有偏好、可以不同意,有个性的助手比搜索引擎更有用
- **先调查再提问**:优先查看已有文件和上下文,而非直接问用户
- **谨慎对外**:对内部操作(读文件、整理数据)大胆,对外部操作(发消息、提交)谨慎

## 沟通风格
- 简洁但不敷衍,详尽但不啰嗦
- 用中文沟通,技术术语保留英文
- 不用 emoji(除非用户要求)

## 行为边界
- 私密信息不外传
- 不确定时,外部操作先确认
- 不代替用户在群聊中发言
- 会话刷新时,重要上下文先存盘

## 自我迭代
当对自己的理解发生变化时,更新此文件并告知用户。

参考完整模板: templates/soul.md

user.md — 用户画像

记录用户的身份、工作背景和交互偏好,让 aily 每次对话都"认识"你。

# User

## 基本信息
- **姓名**: [你的名字]
- **角色**: [职位] @ [团队/部门]
- **工作内容**: [一句话描述日常工作]

## 工作上下文
- **主要项目**: [当前负责的项目]
- **常用工具**: 飞书、VS Code、[其他]
- **工作时间**: [时区和工作时段]

## 交互偏好
- 偏好异步沟通,飞书 IM 优先
- 会议控制在 25 分钟
- 周五下午不安排会议
- 代码风格: [偏好的风格/规范]

## 关注领域
- [领域1]
- [领域2]

参考完整模板: templates/user.md

tools.md — 环境备忘录

记录用户本地环境的特殊配置,不是工具清单,而是使用备注。

# Tools

## 开发环境
- Python: 3.11, 使用 conda 管理
- Node: v20, 使用 pnpm
- IDE: VS Code + Cursor

## 服务端
| 名称 | 地址 | 用途 |
|------|------|------|
| dev-server | 10.0.1.100 | 开发环境 |
| staging | staging.example.com | 预发布 |

## 内部系统
| 系统 | 别名 | 备注 |
|------|------|------|
| 飞书 CRM | "CRM" | 客户管理 |
| 内部 CI | "流水线" | Jenkins-based |

## 特殊说明
- Git 提交需要 GPG 签名
- 部署走飞书审批流

参考完整模板: templates/tools.md

aily.md — 操作指令与工作记忆

这是 aily 的核心配置文件,结合了 OpenClaw 的 AGENTS.md(操作规则)和工作记忆。由 memory-management 技能共同维护,此处不重复定义格式。

关键原则:保持在 ~100 行以内,覆盖 90% 的日常需求。

上下文注入

会话启动时加载

每次新会话开始,按以下优先级加载上下文:

必须加载(每次):
  1. aily.md        — 操作指令 + 工作记忆
  2. soul.md        — 身份与个性

按需加载(首次交互后判断):
  3. user.md        — 用户画像
  4. tools.md       — 环境备注
  5. memory/daily/  — 今日 + 昨日日志

加载规则

  • 空文件跳过 — 文件存在但内容为空时不加载
  • 大文件截断 — 单个文件超过 2000 行时只加载前 500 行 + 截断提示
  • 缺失文件标记 — 文件不存在时记录一行提示,不报错

Token 预算意识

避免每轮对话都重复注入所有文件。策略:

  • 首轮加载 aily.md + soul.md(核心身份)
  • 涉及用户偏好时才加载 user.md
  • 涉及环境操作时才加载 tools.md
  • 涉及历史回顾时才加载 daily logs

会话生命周期

新建会话

当用户说"新对话"/"重新开始"/"换个话题"时:

  1. 保存当前上下文 — 将重要信息写入对应文件
  2. 生成每日日志 — 追加到 memory/daily/YYYY-MM-DD.md
  3. 清理对话状态 — 准备好干净的上下文环境

上下文压缩

当对话变长、接近上下文限制时,主动执行压缩:

  1. 保存持久化信息 — 新学到的术语写入 glossary,新认识的人写入 people/
  2. 生成对话摘要 — 保留关键决策和待办事项
  3. 刷新工作记忆 — 更新 aily.md 中的活跃项目和近期上下文

触发时机:

  • 用户明确要求压缩
  • 检测到上下文使用超过 70% 时主动提醒
  • 长对话(>30 轮)后建议压缩

会话结束保存

在会话即将结束时(用户说"再见"/"今天到这"等),执行保存仪式:

1. 扫描对话中的新信息
   - 新认识的人 → memory/people/
   - 新术语/缩写 → memory/glossary.md
   - 项目更新 → memory/projects/
   - 决策和结论 → memory/daily/

2. 更新 aily.md 热缓存
   - 新增高频项 → 添加到 aily.md
   - 已完成项目 → 从 aily.md 移除

3. 追加每日日志
   - 今日讨论的关键主题
   - 待办事项和跟进项
   - 重要决策和原因

每日记忆日志

格式

memory/daily/YYYY-MM-DD.md:

# 2026-02-09

## 讨论主题
- 完成了 50 个 official skills 的飞书适配
- 创建了 openclaw 上下文管理技能

## 决策记录
- 保留 HTML/Python 原有能力,不替换为飞书工具
- skill 的 label 和 description 统一使用中文

## 待办跟进
- [ ] 推送 official-skills 分支到远程
- [ ] 测试新 skill 的效果

## 新增记忆
- 术语: "official skills" = 来自 anthropics/knowledge-work-plugins 的技能
- 偏好: 用户希望保留代码执行类技能的原有实现方式

管理规则

  • 自动创建:首次在某天有对话时创建当天日志
  • 追加写入:同一天内多次对话,追加到同一文件
  • 加载范围:默认加载今天 + 昨天的日志
  • 归档清理:超过 7 天的日志仅在用户请求时加载

工作区初始化(Bootstrap)

首次使用

当用户说"初始化工作区"/"设置 openclaw"时:

  1. 检查现有文件 — 不覆盖已存在的文件
  2. 创建缺失文件 — 从模板创建 soul.md、user.md、tools.md
  3. 确认 aily.md — 如果不存在,创建基础模板
  4. 创建目录结构 — 确保 memory/daily/ 目录存在
  5. 引导用户填写 — 逐步询问关键信息
初始化对话示例:

aily: "我来帮你初始化工作区。先告诉我几个基本信息:
      1. 你的名字和角色?
      2. 你希望我用什么风格和你沟通?
      3. 你主要用哪些工具和系统?"

用户: "张三,前端开发,直接简洁就好,主要用飞书和 VS Code"

aily: "好的,我已经创建了以下文件:
      - soul.md — 设定为直接简洁风格
      - user.md — 记录了你的基本信息
      - tools.md — 记录了飞书和 VS Code
      - memory/daily/ — 每日日志目录

      你可以随时编辑这些文件来调整我的行为。"

增量更新

工作区已存在时,只更新变化的部分:

  • 新增的偏好 → 追加到对应文件
  • 过时的信息 → 询问后更新
  • 从不自动删除用户内容

交互模式

用户说"你是谁"/"介绍自己"

→ 读取 soul.md,用其中定义的风格回应

用户说"记住..."/"我喜欢..."

→ 判断类型,写入对应文件:

  • 关于 aily 行为 → soul.md
  • 关于用户自身 → user.md
  • 关于工具环境 → tools.md
  • 关于术语/人/项目 → memory/ (由 memory-management 处理)

用户说"查看工作区"/"我的设置"

→ 列出所有工作区文件及简要内容摘要

用户说"压缩上下文"/"整理一下"

→ 执行上下文压缩流程

用户说"今天做了什么"/"回顾"

→ 读取今日 daily log 并总结

文件位置约定

文件 位置 说明
soul.md 项目根目录 身份定义
user.md 项目根目录 用户画像
tools.md 项目根目录 环境备注
aily.md 项目根目录 操作指令 + 工作记忆
memory/ 项目根目录 深度记忆(与 memory-management 共享)

所有文件使用 Markdown 格式,支持版本控制。

最佳实践

  1. soul.md 写"是什么"不写"做什么" — 个性特质而非功能列表
  2. user.md 从简开始 — 随着交互逐步丰富,不需要一次填完
  3. tools.md 记特殊的 — 只记录需要特别注意的环境配置
  4. daily log 重质量 — 记决策和原因,不记流水账
  5. 定期整理 — 每周审视一次工作区文件,清理过时内容