OpenClaw 龙虾必装技能(skill)指南

#
OpenClaw
Skill 安
装完整
指南
Skill 基础概念 什么是
Skill？
Skill 是
OpenClaw 的功能扩展模块，让
AI 助手具备执行特定任务的能力。每个
Skill 都封
装了特定的功能逻辑和 API 调用。 安
装方法汇总 方法一：通过命令行自动安
装（推荐） “`bash # 查看可用
Skill 列表
openclaw
skill list # 安
装特定
Skill
openclaw
skill install web-search
openclaw
skill install weather
openclaw
skill install calculator
openclaw
skill install file-manager # 安
装指定版本的
Skill
openclaw
skill install web-search==1.2.0 # 从 Git 仓库安
装
openclaw
skill install https://github.com/
opencLAW/web-search-
skill.git # 安
装本地
Skill
openclaw
skill install ./path/to/local-
skill “` 方法二：手动安
装到
技能目录 “`bash # openclaw 龙虾 1. 找到
OpenClaw 的
技能目录 find ~ -name ”
openclaw” -type d 2>/dev/null # 通常位置：~/.
openclaw/
skills/ 或 /usr/local/lib/
openclaw/
skills/ # 2. 进入
技能目录 cd ~/.
openclaw/
skills/ # 3. 克隆或复制
Skill 文件 git clone https://github.com/
opencLAW/web-search-
skill.git # 或者 cp -r /path/to/your-
skill ./web-search # 4. 安
装依赖（如果有 requirements.txt） cd web-search pip install -r requirements.txt “` 方法三：使用配置文件批量安
装 创建 `
skills_config.yaml` 文件： “`yaml
skills: – name: web-search source: official version: latest enabled: true – name: weather source: https://github.com/
opencLAW/weather-
skill.git branch: m
ain enabled: true – name: custom-
skill source: ./local-
skills/custom enabled: true dependencies: – requests>=2.25.0 – beautifulsoup4>=4.9.0 – python-dotenv>=0.19.0 “` 然后执行： “`bash
openclaw
skill install –config
skills_config.yaml “` 具体
Skill 安
装示例 1. 安
装联网搜索
Skill 针对您之前提到的联网搜索问题，这里详细说明搜索
Skill 的安
装： “`bash # 安
装官方搜索
Skill
openclaw
skill install web-search # 或者安
装增强版搜索
Skill
openclaw
skill install enhanced-search # 配置搜索 API 密钥 export SEARCH_API_KEY=”your_api_key_here” # 或者在 ~/.
openclaw/config.yaml 中配置 “` 搜索
Skill 配置文件示例： “`yaml # ~/.
openclaw/config.yaml
skills: web-search: enabled: true providers: – name: “brave” api_key: “${BRAVE_API_KEY}” – name: “tavily” api_key: “${TAVILY_API_KEY}” – name: “searxng” url: “http://localhost:8080” settings: timeout: 30 max_results: 5 safe_search: true “` 2. 安
装天气查询
Skill “`bash # 安
装天气
Skill
openclaw
skill install weather # 配置天气 API export WEATHER_API_KEY=”your_openweathermap_key” “` 3. 安
装文件管理
Skill “`bash # 安
装文件操作
Skill
openclaw
skill install file-manager # 配置允许的目录 echo ‘file_manager_allowed_paths: [“/home/user/documents”, “/tmp”]’ >> ~/.
openclaw/config.yaml “`
Skill 目录结构解析 了解
Skill 的目录结构有助于手动安
装和调试： “` web-search-
skill/ ├── __init__.py #
Skill 入口点 ├──
skill.yaml #
Skill 元数据配置 ├── actions/ # 动作定义 │ ├── web_search.py # 搜索动作实现 │ └── search_history.py # 搜索历史管理 ├── schemas/ # 数据模式定义 │ ├── search_request.py │ └── search_response.py ├── utils/ # 工具函数 │ ├── http_client.py │ └── result_parser.py ├── requirements.txt # Python 依赖 └── README.md # 使用说明 “`
skill.yaml 示例： “`yaml name: “web-search” version: “1.2.0” description: “提供联网搜索能力” author: ”
OpenClaw Team” entry_point: “web_search:WebSearch
Skill” actions: web_search: description: “执行网络搜索” parameters: query: type: “string” description: “搜索关键词” required: true max_results: type: “integer” description: “最大结果数” default: 5 dependencies: – “requests>=2.25.0” – “beautifulsoup4>=4.9.0” “` 安
装后验证 1. 检查安
装状态 “`bash # 查看已安
装的
Skill
openclaw
skill list # 查看特定
Skill 详情
openclaw
skill info web-search # 测试
Skill 功能
openclaw
skill test web-search “` 2. 验证
Skill 功能 “`python # 在 Python 中测试
Skill from
openclaw.
skills import get_
skill search_
skill = get_
skill
(“web-search”
) if search_
skill: result = search_
skill.web_search
(query=”今天天气如何”
) print
(f”搜索结果: {result}”
) else: print
(“web-search
skill 未正确安
装”
) “` 3. 检查
Skill 健康状态 “`bash # 运行健康检查
openclaw
skill health-check # 输出示例： # ✓ web-search: 正常
(版本 1.2.0
) # ✓ weather: 正常
(版本 1.0.0
) # ✗ calculator: 配置错误 “` 故障排除 常见问题及解决方案 问题1：
Skill 安
装失败 “`bash # 错误：找不到
skill # 解决方案：更新
skill 仓库
openclaw
skill update-index # 错误：依赖安
装失败 # 解决方案：手动安
装依赖 pip install requests beautifulsoup4 python-dotenv “` 问题2：
Skill 加载但无法使用 “`bash # 检查
Skill 配置
openclaw
skill debug web-search # 重新加载
Skill
openclaw
skill reload web-search # 查看详细日志
openclaw –log-level DEBUG “` 问题3：权限问题 “`bash # 确保有写入权限 sudo chown -R $USER ~/.
openclaw # 或者使用用户目录安
装 export
OPENCLAW_HOME=~/.
openclaw “` 高级安
装技巧 1. 开发模式安
装 “`bash # 开发模式安
装，便于修改和调试
openclaw
skill install –dev ./my-
skill # 或者使用 pip 可编辑安
装 pip install -e ./my-
skill “` 2. 批量安
装脚本 “`bash #!/bin/bash # install_essential_
skills.sh
SKILLS=
(“web-search” “weather” “calculator” “file-manager”
) for
skill in “${
SKILLS[@]}”; do echo “安
装 $
skill…”
openclaw
skill install $
skill if [ $? -eq 0 ]; then echo “✓ $
skill 安
装成功” else echo “✗ $
skill 安
装失败” fi done “` 3. 使用 Docker 安
装 “`dockerfile FROM
openclaw/base:latest # 安
装
必要的
Skill RUN
openclaw
skill install web-search &&
openclaw
skill install weather &&
openclaw
skill install calculator # 配置环境变量 ENV SEARCH_API_KEY=your_key_here “` 管理已安
装的
Skill “`bash # 更新所有
Skill
openclaw
skill update –all # 更新特定
Skill
openclaw
skill update web-search # 禁用
Skill（不卸载）
openclaw
skill disable web-search # 启用
Skill
openclaw
skill enable web-search # 卸载
Skill
openclaw
skill uninstall web-search # 清理缓存
openclaw
skill cleanup “` 通过以上方法，您应该能够成功安
装和管理
OpenClaw 的
Skill。建议从基础的 web-search
skill 开始，逐步安
装其他需要的功能模块。