Session History Retriever Clean

查看历史会话记录并引用导入到本地对话。使用 sessions_list、sessions_history 和 sessions_send 工具管理会话历史。适用于：(1) 查找过往对话，(2) 回顾工作进度，(3) 导入历史上下文到当前会话。NOT for: 需要浏览器自动化或外部 API 的会话管理。

Security Scan

The skill's requests and instructions match its stated purpose: it only documents using internal sessions_* tools to list, read, and re-send session history and has no installs, credentials, or unexpected external calls.

Purpose & Capability

Name/description align with required actions: listing sessions, retrieving history, and sending/importing messages via sessions_list, sessions_history, and sessions_send. The declared capabilities map directly to the commands shown in SKILL.md and README.

Instruction Scope

SKILL.md confines runtime instructions to OpenClaw session management tools (sessions_list, sessions_history, sessions_send, session_status, sessions_spawn). Example scripts write history to local files and show sending history to other sessions; there are no instructions to call external APIs, read unrelated system files, or exfiltrate credentials. It does mention related tools like read and memory_get, but they are listed as related rather than being required runtime actions.

Install Mechanism

Instruction-only skill with no install spec and no code files—nothing is downloaded or written by an installer. Low installation risk.

Credentials

The skill declares no environment variables, credentials, or config paths. The operations shown are proportional to the purpose. Note: session content itself may contain sensitive data even though the skill requires no secrets.

Persistence & Privilege

always is false and the skill does not request persistent/system-wide changes. It uses normal session-management tools and does not attempt to modify other skills or global agent configuration.

Assessment

This skill is coherent and appears safe in structure: it only documents using OpenClaw's session tools to list, read, and resend session history. Before installing or invoking it, be aware that session histories can contain sensitive information; using sessions_send can forward such content into other sessions or channels (including group or channel sessions). Confirm that the agent/account running this skill has appropriate access controls and retention policies, and test its behavior in a sandbox or with non-sensitive sessions first. If you want extra caution, verify that the platform will not auto-share exported history to external integrations (e.g., Slack/Discord) unless you intend that.

Session History Retriever 技能

使用 OpenClaw 的会话管理工具查看历史对话、检索消息，并引用导入到本地对话中。

核心功能

这个技能帮你：

• 🔍 查找会话：列出所有会话，按时间、活跃度筛选
• 📖 查看历史：获取特定会话的完整消息历史
• 📤 引用导入：将历史内容发送到新会话或当前会话
• 🎯 快捷对话：基于历史上下文快速继续工作

When to Use

✅ 使用这个技能当：

• 需要查看昨天的工作记录
• 想回顾之前的对话内容
• 需要导入历史上下文继续工作
• 查找特定会话的消息
• 审计会话使用情况
• 恢复中断的工作流

When NOT to Use

❌ 不要使用这个技能当：

• 需要浏览器自动化（用 browser 工具）
• 需要外部 API 调用（用其他技能）
• 只是闲聊不需要历史记录
• 需要创建新会话（用 sessions_spawn）

会话列表

列出所有会话

# 列出最近的会话
sessions_list --limit 20

# 筛选活跃会话（最后活跃 N 分钟）
sessions_list --activeMinutes 60 --limit 10

# 筛选特定类型的会话
sessions_list --kinds ["acp", "subagent"] --limit 15

会话列表输出示例

{
  "count": 1,
  "sessions": [
    {
      "key": "agent:main:main",
      "kind": "other",
      "channel": "webchat",
      "updatedAt": 1773620866778,
      "sessionId": "22e7d1aa-7f9d-4d7e-9bed-821466ed8d51",
      "model": "Qwen3.5-9B-Q8_0.gguf",
      "contextTokens": 160000
    }
  ]
}

关键字段：

• key: 会话键（如 agent:main:main）
• sessionId: 当前 transcript ID
• updatedAt: 最后更新时间
• contextTokens: 当前上下文 token 数

查看会话历史

获取完整历史

# 获取会话历史（最多 N 条消息）
sessions_history --sessionKey agent:main:main --limit 50

# 包含工具调用信息
sessions_history --sessionKey agent:main:main --limit 30 --includeTools=true

历史输出结构

{
  "sessionKey": "agent:main:main",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "昨天的文章写好了吗？"
        }
      ],
      "timestamp": 1773619868563
    },
    {
      "role": "assistant",
      "content": [
        {
          "type": "text",
          "text": "好的，我找到了文章..."
        }
      ],
      "timestamp": 1773619927993
    }
  ],
  "truncated": true
}

引用导入到对话

发送消息到新会话

# 向特定会话发送消息
sessions_send --sessionKey agent:main:main --message "基于之前的讨论，继续..."

# 使用标签引用
sessions_send --label "昨天的工作" --message "继续昨天的文章审查工作"

发送消息参数

