技能管理

宗旨 2：通过团队协作策展并贡献高质量技能。

AcaClaw 提供一套经策展的学术技能 — 由团队共同筛选、测试与维护。每项技能都会发布到 ClawHub，使整个 OpenClaw 生态受益。

目录

• 技能分层
• 技能存放位置
• 技能界面（UI）
• 技能如何被选中
• 扩展生态，避免分叉
• 依靠团队，而非个人英雄主义
• 管理官方技能
• 策展 ClawHub 技能
• 致谢贡献者
• 贡献新技能
• 同步 GitHub 与 acaclaw.com

技能分层

AcaClaw 将技能分为三个层级。每层用途不同。

基础技能（随 OpenClaw 捆绑）

这些技能随 OpenClaw 发布，是 AcaClaw 智能体的必要技能。AcaClaw 直接继承 — 无需单独安装。

筛选规则：AcaClaw 从不替换或覆盖基础技能。OpenClaw 自带的，我们就使用。

核心学术技能（跨学科）

建议每位研究者无论学科都安装的跨学科技能。在 Staff 面板中列出，可分配给任意职员。所有技能均已在 ClawHub 上验证。

筛选规则：同一用途只保留最佳工具。只有在 ClawHub 上已验证的技能才会被列入。

社区技能（ClawHub）

由更广泛的 OpenClaw 社区在 ClawHub 上发布的技能。用户可通过 Staff 面板或 clawhub install <skill> 按需安装。

AcaClaw 不捆绑社区技能，但在 acaclaw.com/hub 维护推荐列表 — 参见 策展 ClawHub 技能。

技能存放位置

技能存储在 AcaClaw 网关的工作目录中。AcaClaw 使用 ~/.openclaw/ 作为主目录，因此从 ClawHub 安装的托管技能会存放到：

~/.openclaw/skills/<skill-name>/

存储路径

网关按以下优先级扫描目录（后者覆盖前者）：

对 AcaClaw 的含义

• 通过 Staff 面板或 clawhub install 安装的技能会存入 ~/.openclaw/skills/
• 基础技能（捆绑）不会写入磁盘 — 始终从 OpenClaw 包中加载
• 若仅为 AcaClaw 覆盖某项技能，请放在 ~/AcaClaw/skills/<skill>/（工作区级覆盖）

