技能介绍

要解决什么问题

在 OpenClaw 里，一次对话里跑通的工作流往往散落在工具调用与上下文里，很难沉淀成可复用的 SKILL.md。手工整理成本高，也容易漏掉「第二次验证才成立」的模式。skill-sediment 对应的是 OpenClaw 插件扩展（不是 MCP、也不是独立服务）：监听对话，把被判定为成功的流程写成技能草稿，再按规则晋升到正式技能目录。

技能如何工作

本技能提供 一次性安装器，把约 340KB 的 TypeScript 插件部署到工作区约定路径（assets/plugin-source/ 已内嵌源码，通常无需外网拉包）。安装流程会做环境检查、plugins.allow 白名单处理（多数情况下 allow 为空则无需改 openclaw.json）、以及可选的 validAgentId 限制。

插件侧机制要点：

触发：大约每 15 次工具调用会启动后台 review 子 Agent（nudgeInterval 可调）
输出路径：先写入 sediment_skills/*.md（待孵化），满足「二次命中」后晋升到 skills/*.md（已激活）
二次命中：不同父会话再次命中同一沉淀，或同一沉淀 ≥1 天且同会话再次命中
淘汰：10 天未动自动驱逐；每 Agent 最多 20 条；新沉淀有 3 天宽限期
不依赖向量检索：用 LLM 语义判断，不需要 embedding 模型

子命令覆盖全生命周期：doctor 诊断、status 查看沉淀池、heal 自修复白名单/文件丢失、recover 应对 Pod 重启或 PVC 置换等。开源版刻意省略 cron-setup，定时 heal 需自行接 cron / systemd / K8s CronJob。

适用边界与注意点

插件必须放在 工作区约定目录（PVC 挂载路径），不要放到 /app/extensions（容器层重启会丢）
托管环境（Lobi / Apollo）若 plugins.allow 非空且需写配置，安装器会检测信号并跳过本地写 openclaw.json，改走远程控制台
版本基线验证为 OpenClaw 2026.3.8；低于基线会拒绝安装（可用 --force-version 覆盖，但 API 风险自负）
doctor 能查文件与配置，钩子是否真正挂载仍以 gateway 日志为准；对话累计约 15 次工具调用后，status 应能看到 sediment_skills/ 下的待处理项
uninstall --purge 会删插件目录，但不会删除已经沉淀好的 SKILL.md

截图预览

使用场景

在 OpenClaw 多步工具调用对话里反复跑通同一编排，希望成功流程自动写入 `sediment_skills/` 并在二次命中后晋升到 `skills/`。
K8s 上 OpenClaw Pod 重启或 PVC 换卷后，需把插件部署到工作区约定目录并用 `recover`/`heal` 恢复白名单与文件。
托管 Pod（Lobi/Apollo）且 `plugins.allow` 非空时，需在跳过本地写 `openclaw.json` 的前提下完成插件落盘并按控制台补白名单。
只想对 `main` 或指定 Agent 启用沉淀，安装时配置 `validAgentId`，用 `status` 查看待孵化与已激活技能池。

适合人员

在 K8s 上维护 OpenClaw Gateway、要求插件落在 PVC 约定目录且重启后仍能 `doctor` 通过的集群运维。
在 Agent 里反复调试工具链，希望「第二次会话仍成立」的流程自动变成 `SKILL.md` 而非手写整理的 Agent 搭建者。
负责 clawbot 类托管实例、`openclaw.json` 由 Apollo 同步，只能本地落插件并靠 `config`/`doctor` 核对 allow 状态的平台工程师。
同一工作区启用多个 Agent ID，需要按 Agent 限制沉淀启用范围并关注每 Agent 最多 20 条沉淀配额的 OpenClaw 使用者。