OpenClaw 技能安装与角色配置完全指南

📖 什么是 ClawHub？

ClawHub 是 OpenClaw 生态系统的技能市场，你可以把它想象成"AI 技能的应用商店"。在这里，你可以找到各种预制的技能包（AgentSkills bundles），一键安装到你的 OpenClaw 中，让你的 AI 助手瞬间获得新能力------从网页浏览、API 调用到知识图谱管理，应有尽有。

🚀 一、技能安装基础

1.1 核心命令：npx clawhub (但是我这边测试的时候可能超时)

这里的名称用url中的名称：

https://clawhub.ai/matrixy/agent-browser-clawdbot

ClawHub 提供了一个统一的安装工具，通过 npx 即可使用，无需单独安装：

bash 复制代码

npx clawhub@latest install <技能名称>

这个命令会：

自动从 ClawHub 下载指定的技能包
解压并安装到 OpenClaw 的技能目录
处理依赖关系

1.2 手动安装

从 ClawHub 下载指定的技能包
解压，
查看md文件并按指导安装到 OpenClaw 的技能目录

1.3 查看可用技能

访问 https://clawhub.ai 浏览热门技能，目前平台提供以下几类技能：

技能分类	示例技能	功能描述
自我改进类	self-improving-agent	捕获错误和用户纠正，实现持续学习
知识管理类	ontology	类型化知识图谱，结构化 Agent 记忆
浏览器自动化	Agent Browser	基于无障碍树的浏览器自动化
API 集成类	API Gateway	连接 Google、GitHub、Slack 等 100+ API
搜索类	Prismfy Search, Baidu Search	多引擎网络搜索
MCP 工具	Mcporter	管理 MCP 服务器和工具调用
免费 AI 资源	Free Ride	管理 OpenRouter 的免费 AI 模型

🔧 二、技能安装后的目录结构

技能安装后，通常会存放在以下位置：

复制代码

~/.openclaw/skills/
├── agent-browser/          # 浏览器自动化技能
│   ├── skill.md           # 技能描述文件
│   ├── commands/          # 命令脚本
│   └── requirements.txt   # Python 依赖
├── ontology/              # 知识图谱技能
├── self-improving-agent/  # 自我改进技能
└── baidu-search/          # 百度搜索技能

每个技能包都包含一个 README.md 或 skill.md，详细说明如何使用该技能。

🤖 三、给 Agent 角色添加技能

也可以用webui操作

技能安装完成后，需要将其赋予特定的 Agent 角色。OpenClaw 支持两种方式：

3.1 方式一：通过配置文件（推荐）

编辑 ~/.openclaw/openclaw.json，在对应的 Agent 配置中添加 skills 字段：

json 复制代码

{
  "agents": {
    "list": [
      {
        "id": "web_agent",
        "workspace": "~/.openclaw/workspace/web",
        "skills": [
          "agent-browser",
          "prismfy-search"
        ]
      },
      {
        "id": "knowledge_agent",
        "workspace": "~/.openclaw/workspace/knowledge",
        "skills": [
          "ontology",
          "self-improving-agent"
        ]
      },
      {
        "id": "api_agent",
        "workspace": "~/.openclaw/workspace/api",
        "skills": [
          "api-gateway",
          "mcporter"
        ]
      }
    ]
  }
}

3.2 方式二：通过命令行动态添加

bash 复制代码

# 语法
openclaw agents add <agent-id> --skill <skill-name>

# 示例：给 web_agent 添加浏览器技能
openclaw agents add web_agent --skill agent-browser

# 给 knowledge_agent 添加知识图谱技能
openclaw agents add knowledge_agent --skill ontology

3.3 验证技能是否生效

bash 复制代码

# 查看 Agent 的技能列表
openclaw agents get <agent-id> --show-skills

# 示例
openclaw agents get web_agent --show-skills

输出示例：

复制代码

Agent: web_agent
Skills:
  - agent-browser (v1.0.0)
  - prismfy-search (v2.1.0)
Status: Active

📋 四、技能管理常用命令

操作	命令
搜索技能	`npx clawhub@latest search <关键词>`
安装技能	`npx clawhub@latest install <技能名>`
更新技能	`npx clawhub@latest update <技能名>`
卸载技能	`rm -rf ~/.openclaw/skills/<技能名>`
列出已安装技能	`ls ~/.openclaw/skills/`
查看技能详情	`cat ~/.openclaw/skills/<技能名>/README.md`
给 Agent 添加技能	`openclaw agents add <agent-id> --skill <技能名>`
移除 Agent 技能	`openclaw agents remove <agent-id> --skill <技能名>`

⚠️ 五、注意事项与最佳实践

5.1 技能依赖管理

某些技能需要额外的系统依赖或 API 密钥：

Agent Browser ：需要安装 Playwright (npm install -g playwright)
API Gateway：需要配置 OAuth 凭证
Prismfy Search：需要注册获取 API Key（免费套餐可用）

5.2 技能版本控制

ClawHub 支持版本化技能，安装时指定版本：

bash 复制代码

npx clawhub@latest install ontology@1.2.0

5.3 技能冲突处理

如果两个技能提供相同的命令，OpenClaw 按以下优先级处理：

Agent 专属技能 > 全局技能
后安装的技能 > 先安装的技能（可通过配置调整）

5.4 性能优化建议

不要给一个 Agent 安装超过 10 个技能，会影响响应速度
将相关性强的技能组合给同一个 Agent（如搜索+浏览器）
定期清理不用的技能：rm -rf ~/.openclaw/skills/<旧技能>

🔗 六、参考资源

ClawHub 官网：https://clawhub.ai
OpenClaw 官方文档：https://docs.openclaw.ai
技能开发指南：https://clawhub.ai/docs/create-skill
社区技能分享：https://github.com/clawhub/community-skills

📝 七、快速命令速查表

bash 复制代码

# === 技能安装 ===
npx clawhub@latest install <技能名>

# === 创建带技能的 Agent ===
openclaw agents add <agent-id> --skill <技能名>

# === 给现有 Agent 添加技能 ===
openclaw agents update <agent-id> --add-skill <技能名>

# === 查看 Agent 技能 ===
openclaw agents get <agent-id> --show-skills

# === 完整配置示例（JSON）===
{
  "agents": {
    "list": [{
      "id": "my_agent",
      "skills": ["agent-browser", "prismfy-search"]
    }]
  }
}

通过 ClawHub 技能市场，你可以像搭积木一样快速扩展 OpenClaw 的能力。无论是让 AI 学会上网、管理知识库，还是调用各种 API，只需要一条 npx clawhub install 命令即可完成。赶快去 https://clawhub.ai 探索更多有趣的技能吧！