技能界面（UI）{#skills-ui}

AcaClaw 桌面界面在两处呈现技能：技能视图与 Staff 面板。

技能视图（#skills）

已安装标签页操作：

页脚实时显示计数：N 已安装 · N 捆绑 · N 可用。

Staff 面板（技能标签页）

从 Staff 视图打开：点击职员卡片 → 选择「技能」标签。

「+ 添加」与「安装」的区别：

Staff 网格中的卡片始终显示已分配技能的正确数量，面板头部显示当前已安装网关技能的数量。

技能如何被选中

AcaClaw 收录的每项技能都必须通过相同的筛选标准：

我们有意排除的内容

决策流程

1. 明确需求 — 当前技能尚未覆盖的真实研究任务
2. 调研现有方案 — 查阅 ClawHub、既有工具与社区诉求
3. 选定最佳候选 — 按上述标准评估
4. 在环境中测试 — 确认依赖与其他已收录技能无冲突
5. 团队评审 — 至少一名审阅者、一名测试者，并完成安全检查
6. 发布与交付 — 先上 ClawHub，再更新 skills.json

扩展生态，避免分叉

这是核心原则。AcaClaw 向 ClawHub 贡献 — 从不另建平行生态。

为何重要

• 对用户：在 AcaClaw 与原版 OpenClaw 间切换顺畅，技能处处可用。
• 对贡献者：你的技能触达整个 OpenClaw 用户群，而非仅 AcaClaw 用户。
• 对生态：单一注册表、单一格式、单一社区，避免碎片化。

准则

若是技能，就上 ClawHub。若是插件，就上 npm。若是配置变更，就进 openclaw.json。AcaClaw 不维护本应属于上游的内容。

依靠团队，而非个人英雄主义

AcaClaw 的技能由团队共建，而非个人单打独斗。每项技能都有多名贡献者，分工明确。

为何需要团队？

团队角色

最低团队规模

技能在发布前须至少具备：

• 1 名创建者
• 1 名审阅者（须为不同人员）
• 1 名测试者（可与审阅者为同一人）

从而确保没有任何技能未经第二双眼睛就上线。

管理官方技能

AcaClaw 使用来自 ClawHub 的已验证技能。当前跨学科技能列表由主 acaclaw 仓库中的 skills.json 和 UI 源码中的 AVAILABLE_SKILLS 共同维护。

skills.json

仓库根目录的 skills.json 定义了智能体必需技能（始终安装且不可移除）：

{
  "agent_required": [
    { "name": "nano-pdf" },
    { "name": "xurl" },
    { "name": "summarize" },
    { "name": "humanizer" }
  ]
}

测试

所有托管技能均通过 tests/ 目录中的测试套件验证：

维护工作流

1. OpenClaw 发布新版本 → 运行 pnpm test 验证
2. ClawHub 技能消失或更名 → 更新 ui/src/views/staff.ts 中的 AVAILABLE_SKILLS 以及 ui/src/views/skills.ts 中的 CURATED_SKILLS
3. 新增技能 → 确认其在 ClawHub 上存在后，加入 AVAILABLE_SKILLS，并用 Playwright 测试
4. 技能名不一致 → 同步更新 skills.json 中的 agent_required 与 skills.ts 中的 AGENT_REQUIRED_SKILLS

版本固定

AcaClaw 始终通过以下命令安装 ClawHub 托管技能的最新版本：

clawhub --workdir ~/.openclaw --no-input install --force <skill>

install.sh 脚本在全新安装时固定核心技能：

CORE_SKILLS=("nano-pdf" "xurl" "summarize" "humanizer")

策展 ClawHub 技能

除官方 AcaClaw 技能外，社区也会在 ClawHub 发布技能。AcaClaw 会策展其中的佼佼者。

策展的含义

策展标准

当社区技能满足以下条件时，可获得 AcaClaw 推荐：

acaclaw.com 上的推荐技能

acaclaw.com/hub 展示：

• 官方技能 — 由 AcaClaw 团队构建并发布到 ClawHub
• 推荐技能 — 经 AcaClaw 审核的社区技能（带「Community」徽章）
• 安装说明 — 一键安装或 clawhub install <skill>
• 作者与贡献者署名 — 链接到 ClawHub 个人主页

致谢贡献者

每一次贡献都有记录。每一位贡献者都会署名。

署名出现位置

署名格式

每项技能的 SKILL.md 或 README.md 包含：

## Contributors

| Contributor | Role | Profile |
|---|---|---|
| @alice | Creator | [clawhub.ai/alice](https://clawhub.ai/alice) |
| @bob | Tester, Debugger | [clawhub.ai/bob](https://clawhub.ai/bob) |
| @carol | Reviewer | [clawhub.ai/carol](https://clawhub.ai/carol) |
| @dan | Maintainer | [clawhub.ai/dan](https://clawhub.ai/dan) |
| @eve | Documenter | [clawhub.ai/eve](https://clawhub.ai/eve) |

规则

• 每位贡献者均予署名 — 不设「贡献太小」门槛
• 角色可叠加 — 同一人可兼任多职
• Git 历史为最终依据 — 只要提交过代码即予署名
• 贡献者不会被除名，即使不再参与
• Creator 角色仅可由原始技能作者担任

贡献新技能

贡献新技能有两条路径：通过 GitHub（面向开发者）与通过 acaclaw.com（面向偏好网页的研究者）。

路径 1：GitHub（acaclaw-skills 仓库）

熟悉 Git 与代码的贡献者：

1. 查重 — 检索 ClawHub 与既有 acaclaw-skills issue
2. 开 issue — 描述技能、目标用户与预期依赖
3. Fork 仓库 — github.com/acaclaw/acaclaw-skills
4. 创建技能：

   disciplines/your-field/
   ├── SKILL.md              ← 遵循 ClawHub SKILL.md 格式
   ├── your-skill.test.ts    ← 测试
   └── README.md             ← 使用说明 + Contributors 表
   

5. 声明依赖 — 仅在 PR 说明与 skills.json 中列出技能实际 import 的包
6. 运行环境检查 — scripts/env-check.sh 确认无冲突
7. 开 PR — 填写 PR 模板；你将作为 Creator 被署名
8. 团队评审 — 审阅、测试与安全检查须全部通过
9. 合并并发布 — CI 发布到 ClawHub；更新 skills.json

路径 2：acaclaw.com（网页提交）

不愿使用 Git 的研究者：

1. 访问 acaclaw.com/submit
2. 填写技能提交表单：
   • 名称 — 简短、具描述性（例如 gel-analyzer）
   • 描述 — 技能做什么、面向谁
   • 学科 — 服务的领域
   • SKILL.md 内容 — 粘贴或上传技能定义
   • 依赖 — 技能所需的 Python/R 等包
   • 你的信息 — 姓名、邮箱、ClawHub 主页（用于署名）
3. AcaClaw 团队成员将你的提交转为 acaclaw-skills 上的 PR
4. 你在技能的 Contributors 表中被署名为 Creator
5. 团队审阅、测试并发布到 ClawHub

如何选择路径？

质量门禁

任何技能在发布前必须通过全部门禁：

任一门禁未通过则不予发布。 贡献者会收到反馈并可持续修订。

同步 GitHub 与 acaclaw.com

acaclaw-skills GitHub 仓库是唯一可信来源。网站反映仓库内容 — 绝不会反过来。

同步如何运作

                   ┌─────────────────────────────┐
                   │   acaclaw-skills (GitHub)    │
                   │   Source of truth for all    │
                   │   skill code and metadata    │
                   └────────────┬────────────────┘
                                │
                    PR merged → CI runs
                                │
              ┌─────────────────┼─────────────────┐
              │                 │                   │
              ▼                 ▼                   ▼
     ┌────────────────┐ ┌──────────────┐  ┌────────────────┐
     │   ClawHub       │ │ acaclaw.com  │  │ acaclaw repo   │
     │   (publish)     │ │ /hub (build) │  │ skills.json    │
     │                 │ │              │  │ (pin version)  │
     └────────────────┘ └──────────────┘  └────────────────┘

流程

规则

• GitHub 为权威 — 所有技能代码、测试与元数据均在 acaclaw-skills 仓库
• 网站为视图 — acaclaw.com/hub 从 GitHub 读取；网站上的编辑会生成 PR，而非直接改库
• ClawHub 为注册表 — 技能从 ClawHub 安装，而非直接从 GitHub 或 acaclaw.com
• 版本固定明确 — acaclaw 仓库中的 skills.json 固定各发行版附带的确切版本
• 无手动部署 — CI 自动处理发布与网站重建

网页提交流程

当研究者通过 acaclaw.com/submit 提交技能时：

1. 提交保存为草稿
2. AcaClaw 团队成员审阅草稿
3. 若采纳，由团队成员在 acaclaw-skills 上创建含技能内容的 PR
4. 执行标准 PR 审阅流程
5. 贡献者署名为 Creator
6. 合并后技能出现在 acaclaw.com/hub

这样既保持 GitHub 仓库为单一可信来源，又让非开发者也能参与贡献。