如何安装和管理Skills（技能）？​

📅 发布于 2026-03-09 10:18:59
👁️ 总访问量 5 次

OpenClaw的Skills（技能）是扩展AI助手功能的核心模块，类似于插件系统。每个技能都封装了特定的能力，如联网搜索、文件处理、API集成等。以下是完整的技能安装与管理指南。

技能系统架构

技能目录结构

  1. ~/.openclaw/workspace/skills/
  2. ├── skill-name/ # 技能文件夹
  3. │ ├── _meta.json # 技能元数据（必需）
  4. │ ├── SKILL.md # 技能说明文档
  5. │ ├── scripts/ # 脚本文件目录
  6. │ │ ├── main.mjs # 主脚本
  7. │ │ └── utils.mjs # 工具函数
  8. │ └── prompts/ # 提示词模板
  9. └── .clawhub/ # ClawHub缓存目录

技能元数据示例（_meta.json）

  1. {
  2. "name": "web-search",
  3. "version": "1.0.0",
  4. "description": "联网搜索技能",
  5. "author": "OpenClaw Team",
  6. "dependencies": {
  7. "@openclaw/core": "^2026.2.0"
  8. },
  9. "triggers": ["web_search", "search"],
  10. "providesTools": ["web_search"]
  11. }

技能安装方法

方法一：通过ClawHub安装（官方市场）

ClawHub是OpenClaw的官方技能市场，提供经过验证的技能。

1. 搜索可用技能

  1. # 搜索技能
  2. clawhub search <关键词>
  4. # 示例：搜索搜索相关技能
  5. clawhub search web
  6. clawhub search 搜索
  8. # 查看技能详情
  9. clawhub info <技能名>

2. 安装技能

  1. # 基本安装命令
  2. clawhub install <技能名>
  4. # 示例：安装Tavily搜索技能
  5. clawhub install tavily-search
  7. # 安装特定版本
  8. clawhub install web-search@1.2.0
  10. # 安装并自动启用
  11. clawhub install <技能名> --enable

3. 从GitHub仓库安装

  1. # 直接安装GitHub仓库
  2. clawhub install https://github.com/<作者>/<仓库名>
  4. # 示例：安装官方技能
  5. clawhub install https://github.com/openclaw/skill-web-search

方法二：手动安装技能

1. 克隆技能仓库

  1. # 进入技能目录
  2. cd ~/.openclaw/workspace/skills
  4. # 克隆技能仓库
  5. git clone https://github.com/<作者>/<仓库名>.git <技能名>
  7. # 示例：安装自定义技能
  8. git clone https://github.com/example/skill-custom.git my-custom-skill

2. 安装依赖

  1. # 进入技能目录
  2. cd ~/.openclaw/workspace/skills/<技能名>
  4. # 安装Node.js依赖（如果有package.json）
  5. npm install
  7. # 或使用pnpm/yarn
  8. pnpm install

3. 注册技能

  1. # 手动注册技能到OpenClaw
  2. openclaw skills register <技能路径>
  4. # 示例
  5. openclaw skills register ~/.openclaw/workspace/skills/my-custom-skill

方法三：创建本地技能

1. 初始化技能模板

  1. # 创建技能目录
  2. mkdir -p ~/.openclaw/workspace/skills/my-skill
  3. cd ~/.openclaw/workspace/skills/my-skill
  5. # 创建元数据文件
  6. cat > _meta.json << EOF
  7. {
  8. "name": "my-skill",
  9. "version": "1.0.0",
  10. "description": "我的自定义技能",
  11. "author": "你的名字",
  12. "triggers": ["my_command"],
  13. "providesTools": ["my_tool"]
  14. }
  15. EOF

2. 创建主脚本

  1. # 创建scripts目录和主脚本
  2. mkdir -p scripts
  3. cat > scripts/main.mjs << EOF
  4. export default {
  5. name: 'my-skill',
  6. version: '1.0.0',
  8. async setup(ctx) {
  9. // 技能初始化逻辑
  10. console.log('My skill initialized');
  11. },
  13. tools: {
  14. my_tool: {
  15. description: '我的自定义工具',
  16. parameters: {
  17. query: { type: 'string', description: '查询内容' }
  18. },
  19. async execute({ query }) {
  20. // 工具执行逻辑
  21. return `处理查询: ${query}`;
  22. }
  23. }
  24. }
  25. };
  26. EOF

