上下文管理器技能

为 OpenClaw 会话提供 AI 驱动的上下文管理。利用 Agent 自身生成智能摘要，随后以压缩后的上下文重置会话。

快速开始

# 列出所有会话及其用量统计
~/openclaw/skills/context-manager/compress.sh list

# 检查指定会话的状态
~/openclaw/skills/context-manager/compress.sh status agent:main:main

# 生成 AI 摘要（只读、安全）
~/openclaw/skills/context-manager/compress.sh summarize agent:main:main

# 压缩会话：生成摘要 → 重置 → 注入（破坏性操作）
~/openclaw/skills/context-manager/compress.sh summarize agent:main:main --replace

适用场景

• 上下文用量接近 70–80% 及以上
• 持续时间长、对话历史繁杂的会话
• 会话即将变慢或丧失连贯性之前
• 主动维护高效、聚焦的会话体验

工作原理

1. AI 摘要生成：向 Agent 发送提示词，要求其对自身上下文进行总结
2. 备份：将原始 JSONL 会话文件保存至 memory/compressed/
3. 重置：删除 JSONL 文件（官方重置方式）
4. 注入：将 AI 生成的摘要作为首条消息发送至新会话
5. 结果：会话 Key 不变，会话 ID 更新，上下文被压缩

关键洞察：Agent 对自身上下文具备完全可见性，因此能生成质量最优的摘要。

命令列表

会话相关命令

配置相关命令

使用示例

列出所有会话

$ ~/openclaw/skills/context-manager/compress.sh list
📋 可用会话（共 4 个）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#    SESSION KEY                              KIND       TOKENS    USAGE
1    agent:main:main                          direct      70188      70%
2    agent:main:slack:channel:c0aaruq2en9     group       20854      20%
3    agent:main:cron:0d02af4b-...             direct      18718      18%

检查会话状态

$ ~/openclaw/skills/context-manager/compress.sh status agent:main:main
📊 上下文管理器状态
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Session Key: agent:main:main
  Session ID:  fc192a2d-091c-48c7-9fad-12bf34687454
  Kind:        direct
  Model:       gemini-3-flash
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Threshold:   80%
  Tokens:      70188 / 100000
  Usage:       70%

生成 AI 摘要（安全、只读）

$ ~/openclaw/skills/context-manager/compress.sh summarize agent:main:main
🧠 正在为会话请求 AI 摘要：agent:main:main
  Session ID: fc192a2d-091c-48c7-9fad-12bf34687454

✅ AI 摘要已生成！
  已保存至：memory/compressed/20260127-123146.ai-summary.md

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
### 会话摘要：2026 年 1 月 27 日

#### 1. 已完成事项
- 系统审计已完成
- 使用子 Agent 完成论文生成
...

完整压缩流程（摘要 + 重置 + 注入）

$ ~/openclaw/skills/context-manager/compress.sh summarize agent:main:main --replace
🧠 正在为会话请求 AI 摘要：agent:main:main
  Session ID: fc192a2d-091c-48c7-9fad-12bf34687454
  Mode: REPLACE（摘要生成后将重置会话）

✅ AI 摘要已生成！
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[此处显示 AI 生成的摘要]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔄 正在重置会话并注入压缩后的上下文...
  正在备份会话文件...
  备份已保存至：memory/compressed/20260127-123146.session-backup.jsonl
  正在删除会话 JSONL 文件以执行重置...
  正在将压缩后的上下文注入新会话...
✅ 会话压缩成功！
  原会话 ID：fc192a2d-091c-48c7-9fad-12bf34687454
  新会话 ID：a1b2c3d4-...
  会话已就绪，可基于压缩后的上下文继续运行

效果：70k tokens → 16k tokens（减少 77%）

输出文件

执行压缩时，以下文件将创建于 memory/compressed/ 目录中：

依赖要求

• openclaw —— Gateway 必须处于运行状态
• jq —— JSON 解析工具（brew install jq）
• Gateway 访问权限 —— 脚本调用 openclaw agent 和 openclaw sessions

技术细节

会话重置方式

脚本采用 JSONL 文件删除方式重置会话（官方推荐方式）：

1. 将 JSONL 文件备份至 memory/compressed/
2. 删除 ~/.openclaw/agents/{agent}/sessions/{sessionId}.jsonl
3. 通过 openclaw agent --to main 发送压缩后的上下文
4. 系统自动创建新会话，并将摘要设为首条消息

为何不使用 /reset？

/reset 斜杠命令仅在聊天界面中生效；若通过 openclaw agent --session-id 发送，该命令会被视为普通消息，Agent 将尝试将其解释为一项任务而非重置指令。

AI 摘要生成提示词

脚本向 Agent 提出如下结构化要求：

1. 已完成事项（关键任务）
2. 关键决策（含决策依据）
3. 当前状态（上次中断位置）
4. 待办事项（仍需执行的任务）
5. 重要上下文（需长期记忆的关键信息）

故障排查

摘要内容为空

若 AI 摘要提取失败，请检查 stderr 重定向逻辑：

# 脚本使用 2>/dev/null 屏蔽 Node 弃用警告，避免干扰 JSON 输出
openclaw agent --session-id $ID -m "..." --json 2>/dev/null

会话未成功重置

请验证 JSONL 文件路径是否正确：

ls ~/.openclaw/agents/main/sessions/

从备份恢复

若发生异常：

cp memory/compressed/{timestamp}.session-backup.jsonl 
   ~/.openclaw/agents/main/sessions/{sessionId}.jsonl

查看日志

使用 openclaw logs 进行问题诊断：

openclaw logs --limit 50 --json | grep -i "error|fail"

最佳实践

1. 先备份：脚本会自动备份，但测试前亦可手动备份
2. 优先在非关键会话中测试：建议先在 Slack 频道或 cron 会话中验证，再应用于 main 会话
3. 检查摘要质量：首次运行时请先使用 summarize（不带 --replace）确认摘要准确性
4. 监控 token 数量：使用 status 命令验证压缩效果

参阅

• openclaw sessions --help
• openclaw agent --help