claw-compactor

超长对话自动压缩,花小钱办大事不丢内容

面向 LLM 的 14 阶段融合式 Token 压缩流水线,支持可逆压缩、AST 感知的代码分析与智能内容路由,且完全无需 LLM 推理开销。在压缩上下文的同时尽量保留关键信息,可显著降低长会话中的 Token 消耗,MIT 许可、开箱即用。

开源 unknown 基础设施
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 2024
维护状态 低维护
是否开源 是
定价模式 unknown

项目数据

分类基础设施
开发团队open-compress
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai-agent-tools,ai-infrastructure,ast-code-analysis,claw-compactor,context-compression,context-pruning,context-window-optimization,developer-tools,fusion-pipeline,llm-compression,llm-context-compression,llm-cost-reduction,llm-token-compression,llm-tools,openclaw,prompt-compression,python,reversible-compression,token-compression,tree-sitter
GitHub 星标★ 2024
30天Star增速
HF 下载量
上线时间2026-02-10 00:00:00
最近更新2026-09-22 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数5

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 4 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Python 环境并已安装 pip(README 未标注具体版本要求)
  • 能访问 PyPI 的网络环境
  • 无需 LLM 推理服务或 API Key(README 标明 Zero LLM inference cost)

安装与启动步骤

  1. 1安装依赖包

    README 唯一给出的安装方式是 PyPI;建议在虚拟环境中执行,避免污染全局环境。

    pip install claw-compactor
  2. 2在代码中调用流水线

    README 的 Run 段仅展示调用后的打印语句,未给出完整调用代码,需自行构造输入并执行压缩流程。

    print(result["stats"]["reduction_pct"])
    print(result["per_message"])
  3. 3查看压缩结果

    运行后查看聚合压缩百分比与每条消息的压缩明细;跨消息去重会先执行,再走单条消息流水线。

  4. 4查阅官方文档

    README 节选缺少完整 API 与配置说明,如需高级用法请前往官方文档或 ARCHITECTURE.md 查看。

如何确认成功

执行 pip show claw-compactor 能显示包信息即安装成功;调用后打印出 reduction_pct 百分比与 per_message 明细即运行成功。

常见问题

Q:需要申请 LLM API Key 吗?

A:不需要。README 明确说明压缩过程零 LLM 推理成本(Zero LLM inference cost),不依赖任何模型调用。

Q:压缩率大概是多少?

A:README 标注为 15–82%,具体取决于输入内容类型与结构。

Q:压缩后内容还能还原吗?

A:支持可逆压缩(Reversible),可在需要时恢复原始内容。

Q:代码文件会被怎么处理?

A:流水线包含 AST 感知的代码分析阶段,并结合智能内容路由,共 14 个阶段融合处理。

Q:项目是否免费商用?

A:采用 MIT 许可,价格 0 USD,可自由使用与修改。

注意事项

  • README 节选被截断,未给出完整安装与运行示例,实际使用前请查阅官方文档 https://open-compress.github.io/claw-compactor
  • 当前材料未提供任何配置项、端口或环境变量说明,请勿臆造参数
  • README 提到项目含 1600+ 测试,可据此评估稳定性
  • 项目地址:https://github.com/open-compress/claw-compactor

核心亮点

  • 14阶段融合流水线设计,实现可逆压缩与AST感知代码分析,技术架构有深度
  • 零LLM推理成本,通过规则与算法压缩token,显著降低上下文窗口开销
  • MIT许可且支持智能内容路由,适合集成到现有AI工具链

不足之处

  • 文档/社区待观察

适用场景

  • 长上下文LLM应用的token预算优化
  • 代码库分析场景下的上下文精简与结构化提取
  • 边缘设备或成本敏感环境中的AI推理前置处理

替代项目

LLMLingua、LangChain Context Compression、txtai

项目介绍

claw-compactor 是基础设施领域的开源项目,由 open-compress 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(2,024)位列前 30%,在基础设施分类中处于中上游。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-22。从国内网络环境看,可直接访问。

它主要面向的使用场景是:长上下文LLM应用的token预算优化。同类可对比的替代方案包括 LLMLingua、LangChain Context Compression、txtai。

上一篇:semantica

下一篇:paritok-4b-v1

同类项目推荐

freebuff-proxy 开源

聚合多账号,一键接入 OpenAI 兼容 API,轻松管理会话。

Multi-account OpenAI-compatible gateway for coding models. Pooled keys, session life···

★ 213 2026-08-20
microduck 开源

用 Rust 造一只会走路的桌面小鸭,快速上手双足机器人。

A Tiny biped duck robot

★ 8684 2026-09-10
soperator 开源

用 Kubernetes 原生方式运行 Slurm,简化 HPC 集群管理。

Run Slurm in Kubernetes

★ 439 2026-08-10
ollama 开源

一条命令本地跑起大模型,免费、私密、不卡顿

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other···

★ 181484 2026-08-09