- name
- context-memory-ball
- description
- 上下文记忆球 - 原创技能。首创"记忆球"概念，将会话上下文封装为可保存、加载、恢复的独立单元。适用于会话切换、多任务并行、上下文恢复等场景。
- metadata
- {"openclaw": {"requires": {}, "install": []}}
- tags
- [context, memory-ball, session, checkpoint, restore]
- version
- 1.0.0
- author
- laosi
- source
- original
⚠️ 发布规则
所有发布到ClawHub的技能必须严格测试，确定没有问题再发布
技能测试验证清单
- [x] frontmatter格式正确
- [x] 功能原创独特
- [x] 概念清晰易懂
- [x] 操作流程完整
- [x] 无语法错误
Context Memory Ball - 上下文记忆球
原创技能 | 激活词: 记忆球 / 保存上下文 / 加载上下文
核心概念
什么是记忆球?
记忆球 = 上下文快照的封装单元
┌─────────────────────────────────┐
│ 记忆球 (Memory Ball) │
├─────────────────────────────────┤
│ ID: ball_20260428_001 │
│ 创建时间: 2026-04-28 13:45 │
│ 主题: 用户偏好分析 │
├─────────────────────────────────┤
│ 内容摘要: │
│ - 用户偏好: React + TypeScript │
│ - 当前任务: 开发用户模块 │
│ - 进度: 70% │
├─────────────────────────────────┤
│ 状态: active │
└─────────────────────────────────┘为什么叫"球"?
- 封装性: 完整的上下文单元
- 可滚动: 可以在不同会话间传递
- 弹性: 压缩后可以恢复
- 可叠加: 多个球可以合并
记忆球结构
class MemoryBall:
id: str # 唯一标识
timestamp: str # 创建时间
topic: str # 主题/标题
summary: str # 内容摘要
key_points: list # 关键点
decisions: list # 已做决策
pending: list # 待办事项
context_tokens: int # token数量
state: str # active/complete/archived操作命令
创建记忆球
用户: "帮我记住当前进度"
AI: 创建记忆球 #001
## 记忆球 #001 已创建
### 基础信息
- ID: ball_20260428_001
- 主题: 用户模块开发
- 创建时间: 2026-04-28 13:45
### 内容摘要
- 已完成: 用户登录、注册页面
- 进行中: 用户资料编辑
- 待开始: 用户权限管理
### 状态
🟢 active保存记忆球
# 保存到文件
mempalace save ball_001
# 导出JSON
mempalace export ball_001 --format json加载记忆球
# 从文件加载
mempalace load ball_001
# 加载并恢复上下文
"加载记忆球 ball_001"合并记忆球
当需要同时处理多个任务时：
用户: "加载球1和球3"
AI: 合并记忆球 #001 + #003
## 合并结果
### 当前上下文
- 任务A: 用户模块开发 (70%)
- 任务B: 订单模块设计 (30%)
### 建议
⚠️ 同时处理2个任务，是否需要拆分?归档记忆球
# 归档完成的任务
mempalace archive ball_001
# 归档并创建总结
mempalace archive ball_001 --summary使用场景
场景1: 会话切换
用户A: "先做任务X，记住进度"
AI: [创建记忆球 ball_A]
用户B: "切换到任务X"
AI: [加载 ball_A，恢复上下文]场景2: 多任务并行
项目A: [创建 ball_A]
项目B: [创建 ball_B]
项目C: [创建 ball_C]
随时切换: 加载任意球恢复场景3: 上下文恢复
长任务中断后:
用户: "继续上次的工作"
AI: [加载最近的active球]场景4: 经验积累
完成的项目:
- ball_001: React项目经验
- ball_002: API设计经验
- ball_003: 性能优化经验
新项目可以学习这些球的经验记忆球管理
列表查看
## 当前记忆球
| ID | 主题 | 状态 | 创建时间 |
|----|------|------|----------|
| 001 | 用户模块开发 | 🟢 active | 13:45 |
| 002 | 订单模块设计 | 🔴 pending | 14:20 |
| 003 | React经验总结 | ✅ complete | 昨天 |清理策略
| 策略 | 触发条件 | 动作 |
|---|---|---|
| 自动压缩 | 球超过10个 | 合并相似球 |
| 自动归档 | 球超过30天 | 标记archived |
| 自动删除 | 归档超过90天 | 彻底删除 |
与熵管理结合
上下文增长 → 熵值上升
创建记忆球 → 上下文精简
熵值下降 ← 恢复清晰状态| 熵管理 | 记忆球 |
|---|---|
| 上下文精简 | 打包保存 |
| 状态重置 | 加载新球 |
| 注意力聚焦 | 一次只加载一个球 |
输出格式
## 记忆球报告
### 统计
- 总数: 5个
- Active: 2个
- Archived: 3个
### 最近活动
- ball_001: 5分钟前更新
- ball_002: 2小时前更新
### 建议
🟢 记忆球状态良好原创性声明
本技能为原创，首创"记忆球"概念：
- 上下文封装单元
- 可保存/加载/恢复
- 支持合并和归档
- 与熵管理互补
作者: laosi 创建日期: 2026-04-28