技能管理命令

1. 查看已安装技能

  1. # 列出所有技能
  2. openclaw skills list
  4. # 查看技能详情
  5. openclaw skills info <技能名>
  7. # 查看已启用的技能
  8. openclaw skills list --enabled
  10. # 查看可用更新
  11. openclaw skills list --updatable

2. 启用/禁用技能

  1. # 启用技能
  2. openclaw skills enable <技能名>
  4. # 禁用技能
  5. openclaw skills disable <技能名>
  7. # 批量操作
  8. openclaw skills enable skill1 skill2 skill3
  9. openclaw skills disable --all

3. 更新技能

  1. # 更新单个技能
  2. openclaw skills update <技能名>
  4. # 更新所有技能
  5. openclaw skills update --all
  7. # 从GitHub更新
  8. cd ~/.openclaw/workspace/skills/<技能名>
  9. git pull origin main

4. 卸载技能

  1. # 卸载技能（保留文件）
  2. openclaw skills uninstall <技能名>
  4. # 完全删除技能（删除文件）
  5. openclaw skills remove <技能名>
  7. # 确认删除
  8. openclaw skills remove <技能名> --force

5. 技能配置管理

  1. # 查看技能配置
  2. openclaw config get skills.<技能名>
  4. # 设置技能配置
  5. openclaw config set skills.<技能名>.enabled true
  6. openclaw config set skills.<技能名>.apiKey "你的API_KEY"
  8. # 重置技能配置
  9. openclaw config reset skills.<技能名>

常用技能推荐

1. 搜索类技能

  1. # Tavily搜索（推荐）
  2. clawhub install tavily-search
  4. # 多搜索引擎
  5. clawhub install multi-search-engine
  7. # 百度搜索（国内用户）
  8. clawhub install baidu-search

2. 文件处理技能

  1. # 文件读写
  2. clawhub install file-io
  4. # PDF处理
  5. clawhub install pdf-processor
  7. # 图像处理
  8. clawhub install image-tools

3. API集成技能

  1. # 天气查询
  2. clawhub install weather
  4. # 股票信息
  5. clawhub install stock-info
  7. # 翻译服务
  8. clawhub install translator

4. 开发工具技能

  1. # 代码执行
  2. clawhub install code-executor
  4. # Git操作
  5. clawhub install git-tools
  7. # Docker管理
  8. clawhub install docker-manager

技能配置示例

配置Tavily搜索技能

  1. # 安装后配置API Key
  2. export TAVILY_API_KEY="你的API_KEY"
  4. # 或写入配置文件
  5. openclaw config set skills.tavily-search.apiKey "你的API_KEY"
  7. # 配置搜索参数
  8. openclaw config set skills.tavily-search.maxResults 5
  9. openclaw config set skills.tavily-search.includeAnswer true

配置文件处理技能

  1. # 设置工作目录
  2. openclaw config set skills.file-io.workspace ~/openclaw-workspace
  4. # 配置文件大小限制
  5. openclaw config set skills.file-io.maxFileSize 10485760 # 10MB
  7. # 允许的文件类型
  8. openclaw config set skills.file-io.allowedExtensions '["txt","md","pdf","jpg","png"]'

技能开发与调试

1. 开发模式

  1. # 启用开发模式
  2. openclaw skills dev <技能名>
  4. # 实时重载（监视文件变化）
  5. openclaw skills dev <技能名> --watch
  7. # 查看技能日志
  8. openclaw logs --skill <技能名>

2. 调试技能

  1. # 查看技能状态
  2. openclaw skills status <技能名>
  4. # 测试技能工具
  5. openclaw skills test <技能名> <工具名> --params '{"param":"value"}'
  7. # 查看详细错误信息
  8. openclaw skills debug <技能名>

3. 技能打包与发布

  1. # 创建技能包
  2. cd ~/.openclaw/workspace/skills/<技能名>
  3. npm run build # 或自定义构建脚本
  5. # 验证技能结构
  6. clawhub validate <技能路径>
  8. # 发布到ClawHub（需要权限）
  9. clawhub publish

最佳实践

1. 技能管理策略

  • 分类存储：按功能分类管理技能
  • 版本控制：对自定义技能使用Git管理
  • 定期更新：每月检查技能更新
  • 备份配置：备份重要的技能配置

