lossless-claw-enhanced 安装笔记
lossless-claw-enhanced 是一个 OpenClaw 的 context engine 插件，插件 id 是 lossless-claw。它的作用是替换默认的 legacy context engine，用 DAG 式摘要/压缩来管理上下文；这个增强版 fork 额外修复了 CJK token 估算偏低 的问题。
一、安装方式
仓库 README 给了两种安装方式。
1. link 模式，推荐
适合你后续还会继续改这个仓库源码。
git clone https://github.com/win4r/lossless-claw-enhanced.git
openclaw plugins install --link ./lossless-claw-enhanced
--link 模式会直接链接本地目录，因此你后面 git pull 或改代码后，OpenClaw 可以直接读取最新源码，不需要重新复制安装。OpenClaw 官方插件 CLI 也支持等价写法 -l。
也可以写成：
openclaw plugins install -l ./lossless-claw-enhanced
2. copy 模式
适合只想装一个当前快照版本。
git clone https://github.com/win4r/lossless-claw-enhanced.git
openclaw plugins install ./lossless-claw-enhanced
这种方式是拷贝安装；后续你本地仓库代码更新后，OpenClaw 里的插件不会自动跟着变，需要重新安装一次。
二、安装后必须做的配置
安装完成后，最关键的不是“插件装上了”，而是要把 context engine slot 切到这个插件。OpenClaw 官方插件文档说明，contextEngine 是一个 slot；如果不切换，系统仍会继续使用默认的 legacy。
把配置改成下面这样：
{
"plugins": {
"slots": {
"contextEngine": "lossless-claw"
},
"entries": {
"lossless-claw": {
"enabled": true,
"config": {
"freshTailCount": 32,
"contextThreshold": 0.75,
"incrementalMaxDepth": -1,
"ignoreSessionPatterns": [
"agent:*:cron:**",
"agent:*:subagent:**"
],
"summaryModel": "anthropic/claude-haiku-4-5"
}
}
}
}
}
这段配置来自该仓库 README，其中 contextEngine 指向的插件 id 就是 lossless-claw。
三、参数怎么理解
freshTailCount: 32 表示最近 32 条消息优先保留原文，不参与压缩。contextThreshold: 0.75 表示上下文接近模型窗口 75% 时触发 compaction。incrementalMaxDepth: -1 表示不限制递归压缩深度。ignoreSessionPatterns 用来排除某些 session，例如 cron agent 和 subagent。summaryModel 是执行摘要压缩时用的模型。以上字段都直接来自仓库 README 的推荐配置。
有一点要注意：README 说明了摘要模型有优先级，环境变量 LCM_SUMMARY_MODEL 会高于配置里的 summaryModel。也就是说，如果你环境里已经设过这个变量，配置文件里写的模型可能不会真正生效。
四、配置完成后要重启
改完插件配置后，重启 Gateway：
openclaw gateway restart
OpenClaw 官方插件文档说明，插件配置变更后需要 Gateway 重启；该仓库 README 也明确要求重启。
五、安装后验证
建议至少执行下面几条命令：
openclaw plugins list
openclaw plugins inspect lossless-claw
openclaw doctor
openclaw gateway status
plugins inspect lossless-claw 可以看插件是否被正确加载；openclaw doctor 是 OpenClaw 官方推荐的健康检查方式，特别适合确认 context engine 是否正常启用。官方 context engine 文档还特别提醒：如果 slot 指向的插件加载失败，系统不会自动回退到 legacy，而是会直接报错，所以这一步最好不要省。
六、推荐的最简执行流程
直接照这个顺序做就行：
git clone https://github.com/win4r/lossless-claw-enhanced.git
openclaw plugins install -l ./lossless-claw-enhanced
然后把配置改为：
{
"plugins": {
"slots": {
"contextEngine": "lossless-claw"
},
"entries": {
"lossless-claw": {
"enabled": true,
"config": {
"freshTailCount": 32,
"contextThreshold": 0.75,
"incrementalMaxDepth": -1,
"ignoreSessionPatterns": [
"agent:*:cron:**",
"agent:*:subagent:**"
],
"summaryModel": "anthropic/claude-haiku-4-5"
}
}
}
}
}
最后执行：
openclaw gateway restart
openclaw plugins inspect lossless-claw
openclaw doctor
这样就完成了 lossless-claw-enhanced 的安装与启用。
七、最容易踩的坑
最常见的坑只有三个：第一，插件装了但 没把 plugins.slots.contextEngine 切到 lossless-claw；第二，改完配置后 没重启 Gateway；第三，环境里已经设置了 LCM_SUMMARY_MODEL，结果覆盖了你配置文件里的 summaryModel。这几个点都能在仓库 README 和 OpenClaw 官方插件/engine 文档里对应上。
