Lossless Claw Skill
Skill completo para el plugin lossless-claw de OpenClaw. Este skill proporciona las instrucciones para instalar el plugin y luego usar las herramientas LCM.
⚠️ PRIMERO: Instalar el Plugin
Este skill detecta si el plugin está instalado y te guiará para instalarlo.
Instalación automática:
Cuando un agente lee este skill, debe verificar e instalar el plugin:
CODEBLOCK0
Flujo automático del agente:
- 1. Agente lee este skill → Detecta que necesita el plugin
- Agente verifica → INLINECODE0
- Si no está → Ofrece instalar: "Veo este skill pero falta el plugin. ¿Instalo?"
- Usuario acepta → INLINECODE1
- Restart gateway → INLINECODE2
- ✅ Listo → Herramientas
lcm_* disponibles
Instalación manual (si el agente no la ofrece):
Paso 1: Instalar el plugin (infraestructura)
CODEBLOCK1
Paso 2: Verificar instalación
CODEBLOCK2
Paso 3: Restart gateway
openclaw gateway restart
Descripción
Este skill es un wrapper seguro para el plugin lossless-claw de OpenClaw. El plugin YA está instalado y proporcionando las herramientas lcm_grep, lcm_describe, y lcm_expand_query.
Propósito: Proporcionar una interfaz de usuario amigable para usar las herramientas LCM sin necesidad de recordar comandos complejos.
¿Qué es LCM?
Lossless Context Management (LCM) reemplaza el truncamiento de conversaciones antiguas con un sistema de resúmenes jerárquicos (DAG):
- - ✅ Todos los mensajes se guardan en SQLite
- ✅ Resúmenes inteligentes de conversaciones antiguas
- ✅ Búsqueda completa en todo el historial
- ✅ Expansión bajo demanda - recupero detalles cuando necesito
Uso
1. Buscar en el historial
CODEBLOCK4
Ejemplos:
- -
lcm_grep "Stripe" --limit 5 - Buscar menciones de Stripe - INLINECODE9 - Buscar conversaciones sobre deploys
- INLINECODE10 - Búsqueda con regex
2. Inspeccionar un resumen
CODEBLOCK5
Ejemplos:
- -
lcm_describe --id sum_abc123 - Ver detalles de un resumen específico - INLINECODE12 - Ver archivo grande almacenado
3. Expansión profunda (deep recall)
CODEBLOCK6
Ejemplos:
- - INLINECODE13
- INLINECODE14
- INLINECODE15
Comandos Disponibles
| Comando | Descripción |
|---|
| INLINECODE16 | Buscar en todo el historial de conversaciones |
| INLINECODE17 |
Inspeccionar un resumen o archivo específico |
|
lcm_expand | Expandir un resumen para ver detalles |
|
lcm_expand_query | Responder pregunta usando contexto expandido |
Configuración Actual
El plugin está configurado con:
CODEBLOCK7
Significado:
- -
freshTailCount: 64 - Últimos 64 mensajes sin resumir - INLINECODE21 - Compacta al 75% del contexto
- INLINECODE22 - Máximo tokens por chunk antes de resumir
Estado del Plugin
Para verificar el estado:
CODEBLOCK8
Deberías ver:
Lossless Context Management | lossless-claw | loaded | 0.5.3
Base de Datos
Ubicación: INLINECODE23
Tamaño típico: ~160KB después de varias conversaciones
Verificar:
ls -la /mnt/data/openclaw/workspace/.openclaw/lcm.db
Troubleshooting
Error: "lcm_grep no encontrado"
Causa: El plugin no está cargado
Solución:
CODEBLOCK11
Error: "No conversation found"
Causa: No hay historial compactado aún
Solución: Esperar a que la conversación crezca y trigger compactación
Búsqueda lenta
Solución: Habilitar FTS5 (full-text search):
openclaw lcm fts5 enable
Sesiones de Larga Duración
El plugin está configurado para mantener sesiones vivas por 7 días (10080 minutos).
Cambiar duración:
{
"session": {
"reset": {
"mode": "idle",
"idleMinutes": 43200 // 30 días
}
}
}
Seguridad
Este skill es solo un wrapper - no ejecuta código, solo documenta cómo usar las herramientas LCM que ya están disponibles.
El plugin lossless-claw:
- - ✅ Código auditado (open source en GitHub)
- ✅ Datos locales (SQLite en tu máquina)
- ✅ Sin llamadas externas
- ✅ Sin credenciales requeridas
Referencias
- - GitHub: https://github.com/Martian-Engineering/lossless-claw
- Documentación: https://losslesscontext.ai
- LCM Paper: https://papers.voltropy.com/LCM
Changelog
v1.0.0 (2026-04-01)
- - Creación del skill wrapper
- Documentación de herramientas LCM
- Guía de troubleshooting
- Referencias de seguridad
License
MIT License - Libre uso, modificación y redistribución.
技能名称:lossless-claw-skill
详细描述:
Lossless Claw Skill
适用于OpenClaw插件lossless-claw的完整技能。此技能提供安装插件的说明,然后使用LCM工具。
⚠️ 首先:安装插件
此技能会检测插件是否已安装,并引导您进行安装。
自动安装:
当代理读取此技能时,必须检查并安装插件:
bash
检查插件是否已安装
openclaw plugins list | grep lossless-claw
如果未安装 → 进行安装
openclaw plugins install @martian-engineering/lossless-claw
代理自动流程:
- 1. 代理读取此技能 → 检测到需要该插件
- 代理检查 → openclaw plugins list
- 如果未安装 → 提供安装提示:我看到此技能但缺少插件。是否安装?
- 用户同意 → openclaw plugins install @martian-engineering/lossless-claw
- 重启网关 → openclaw gateway restart
- ✅ 完成 → lcm_* 工具可用
手动安装(如果代理未提供):
步骤1:安装插件(基础设施)
bash
openclaw plugins install @martian-engineering/lossless-claw
步骤2:验证安装
bash
openclaw plugins list
应看到:lossless-claw | loaded | 0.5.3
步骤3:重启网关
bash
openclaw gateway restart
描述
此技能是OpenClaw插件lossless-claw的安全包装器。该插件已安装并提供lcmgrep、lcmdescribe和lcmexpandquery工具。
目的: 提供友好的用户界面,无需记住复杂命令即可使用LCM工具。
什么是LCM?
无损上下文管理(LCM) 用层次化摘要系统(DAG)取代旧对话的截断:
- - ✅ 所有消息 保存在SQLite中
- ✅ 智能摘要 旧对话
- ✅ 全文搜索 整个历史记录
- ✅ 按需扩展 - 需要时恢复详细信息
使用方法
1. 搜索历史记录
lcm_grep 搜索词 --limit 10
示例:
- - lcmgrep Stripe --limit 5 - 搜索提及Stripe的内容
- lcmgrep deploy --limit 10 - 搜索关于部署的对话
- lcm_grep vercel.*token --mode regex - 使用正则表达式搜索
2. 检查摘要
lcmdescribe --id sumxxx
示例:
- - lcmdescribe --id sumabc123 - 查看特定摘要的详细信息
- lcmdescribe --id filexyz789 - 查看存储的大文件
3. 深度扩展(深度回忆)
lcmexpandquery --query 我们对Vercel做出了哪些决定?
示例:
- - lcmexpandquery --query 我们集成了哪些API?
- lcmexpandquery --query 项目状态如何?
- lcmexpandquery --prompt 总结定价决策
可用命令
| 命令 | 描述 |
|---|
| lcmgrep | 搜索整个对话历史 |
| lcmdescribe |
检查特定摘要或文件 |
| lcm_expand | 展开摘要以查看详细信息 |
| lcm
expandquery | 使用扩展上下文回答问题 |
当前配置
插件配置如下:
json
{
freshTailCount: 64,
leafChunkTokens: 80000,
contextThreshold: 0.75,
incrementalMaxDepth: 1,
summaryModel: gensee-397b/Gensee/Qwen3.5-397B
}
含义:
- - freshTailCount: 64 - 最近64条消息未摘要
- contextThreshold: 0.75 - 压缩至上下文的75%
- leafChunkTokens: 80000 - 每个块在摘要前的最大令牌数
插件状态
检查状态:
bash
openclaw plugins list
应看到:
Lossless Context Management | lossless-claw | loaded | 0.5.3
数据库
位置: /mnt/data/openclaw/workspace/.openclaw/lcm.db
典型大小: 多次对话后约160KB
检查:
bash
ls -la /mnt/data/openclaw/workspace/.openclaw/lcm.db
故障排除
错误:未找到lcm_grep
原因: 插件未加载
解决方案:
bash
openclaw gateway restart
错误:未找到对话
原因: 尚无压缩的历史记录
解决方案: 等待对话增长并触发压缩
搜索缓慢
解决方案: 启用FTS5(全文搜索):
bash
openclaw lcm fts5 enable
长会话
插件配置为保持会话存活7天(10080分钟)。
更改时长:
json
{
session: {
reset: {
mode: idle,
idleMinutes: 43200 // 30天
}
}
}
安全性
此技能仅为包装器 - 不执行代码,仅记录如何使用已可用的LCM工具。
lossless-claw插件:
- - ✅ 代码已审计(GitHub开源)
- ✅ 本地数据(您机器上的SQLite)
- ✅ 无外部调用
- ✅ 无需凭据
参考
- - GitHub: https://github.com/Martian-Engineering/lossless-claw
- 文档: https://losslesscontext.ai
- LCM论文: https://papers.voltropy.com/LCM
更新日志
v1.0.0(2026-04-01)
- - 创建技能包装器
- LCM工具文档
- 故障排除指南
- 安全参考
许可证
MIT许可证 - 可自由使用、修改和重新分发。