2. 性能优化

  1. # 禁用不常用的技能
  2. openclaw skills disable rarely-used-skill
  4. # 设置技能加载延迟
  5. openclaw config set skills.lazyLoad true
  7. # 配置技能超时时间
  8. openclaw config set skills.timeout 30000 # 30秒

3. 安全考虑

  • 审查第三方技能：安装前检查代码安全性
  • 限制权限：敏感技能设置访问控制
  • 隔离环境：高风险技能在沙箱中运行
  • 定期审计：检查技能是否有安全更新

故障排除

问题1：技能安装失败

  1. # 检查网络连接
  2. ping raw.githubusercontent.com
  4. # 清理ClawHub缓存
  5. rm -rf ~/.openclaw/.clawhub/cache
  7. # 使用代理（如需要）
  8. export HTTPS_PROXY=http://127.0.0.1:7890
  9. clawhub install <技能名>

问题2：技能启用后不工作

  1. # 检查技能状态
  2. openclaw skills status <技能名>
  4. # 查看技能日志
  5. openclaw logs --skill <技能名>
  7. # 重新加载技能
  8. openclaw skills reload <技能名>
  10. # 检查依赖
  11. cd ~/.openclaw/workspace/skills/<技能名>
  12. npm list

问题3：技能冲突

  1. # 列出所有技能的工具
  2. openclaw skills list --tools
  4. # 查找工具冲突
  5. openclaw skills find-tool <工具名>
  7. # 禁用冲突技能
  8. openclaw skills disable <冲突技能名>
  10. # 设置技能优先级
  11. openclaw config set skills.<技能名>.priority 100

问题4：技能更新失败

  1. # 手动更新
  2. cd ~/.openclaw/workspace/skills/<技能名>
  3. git stash
  4. git pull origin main
  5. git stash pop
  7. # 重新安装
  8. openclaw skills remove <技能名>
  9. clawhub install <技能名>

高级技巧

1. 技能组合使用

  1. # 创建技能组合配置文件
  2. cat > ~/.openclaw/skill-groups.json << EOF
  3. {
  4. "development": ["git-tools", "code-executor", "docker-manager"],
  5. "research": ["tavily-search", "pdf-processor", "translator"],
  6. "productivity": ["file-io", "calendar", "email-tools"]
  7. }
  8. EOF
  10. # 批量启用技能组
  11. openclaw skills enable-group development

2. 自定义技能触发器

  1. # 在技能元数据中定义触发器
  2. # _meta.json
  3. {
  4. "triggers": {
  5. "keywords": ["搜索", "查找", "查一下"],
  6. "patterns": ["^搜索.*$", "^查找.*$"],
  7. "intents": ["search", "lookup"]
  8. }
  9. }

3. 技能热重载

  1. # 监视技能目录变化
  2. openclaw skills watch
  4. # 开发时自动重载
  5. openclaw gateway dev --skills

通过以上方法，你可以有效地安装、管理和定制OpenClaw技能，构建适合自己需求的AI助手生态系统。建议从官方市场开始，逐步探索和添加自定义技能。

OpenClaw

© 本文著作权归作者所有。转载请联系授权，禁止商用。

🔗 系列文章

1. openclaw能做什么？

2. openclaw会不会窃取我电脑上的私密信息？

3. openclaw的沙盒模式是什么？

4. Windows环境下如何正确安装OpenClaw？

5. 安装后提示"command not found"怎么办？

6. Node.js版本要求是什么？为什么推荐22版本？

7. 端口18789被占用如何处理？

8. 如何配置飞书/钉钉等国内聊天平台？

9. 配对码（Pairing）是什么？如何批准连接？

10. 如何切换AI模型提供商？

11. 联网搜索功能如何配置？

12. OpenClaw的记忆功能为什么"不会记住对话"？​

13. 如何安装和管理Skills（技能）？​

14. 定时任务（Cron Jobs）如何设置？

15. 浏览器自动化能做什么？具体如何操作？

16. 如何防范提示词注入（Prompt Injection）攻击？

17. 如何识别和避免恶意Skills？

18. 使用OpenClaw每月需要多少费用？

19. 如何控制Token消耗成本？

20. Gateway服务启动失败如何排查？

21. 遇到"HTTP 401: invalid access token"等错误怎么办？