通过官方技能商店(推荐,最简单)
OpenClaw设计了一个类似“应用商店”的机制,这是获取和安装技能最直接的方式。

前提条件:确保你的OpenClaw主服务已经成功运行。
安装步骤:
-
启动技能商店服务: 技能商店(Skill Store)是一个独立的Web服务,你需要根据你的安装方式启动它。
- 如果使用官方一键安装脚本:商店服务可能已作为Docker容器的一部分自动启动,检查相关文档或使用
docker ps命令查看。 - 如果从源码安装:你需要按照项目README的说明,进入技能商店目录并启动服务,通常命令类似:
cd openclaw-skill-store python app.py # 或 npm run serve
服务启动后,会告诉你访问地址,通常是
http://localhost:3000或http://你的服务器IP:3000。
- 如果使用官方一键安装脚本:商店服务可能已作为Docker容器的一部分自动启动,检查相关文档或使用
-
访问技能商店: 在浏览器中打开技能商店的地址。
-
浏览和安装技能:
- 在商店界面中,你会看到分类的技能列表(如:天气、新闻、音乐、智能家居控制等)。
- 找到你需要的技能,点击“安装”或“启用”按钮。
- 商店后端会自动将该技能的配置和代码集成到你的OpenClaw主系统中。
-
重启OpenClaw主服务(有时需要): 安装新技能后,部分技能可能需要重启OpenClaw的主服务(如
core.py或相关服务)才能生效,请根据商店提示或项目文档操作。
手动安装自定义技能
如果你想安装社区开发的第三方技能,或者自己编写技能,需要使用此方法。
技能文件结构:一个标准的OpenClaw技能通常是一个独立的文件夹,包含以下关键文件:
my_custom_skill/
├── skill.py # 技能的核心逻辑代码
├── config.yaml # 技能配置(触发词、参数等)
├── requirements.txt # Python依赖包(可选)
└── README.md # 说明文档(可选)
安装步骤:
-
获取技能包:从GitHub、社区论坛等地方下载你想要的技能包,或创建自己的技能文件夹。
-
放置到技能目录:
- OpenClaw有一个专门的技能加载目录,通常是
~/openclaw/skills/或项目根目录下的skills/文件夹。 - 将整个技能文件夹(如
my_custom_skill)复制或移动到skills/目录下。 - 目录结构应类似于:
skills/ ├── official_weather_skill/ ├── official_news_skill/ └── my_custom_skill/ <-- 你放进去的 ├── skill.py └── config.yaml
- OpenClaw有一个专门的技能加载目录,通常是
-
安装技能依赖(如有): 如果技能文件夹内有
requirements.txt文件,你需要进入该技能的目录安装依赖。cd ~/openclaw/skills/my_custom_skill pip install -r requirements.txt
-
配置技能:
- 编辑技能的
config.yaml文件,根据说明填写必要的API密钥、服务地址等(天气技能需要填入和风天气的API Key)。 - 在
config.yaml中,最重要的配置是triggers(触发词),它定义了你对AI小龙虾说什么话可以激活这个技能。triggers: - "今天天气怎么样" - "北京明天会下雨吗"
- 编辑技能的
-
让OpenClaw加载新技能:
- 热加载:一些版本的OpenClaw支持热加载,放置技能后会自动扫描并加载。
- 重启服务:最可靠的方式是重启OpenClaw的主服务,使用你在安装时启动服务的命令(如
python core.py或通过systemctl),先停止,再启动。# 如果之前用systemctl管理 sudo systemctl restart openclaw
-
验证安装:
- 启动后,查看OpenClaw的日志输出,通常会有类似
Loaded skill: my_custom_skill的信息,表示技能加载成功。 - 直接尝试用你配置的触发词与AI小龙虾对话,测试技能是否正常工作。
- 启动后,查看OpenClaw的日志输出,通常会有类似
故障排查与最佳实践
-
技能不工作:
- 检查日志:首先查看OpenClaw的运行日志,这是最重要的排错信息源,错误会明确指出是导入失败、配置错误还是运行时异常。
- 检查依赖:确保
requirements.txt中的包已正确安装。 - 检查触发词:确认
config.yaml中的触发词配置正确,没有语法错误。
-
技能冲突:如果两个技能的触发词过于相似,可能会引起冲突,尝试修改其中一个技能的触发词。
-
最佳实践:
- 从商店开始:优先使用官方技能商店安装,管理方便,兼容性好。
- 手动安装用于自定义:当有特定需求或想学习开发时,再使用手动方式。
- 版本管理:如果你安装了多个自定义技能,建议使用Git管理你的整个
skills/目录。 - 查看社区:遇到问题或寻找新技能,可以去OpenClaw的GitHub Issues、Discord或相关中文论坛寻求帮助和资源。
总结流程:
对于新手,强烈建议:先尝试通过Web技能商店界面进行一键安装,这能让你快速体验核心功能。
当商店里没有你需要的功能,或你想深度定制时,再采用手动将技能文件夹放入 skills/ 目录并重启服务的方法。
希望这份指南能帮助你顺利地为AI小龙虾装上强大的技能!