← 返回 Skills 市场
session-compress
作者
ZZQSAMA066
· GitHub ↗
· v1.0.1
· MIT-0
103
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install session-compress
功能描述
Compress OpenClaw session .jsonl files by trimming old messages while preserving system messages, recent turns, and task-relevant context.
安全使用建议
This skill is instruction-only and does not include the PowerShell script it tells you to run. Before using it: 1) Verify that scripts/compress.ps1 actually exists on your system and inspect its contents line-by-line to ensure it only touches the intended session files and does not exfiltrate data or run network calls. 2) Back up any .jsonl files or use -OutputPath / DryRun as recommended. 3) Confirm <OPENCLAW_DIR> location and platform (instructions use PowerShell; they assume a Windows/PowerShell environment). 4) Be cautious about letting an agent execute these commands autonomously — prefer manual invocation until you’ve reviewed the script. If the skill came with the compress.ps1 content or a trusted install source (and you’ve audited the script), the incoherence is resolved and the risk drops.
功能分析
Type: OpenClaw Skill
Name: session-compress
Version: 1.0.1
The skill bundle describes a utility for compressing OpenClaw session files but relies on an external PowerShell script (scripts/compress.ps1) that is not included in the provided file set, preventing a full security audit of the actual execution logic. While the instructions in SKILL.md outline a logical workflow for trimming logs, the use of PowerShell to perform destructive file operations (overwriting .jsonl session history) on sensitive data constitutes a high-risk capability that cannot be verified as benign without the script's source code.
能力评估
Purpose & Capability
The skill's stated purpose (compress .jsonl session files) matches the instructions' goal, but it presumes the presence of a local PowerShell script (scripts/compress.ps1) and an <OPENCLAW_DIR> path. Because the skill includes no code or install spec, it cannot itself perform compression; it only documents how to run an external script that is not provided. That mismatch is an incoherence a user should confirm.
Instruction Scope
Instructions tell the operator/agent to list and modify files under <OPENCLAW_DIR>\agents\main\sessions\*.jsonl and to run powershell -File scripts/compress.ps1. These are narrowly scoped to main agent sessions (appropriate), but they instruct execution of an external PowerShell script whose content is unknown. The SKILL.md does not include the script contents, nor does it define how <OPENCLAW_DIR> is resolved — both gaps increase risk and ambiguity.
Install Mechanism
No install spec and no bundled code means nothing will be written to disk by installing the skill itself, which lowers risk. However, the runtime instructions rely on an external script rather than installing it.
Credentials
The skill does not request environment variables, credentials, or config paths. The only filesystem access referenced is the agent's session directory, which is proportional to the stated purpose.
Persistence & Privilege
The skill does not request persistent/always-on presence (always:false) and is user-invocable. It does allow the agent to invoke the instructions autonomously by default (disable-model-invocation:false), which is platform normal; combined with other issues this is worth noting but not flagged by itself.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install session-compress - 安装完成后，直接呼叫该 Skill 的名称或使用
/session-compress触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
- Documentation updated to use <OPENCLAW_DIR> as a placeholder for the directory path, replacing the previous user-specific example.
- Task relevance keywords in the compression logic now use English terms instead of Chinese.
- Minor improvements to clarity and instructions in the workflow and important notes.
- Removed references to a fixed session path; now specifies applicability to main agent session files in general.
v1.0.0
- Initial release of the session-compress skill for OpenClaw.
- Compresses session .jsonl files by trimming old messages, preserving active tasks and plans.
- Always keeps system messages and the most recent 30 turns (configurable).
- Task-relevant context is preserved using keyword matching.
- Non-essential message history is summarized to a single placeholder.
- Supports in-place compression or saving to a new file.
- Includes a safe dry run mode for previewing changes.
元数据
常见问题
session-compress 是什么？
Compress OpenClaw session .jsonl files by trimming old messages while preserving system messages, recent turns, and task-relevant context. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 103 次。
如何安装 session-compress？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install session-compress」即可一键安装，无需额外配置。
session-compress 是免费的吗？
是的，session-compress 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
session-compress 支持哪些平台？
session-compress 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 session-compress？
由 ZZQSAMA066（@zzqsama066）开发并维护，当前版本 v1.0.1。
推荐 Skills