• sessionKey: 目标会话键（如 agent:main:main）
• label: 会话标签（用于识别）
• message: 要发送的消息内容
• agentId: 目标 agent ID（可选）
• timeoutSeconds: 超时时间（秒）

常用工作流程

1. 回顾昨天的工作

# 第一步：列出会话
sessions_list --limit 10

# 第二步：找到昨天的会话（通过 updatedAt 时间）
# 第三步：获取历史
sessions_history --sessionKey agent:main:main --limit 50

# 第四步：分析内容，找到相关工作
# 第五步：发送新消息继续
sessions_send --sessionKey agent:main:main --message "根据昨天的审查结果，继续修改..."

2. 跨会话引用

# 从旧会话提取信息
history=$(sessions_history --sessionKey agent:main:main --limit 20)

# 发送到新会话
sessions_send --label "历史参考" --message "以下是之前讨论的内容..." "$history"

3. 会话审计

# 列出所有活跃会话
sessions_list --activeMinutes 1440 --json

# 检查特定会话的 token 使用情况
sessions_status --sessionKey agent:main:main

# 查看模型使用情况
session_status --sessionKey agent:main:main

会话键识别

主会话（直接聊天）

agent:<agentId>:main

群组会话

agent:<agentId>:channel:group:<id>

频道会话（Discord/Slack）

agent:<agentId>:channel:channel:<id>

定时任务

cron:<job.id>

节点运行

node-<nodeId>

会话状态检查

检查会话状态

session_status --sessionKey agent:main:main

# 输出示例
{
  "key": "agent:main:main",
  "model": "Qwen3.5-9B-Q8_0.gguf",
  "contextTokens": 160000,
  "inputTokens": 45000,
  "outputTokens": 12000,
  "totalTokens": 57000,
  "updatedAt": 1773620866778
}

实用脚本示例

查找最近 N 天的会话

#!/bin/bash
# 查找 7 天内活跃的会话
sessions_list --activeMinutes 10080 --limit 20 --json | \
  jq '.sessions[] | "\(.key): \(.updatedAt | fromdateiso8601)"'

导出会话历史为文件

#!/bin/bash
# 导出会话历史到文件
HISTORY_FILE="session_history_$(date +%Y%m%d).json"
sessions_history --sessionKey agent:main:main --limit 100 > "$HISTORY_FILE"
echo "已保存至：$HISTORY_FILE"

快速继续中断的工作

#!/bin/bash
# 1. 列出会话
echo "📋 可用会话："
sessions_list --limit 10 --json

# 2. 选择会话后继续
echo "继续工作..."
sessions_send --sessionKey agent:main:main --message "继续昨天的文章修改工作..."

常见问题

Q: 如何找到昨天的会话？

A: 查看 updatedAt 时间戳，昨天的会话会在时间上接近但早于今天。

Q: 会话历史被截断怎么办？

A: 使用更大的 limit 值，如 --limit 200。如果仍然被截断，说明会话很长，可能需要分次查看。

Q: 如何在多个会话间切换？

A: 使用 sessionKey 指定目标会话，或在新会话中引用旧会话的内容。

Q: 如何知道会话使用了多少 token？

A: 使用 session_status --sessionKey <key> 查看详细的 token 使用情况。

Q: 会话超过上下文限制怎么办？

A: 发送 /compact 命令让系统自动压缩旧对话，或使用 sessions_send 选择性地导入关键内容。

最佳实践

1. 定期整理：定期清理不活跃的会话
2. 合理使用：不要导入过长的历史，只引用相关内容
3. 标注清晰：使用 label 参数给会话添加描述性标签
4. 及时保存：重要工作完成后，导出或保存到记忆文件
5. 注意隐私：不要将敏感内容发送到新的会话

相关工具

• sessions_spawn - 创建新会话
• session_status - 查看会话状态
• memory_get - 读取记忆文件
• read - 读取本地文件

示例：完整工作流程

# 场景：想继续昨天的文章审查工作

# 1. 查看有哪些会话
sessions_list --limit 10

# 2. 查看主要会话的历史
sessions_history --sessionKey agent:main:main --limit 50

# 3. 找到昨天关于文章审查的讨论
# （搜索关键词如"审查"、"文章"、"修改"）

# 4. 基于上下文继续工作
sessions_send --sessionKey agent:main:main --message \
  "根据昨天审查的结果，我发现了以下问题需要修改：\n1. 导入语句不完整\n2. User-Agent 字符串有省略号\n3. 代码缩进需要统一\n\n请帮我生成修改后的版本..."

# 5. 或者创建新会话继续
sessions_spawn --task "继续修改浏览器搜索技能文章，基于昨天的审查报告" \
  --label "文章修改工作"

---

提示：记住，会话历史是工作记忆的重要组成部分。定期回顾和引用历史，可以让你的工作流程更加连贯高效！📚✨