[CoPaw 教程系列] #05: Copaw Skills Overview
CoPaw 入门：Skills 能力系统概览
Skills 是 CoPaw 的核心能力扩展机制。CoPaw 的能力完全由启用的 Skills 决定——内置多类能力，你还可以添加自定义 Skill，或者直接从社区 Skills Hub 导入 Skills。
什么是 Skills？
Skills（技能）是 CoPaw 功能的模块化单元。每个 Skill 提供特定的能力，例如：
cron- 定时任务管理pdf- PDF 文档处理news- 新闻查询与摘要docx- Word 文档操作- ...
CoPaw 通过加载 Skills 来获得这些能力。你可以：
✅ 启用/禁用 Skills
- 控制哪些能力可用
✅ 导入社区 Skills
- 从 Skills Hub 获取更多能力
✅ 创建自定义 Skills
- 扩展 CoPaw 的能力
✅ 共享你的 Skills
- 与社区分享你的创建
Skills 工作原理
加载机制
CoPaw 从工作目录下的 skills 目录（默认 ~/.copaw/active_skills/
）加载能力：
~/.copaw/
├── active_skills/ # 实际激活的 Skills
│ ├── cron/
│ │ └── SKILL.md
│ ├── pdf/
│ │ └── SKILL.md
│ ├── docx/
│ │ └── SKILL.md
│ └── ...
├── customized_skills/ # 用户自定义 Skills
│ └── my_skill/
│ └── SKILL.md
└── ...
关键规则：
- 每个子目录中只要包含一份
SKILL.md，即会被识别为一个 Skill 并加载 - 无需额外注册，自动发现
- 启动时，内置 Skill 与
~/.copaw/customized_skills/中的自定义 Skill 会合并同步到~/.copaw/active_skills/ - 同名时，自定义 Skill 优先
SKILL.md 结构
每个 Skill 都有一个 SKILL.md
文件，包含：
---
name: skill_name
description: 简短描述
Skill 标题
功能说明
详细描述这个 Skill 的功能...
使用方法
如何使用这个 Skill...
注意事项
使用时需要注意的事项...
YAML front matter：
name- Skill 名称（必填）description- 简短描述（推荐）metadata- 其他元数据（可选）
Markdown 内容：
- 给 Agent 看的能力说明
- 使用注意
- 示例
管理 Skills
管理 Skill 有两种方式：
方式一：通过控制台
- 在控制台中进入 智能体 → 技能
- 可以：
- 查看当前已加载的 Skills 及启用状态
- 启用/禁用 某个 Skill（开关切换）
- 新建 自定义 Skill：填写名称与内容即可，无需手动建目录
- 编辑 已有 Skill 的名称或内容
- 导入 Skills Hub 中的 Skills
- 修改后会自动同步到工作目录并影响 Agent 行为
优点：
- 图形界面，操作直观
- 不需要命令行
- 适合不习惯直接改文件的用户
方式二：通过工作目录
- 进入
~/.copaw/customized_skills/目录 - 创建新的子目录和
SKILL.md文件 - 编写 Skill 内容
- 重启 CoPaw（或等待下次启动）即可加载
优点：
- 灵活自由
- 可以使用版本控制
- 适合开发者
内置 Skills 一览
CoPaw 内置了丰富的 Skills，安装后会在首次需要时同步到工作目录。
cron - 定时任务管理
功能： 定时任务管理。通过 copaw cron
或控制台 Cron Jobs 创建、查询、暂停、恢复、删除定时任务，按时间表执行并把结果发到频道。
常用操作：
# 创建任务
copaw cron create --type agent --name "xxx" --cron "0 9 *" ...
查看列表
copaw cron list
查看状态
copaw cron state <job_id>
使用场景：
- 每日提醒
- 定期摘要
- 自动报告
file_reader - 文件读取
功能：
读取与摘要文本类文件（如 .txt、.md、.json、.csv、.log、.py 等）。PDF 与 Office 由下方专用 Skill 处理。
使用示例：
帮我读取 README.md 的内容
分析这个 log 文件，找出错误信息
dingtalk_channel_connect - 钉钉频道接入
功能：
辅助完成钉钉频道接入流程：引导进入开发者后台、填写必要信息，帮助用户获取 Client ID 与 Client Secret，并提示用户完成必要的手动配置步骤。
使用方法：
帮我配置钉钉频道
himalaya - 邮件管理
功能：
通过 CLI 管理邮件（IMAP/SMTP）。使用 himalaya 列出、阅读、搜索、整理邮件，支持多账户与附件管理。
使用场景：
- 邮件摘要
- 自动回复
- 邮件分类
来源：
https://github.com/openclaw/openclaw/tree/main/skills/himalaya
news - 新闻查询
功能：
从指定新闻站点查询最新新闻，支持政治、财经、社会、国际、科技、体育、娱乐等分类，并做摘要。
使用示例：
帮我看看今天的科技新闻
有哪些财经新闻值得关注？
pdf - PDF 文档处理
功能：
PDF 相关操作：阅读、提取文字/表格、合并/拆分、旋转、水印、创建、填表、加密/解密、OCR 等。
使用示例：
读取这个 PDF 的内容
把这个 PDF 的前两页提取出来
给 PDF 添加水印
来源：https://github.com/anthropics/skills/tree/main/skills/pdf
docx - Word 文档处理
功能：Word 文档（.docx）的创建、阅读、编辑，含目录、页眉页脚、表格、图片、修订与批注等。
使用示例：
创建一个 Word 文档
帮我编辑这个文档，添加一个表格
把这篇文章转换成 Word 格式
来源：
https://github.com/anthropics/skills/tree/main/skills/docx
pptx - PPT 文档处理
功能：
PPT（.pptx）的创建、阅读、编辑，含模板、版式、备注与批注等。
使用示例：
创建一个演示文稿
把这份报告制作成 PPT
编辑这个 PPT，修改第 3 页的内容
来源：https://github.com/anthropics/skills/tree/main/skills/pptx
xlsx - 表格处理
功能：表格（.xlsx、.xlsm、.csv、.tsv）的读取、编辑、创建与格式整理，支持公式与数据分析。
使用示例：
读取这个 Excel 文件
分析这个表格的数据
把这些数据导出到 Excel
来源：
https://github.com/anthropics/skills/tree/main/skills/xlsx
browser_visible - 可见浏览器
功能：
以可见模式（headed）启动真实浏览器窗口，适用于演示、调试或需要人工参与（如登录、验证码）的场景。
使用场景：
- 自动化测试
- 数据抓取
- 表单填写
启用和禁用 Skills
通过控制台启用/禁用
- 进入控制台 智能体 → 技能
- 找到目标 Skill
- 点击底部的 启用 或 禁用 链接
- 修改立即生效
通过工作目录启用/禁用
- 编辑
~/.copaw/config.json - 在
skills配置中添加或删除 Skill 名称 - 重启 CoPaw
示例配置：
{
"skills": {
"enabled": [
"cron",
"pdf",
"docx",
"news",
"file_reader"
]
}
}
导入社区 Skills
CoPaw 支持从社区 Skills Hub 导入 Skills，扩展 CoPaw 的能力。
支持的 Skill URL
当前支持在控制台中导入以下 URL：
https://skills.sh/...https://clawhub.ai/...https://skillsmp.com/...https://lobehub.com/...https://market.lobehub.com/...（LobeHub 直链下载地址）https://github.com/...
导入步骤
- 打开控制台 智能体 → 技能，点击右上角 导入技能
- 在弹窗中粘贴 Skill URL（获取方式见下方「URL 获取示例」）
- 点击导入技能，等待导入完成
- 导入成功后，在技能列表中可以看到新加入的 Skill
URL 获取示例
从 skills.sh 获取（clawhub.ai、skillsmp.com 和 lobehub.com 获取方式相同）
- 进入对应技能市场页面（如 skills.sh）
- 选择你需要的 Skill（以
find-skills为例） - 点击最上方的 URL 并复制，即为导入 Skill 时需要的 Skill URL
从 LobeHub 获取
- 进入 LobeHub 技能市场
- 选择 Skill
- 复制 URL（支持
https://lobehub.com/...和https://market.lobehub.com/...两种格式）
从 GitHub 获取
- 进入包含
SKILL.md的页面（如 anthropics 的 skills 仓库中的skill-creator） - 复制最上方 URL 即可
导入说明
- 若同名 Skill 已存在，默认不会覆盖；建议先在列表中确认现有内容后再处理
- 导入失败时优先检查：
- URL 是否完整
- 来源域名是否受支持
- 外网是否可访问
- 若遇到 GitHub 限流，建议在控制台 设置 → 环境变量 中添加
GITHUB_TOKEN - 获取方式可参考 GitHub 官方文档：管理个人访问令牌（PAT）
创建自定义 Skills
想通过文件方式给 Agent 加自己的一套说明或能力时，可以在 customized_skills
目录下手动添加自定义 Skill。
创建步骤
1. 创建目录结构
cd ~/.copaw/customized_skills/
mkdir my_skill
cd my_skill
touch SKILL.md
2. 编写 SKILL.md
---
name: my_skill
description: 我的自定义能力说明
使用说明
本 Skill 用于...
功能
- 功能一
- 功能二
- 功能三
使用方法
在对话中直接使用即可...
注意事项
使用时注意...
3. 重启 CoPaw
# 停止 CoPaw
Ctrl+C
重新启动
copaw app
目录结构示例
~/.copaw/
├── active_skills/ # 实际激活的 Skill（由内置与自定义合并同步）
│ ├── cron/
│ │ └── SKILL.md
│ ├── my_skill/
│ │ └── SKILL.md
│ └── ...
└── customized_skills/ # 用户自定义 Skill（在此添加）
└── my_skill/
└── SKILL.md
SKILL.md 示例
---
name: weather_query
description: 天气查询 Skill
天气查询
功能说明
这个 Skill 可以查询指定城市的天气信息。
使用方法
在对话中直接输入城市名称即可，例如：
- 北京今天天气怎么样？
- 查一下上海明天的天气
- 深圳现在的气温是多少？
注意事项
- 只支持国内主要城市
- 天气数据来源于公共 API，可能有延迟
Skills 最佳实践
1. 命名规范
- 使用小写字母和下划线：
my_skill而不是MySkill - 名称应该简洁且具有描述性
- 避免与内置 Skill 冲突
2. 描述清晰
description应该简短但准确- 使用 Markdown 中的 加粗 和 列表 提高可读性
- 提供使用示例
3. 模块化设计
- 每个 Skill 应该专注于一个功能
- 避免在一个 Skill 中塞入太多功能
- 可以通过多个 Skill 组合完成复杂任务
4. 文档完整
- 说明 Skill 的功能
- 提供使用示例
- 列出注意事项和限制
5. 错误处理
- 在文档中说明可能的错误情况
- 提供错误解决方法
- 考虑边界情况
技能冲突和优先级
冲突处理
当同名 Skill 存在时：
- 自定义 Skill 优先于内置 Skill
- 后导入的 Skill 会提示冲突，不会覆盖
依赖关系
某些 Skills 可能依赖其他 Skills，例如：
docx可能依赖file_reader- 自定义 Skill 可能依赖内置 Skills
建议：
- 在
SKILL.md中说明依赖关系 - 确保依赖的 Skills 已启用
性能考虑
Skills 数量
- 启用过多 Skills 可能影响性能
- 建议只启用需要的 Skills
- 定期清理不用的 Skills
资源消耗
某些 Skills 可能消耗较多资源：
pdf- 处理大文件时browser_visible- 启动浏览器时xlsx- 处理复杂表格时
建议：
- 根据硬件配置选择 Skills
- 优化 Skill 实现
- 监控资源使用
社区和贡献
Skills Hub
CoPaw 社区维护了多个 Skills Hub：
- skills.sh - 官方 Skills 市场
- clawhub.ai - 社区 Skills 市场
- skillsmp.com - Skills 市场
- lobehub.com - LobeHub 技能库
贡献你的 Skill
创建了有用的 Skill？考虑与社区分享：
- 将你的 Skill 上传到 GitHub
- 按照 Skills 规范编写文档
- 在社区分享 Skill URL
- 提交到 Skills Hub
参与讨论
- CoPaw GitHub：https://github.com/agentscope-ai/CoPaw
- CoPaw 官方文档：https://copaw.agentscope.io/
- 社区论坛：问题反馈与交流
下一步
现在你已经了解了 CoPaw 的 Skills 系统。接下来建议：
- 阅读下一篇：CoPaw 配置：多渠道接入实战（钉钉、飞书、Discord）- 深入学习频道配置
- 启用 Skills：在控制台中启用你需要的 Skills
- 测试 Skills：与 CoPaw 对话，测试启用的 Skills
- 探索更多 Skills：从社区 Skills Hub 导入更多有趣的 Skills
总结
Skills 是 CoPaw 的核心能力扩展机制：
✅ 内置丰富 Skills
- 开箱即用的强大能力
✅ 模块化设计
- 按需启用，灵活组合
✅ 社区生态
- 从 Skills Hub 导入更多能力
✅ 自定义扩展
- 创建自己的 Skills
✅ 易于管理
- 控制台或命令行管理
通过 Skills，CoPaw 的能力是无限的！
相关资源
：
- CoPaw 官方文档：https://copaw.agentscope.io/
- CoPaw Skills 文档：https://copaw.agentscope.io/docs/skills
- Skills Hub：https://skills.sh/
- ClawHub：https://clawhub.ai/
- LobeHub：https://lobehub.com/
- anthropics/skills：https://github.com/anthropics/skills
