AMAP-ML/SkillClaw

SkillClaw – LLM代理人的集体技能进化

是什么 – SkillClaw 是一个位于基于 LLM 的代理（例如 Hermes、Codex、Claude Code、QwenPaw、OpenClaw 等）与 LLM API 之间的开源系统。它记录每一次交互，提取 技能（可重用的代码片段、提示或知识），去重并持续优化。结果是，随着你和你的团队成员使用代理，一个共享的技能库会自动增长。

为何重要 – 现代 LLM 代理常常积累临时的“知识”却从未被复用。SkillClaw 将这种偶然学习转化为结构化、版本化的技能存储，可共享于：

• 同一机器上的多个代理，
• 不同设备上的同一代理，
• 共同项目的整个团队。

核心组件

组件	作用
客户端代理 (skillclaw)	一个本地 HTTP 代理，模拟 OpenAI /v1/chat/completions 端点。它拦截请求，记录会话产物，并向代理提供当前技能库。
进化服务器 (skillclaw-evolve-server)	可选的后台服务，读取已记录的会话，运行三阶段 LLM 流水线（总结 → 聚合 → 执行）或 OpenClaw 驱动的代理工作区，并写回更新后的 SKILL.md 文件。
存储层	文件系统、阿里云 OSS 或 S3。客户端和服务器仅通过此共享存储通信，使部署灵活（仅本地、远程 VM 或云存储桶）。

如何使用

1. 安装 – macOS/Linux 一键安装（bash scripts/install_skillclaw.sh）或 Windows 手动 pip -e 安装。
2. 配置 – 运行 skillclaw setup；向导会询问你的 LLM 提供商、模型、技能存储位置，以及（可选）要自动配置的代理（Hermes、Codex 等）。
3. 启动代理 – skillclaw start --daemon。代理默认监听端口 30000，并将代理配置重写为指向 http://127.0.0.1:30000。
4. 正常聊天 – 你的代理通过代理与 LLM 通信；SkillClaw 静默记录会话并更新本地技能目录。
5. （可选）运行进化服务器 – skillclaw-evolve-server --use-skillclaw-config …，自动将记录的会话转化为优化后的技能。对于团队，运行一个服务器，所有客户端指向同一 OSS/S3 存储桶即可。

核心特性

• 零成本进化 – 初始设置后无需额外命令；技能在后台自动提升。
• 自动去重与版本控制 – 相同或重叠的技能被合并，每个版本以 SKILL.md 存储并附带变更日志。
• 广泛代理兼容 – 原生支持 Hermes、OpenClaw、QwenPaw、IronClaw、PicoClaw、ZeroClaw、Codex、Claude Code，以及所有 OpenAI 兼容 API。
• 跨设备与跨用户共享 – 将技能库存储在 OSS/S3（或共享本地文件夹）中，使知识可随你从家到办公室，并在团队中聚合共享。
• 仪表板 – skillclaw dashboard sync/serve 提供本地 Web UI，用于浏览技能、查看版本历史和检查会话追踪。
• 验证工作器 – 可选的后台验证器，在技能发布到共享存储前进行审查。
• 可扩展引擎 – workflow（固定 LLM 流水线）或 agent（OpenClaw 驱动的工作区）用于技能生成。

典型工作流

• 个人开发者：安装客户端，运行代理，可选启动本地进化服务器。每次聊天后，个人技能库变得更智能。
• 工程师团队：在云虚拟机上运行一个进化服务器，所有成员将客户端指向同一 OSS 存储桶。当 Alice 解决部署问题时，生成的技能会立即对 Bob、Carol 等人可用。
• 多代理设置：运行 Hermes 处理前端 UI，Codex 生成代码，QwenPaw 进行数据分析；SkillClaw 合并各代理发现的技能，使前端能受益于后端洞察，反之亦然。

快速入门（macOS/Linux 单用户快速启动）

git clone https://github.com/AMAP-ML/SkillClaw.git && cd SkillClaw
bash scripts/install_skillclaw.sh
source .venv/bin/activate
skillclaw setup          # 回答提示（默认值适用于测试运行）
skillclaw start --daemon
# 验证代理健康状态
curl http://127.0.0.1:30000/healthz

现在运行任何支持的代理（例如 hermes chat -m skillclaw-model …），并观察 ~/.hermes/skills 下技能库的增长。

文档与社区

• 论文：arXiv 2604.08377（PDF 与 Hugging Face 摘要链接在徽章栏中）。
• 中文 README：assets/README_ZH.md。
• 微信群组 用于实时讨论（徽章链接）。
• 新闻 部分在 README 中追踪最新发布（如仪表板、Codex/Claude 集成、LongHorizon-Harness）。

许可证 – MIT，可自由嵌入商业或研究项目中。

---

以上所有信息均直接来自仓库的 README；未添加任何外部假设。