一、前置准备
在安装技能前，请确认 OpenClaw 已正常部署，执行以下命令验证环境：
bash
运行
openclaw --version
正常输出版本号即代表环境就绪。同时建议提前配置好ClawHub 国内镜像，保证技能下载稳定高速：
bash
运行
clawhub config set registry https://cn.clawhub-mirror.com
二、技能平台介绍
OpenClaw 通过 ClawHub 统一管理技能，国内用户优先使用龙虾技能库（国内镜像站）：
- 提供镜像加速，解决官方源下载慢、超时问题
- 附带中文说明、权限检测、安全评级，适配国内使用习惯
- 技能本质为
SKILL.md配置文件，无恶意可执行程序，核心风险集中在工具权限申请
三、第一步：查找心仪技能
1. 访问龙虾技能库
打开龙虾技能库网页首页，平台提供三种查找方式，新手按需选择：
- 热门推荐：首页展示高使用率技能，经过大量用户实测，稳定性强，新手首选
- 分类浏览：按用途划分（开发工具、效率工具、MCP 组件、办公助手等），按需筛选
- 关键词搜索：输入功能名称、用途精准检索目标技能
2. 新手入门推荐技能
初次体验建议选择轻量化、低风险的基础技能，例如：文本处理、快捷指令、基础查询类技能。
四、第二步：安装前安全核验（必看）
进入技能详情页，重点核对安全相关信息，规避权限风险：
- 认证标签 优先选择 官方认证（Official）、已验证（Verified） 标签的技能，可信度最高。
- 安全等级
- 绿色：低风险，仅调用基础工具，可放心安装
- 黄色：需留意，会申请文件读写、网络访问等权限，按需选择
- 安全扫描报告 查看平台给出的权限分析、风险说明，确认技能所需权限符合你的使用预期。
补充说明：技能本身不会运行二进制程序，安全风险主要来自其申请的系统 / 工具权限，权限越大越需要谨慎。
五、第三步：执行安装操作
1. 基础安装命令
复制技能名称，在终端执行安装指令，格式如下：
bash
运行
clawhub install 技能名称
示例（以新手常用技能举例）：
bash
运行
# 安装文本快捷处理技能
clawhub install text-helper
2. 安装附加参数
- 静默安装（不输出多余日志）：
bash
运行
clawhub install 技能名称 --quiet
- 强制覆盖已有同名技能（更新 / 重装）：
bash
运行
clawhub install 技能名称 --force
3. 安装成功提示
终端出现 Install success 类提示，代表技能下载、注册全部完成，可正常使用。
六、第四步：查看已安装技能
1. 列出所有已安装技能
bash
运行
clawhub list
命令会展示技能名称、版本、简介、安装路径，方便统一管理。
2. 查看单个技能详情
bash
运行
clawhub show 技能名称
可查看技能完整说明、使用规则、依赖项、权限列表。
七、第五步：测试技能可用性
方式 1：终端交互测试
启动智能体对话，直接调用技能对应的功能指令，验证是否生效：
bash
运行
openclaw agent
按照技能说明下发指令，观察执行结果。
方式 2：Web 仪表板测试
- 打开网关面板
http://127.0.0.1:18789/ - 进入会话界面，输入指令测试功能
- 查看日志面板，排查调用异常
八、技能基础管理常用命令
1. 更新已安装技能
bash
运行
# 更新单个技能
clawhub update 技能名称
# 更新全部技能
clawhub update all
2. 卸载不需要的技能
bash
运行
clawhub uninstall 技能名称
3. 检索技能（终端内搜索）
不打开网页，直接在终端搜索技能：
bash
运行
clawhub search 关键词
九、常见问题与解决
Q1：下载速度慢、连接超时？
A：确认已配置国内镜像 clawhub config set registry https://cn.clawhub-mirror.com，重新执行安装。
Q2：提示权限不足？
A：使用普通用户权限操作，不要加 sudo；若为系统全局目录，检查目录读写权限。
Q3：安装成功，但调用无反应？
- 重启网关
openclaw gateway restart - 查看技能详情，核对使用指令是否正确
- 运行
openclaw doctor检查环境完整性
Q4：提示技能已存在？
A：使用 --force 参数强制覆盖安装，或先卸载旧版本再重装。
十、新手使用小贴士
- 初次使用只安装 1~2 个简单技能，熟悉流程后再批量拓展；
- 非必要不安装高权限技能（文件删除、系统命令执行、全量网络访问）；
- 定期使用
clawhub list整理无用技能，减少资源占用； - 技能更新建议跟随镜像站版本，保证兼容性。