小龙虾 OpenClaw 养殖日记(三)
上一期回顾
上回说到,我们把小龙虾(OpenClaw)带回了家,给它装上了大脑(AI 模型),还教会了它说话。
今天,我们来聊聊如何给小龙虾安装技能包,让它从一只普通的虾变成一只多才多艺的小助手。
灵魂拷问:为什么要给小龙虾装技能?
养过小动物的朋友都知道,给宠物学会新技能是很有成就感的事情。
OpenClaw 也是如此。装上技能后,它就能帮你:
查询服务器状态、自动巡检 管理日历、发送飞书消息 搜索网页、获取天气 ️ 执行各种自动化任务
简单来说,技能就是 OpenClaw 的工具箱。有了它,小龙虾就不再是只会聊天的虾了,而是一只能干活的虾。
一、Skill 是什么?
在 OpenClaw 里,一个** Skill(技能)**就是一个独立的功能模块,每个 Skill 都有固定的结构:
skills/└── my-skill/ ├── SKILL.md # 技能说明文档 ├── scripts/ │ └── main.js # 核心脚本 ├── references/ # 参考资料 └── package.json # 依赖声明1.1 SKILL.md — 技能说明书
这是最重要的文件,包含:
触发关键词:什么情况下应该用这个技能 功能描述:这个技能能干什么 使用方式:命令和参数说明 输出格式:结果的展示方式
当用户发送消息时,OpenClaw 会自动扫描所有 Skills 的说明文档,找到最匹配的那个来执行。
1.2 scripts/main.js — 核心代码
实际执行任务的脚本。可以是 Node.js、Python 或者 Shell 脚本。
1.3 references/ — 参考资料
放一些静态数据、命令参考、阈值配置等辅助文件。
二、快速安装技能
2.1 使用 ClawHub(官方技能市场)
OpenClaw 官方维护了一个技能市场叫做 ClawHub,类似于手机应用商店。
# 搜索技能clawhub search "prometheus"# 安装技能clawhub install prometheus --workdir ~/.openclaw/workspace# 更新技能clawhub update prometheus# 查看已安装clawhub list2.2 推荐安装的技能
新手推荐先装这几个:
prometheus | ||
feishu-calendar | ||
feishu-bitable | ||
weather | ||
healthcheck |
2.3 手动安装
有时候网络不好,可以手动安装:
从 GitHub 或其他渠道获取 Skill 文件 解压到 ~/.openclaw/workspace/skills/目录进入目录安装依赖:
cd ~/.openclaw/workspace/skills/my-skillnpm install # 或 pip install -r requirements.txt三、手把手:安装 Prometheus 技能
让我以 Prometheus 技能为例,演示完整的安装和使用过程。
3.1 安装
clawhub install prometheus --workdir ~/.openclaw/workspace3.2 配置
编辑 ~/.openclaw/workspace/prometheus.json,添加你的 Prometheus 服务器信息:
{"instances":[{"name":"生产环境","url":"http://192.168.1.100:9090","user":"admin","password":"your_password"}],"default":"生产环境"}3.3 使用
安装配置好后,直接跟我说:
"帮我查一下生产服务器的 CPU 使用率"
或者在终端执行:
cd ~/.openclaw/workspace/skills/prometheusnode scripts/cli.js query 'node_cpu_usage'3.4 查看监控指标
Prometheus 技能支持查询各种指标,常用的有:
node_cpu_usage | ||
node_memory_usage | ||
node_disk_space | ||
node_network_io |
四、自己动手写一个技能
看别人写好的技能很爽,但如果能自己写一个,那才是真正的养殖达人!
4.1 创建技能目录
mkdir -p ~/.openclaw/workspace/skills/my-first-skill/scriptscd ~/.openclaw/workspace/skills/my-first-skill4.2 编写 SKILL.md
# 我的第一个技能## 触发场景当用户提到以下内容时激活:- "我的技能"- "测试技能"## 功能打印一条友好的问候消息。## 使用方式直接对我说"我的技能",我会回应一条消息。4.3 编写核心脚本
// scripts/hello.jsconsole.log(" 你好!我是小龙虾,这是我的第一个技能!");4.4 注册技能
把技能目录放到 ~/.openclaw/workspace/skills/ 下,OpenClaw 会自动识别。
4.5 测试
重启 OpenClaw,然后对我说"我的技能"试试!
五、技能编写进阶
5.1 让脚本能接收参数
有时候我们需要传递参数给脚本。
SKILL.md 中定义:
## 使用方式```bashnode scripts/query.js --metric=cpu --period=1h**脚本中读取:**```javascriptconst args = process.argv.slice(2);const params = {};args.forEach(arg => { const [key, value] = arg.split('='); params[key.replace('--', '')] = value;});console.log(`查询指标: ${params.metric}`);console.log(`时间范围: ${params.period}`);5.2 返回结构化数据
脚本输出的数据会被 OpenClaw 解析,尽量返回 JSON 格式:
const result = {status: "success",data: {cpu: 45.2,memory: 62.8,disk: 35.1 }};console.log(JSON.stringify(result));5.3 调用外部 API
const https = require('https');functionfetchData(url) {returnnewPromise((resolve, reject) => { https.get(url, (res) => {let data = ''; res.on('data', chunk => data += chunk); res.on('end', () =>resolve(JSON.parse(data))); }).on('error', reject); });}六、技能推荐清单
6.1 运维监控类
prometheus | |
healthcheck | |
ops-monitor |
6.2 飞书集成类
feishu-calendar | |
feishu-bitable | |
feishu-im-read | |
feishu-doc |
6.3 实用工具类
weather | |
wechat-publisher | |
tmux |
七、常见问题
Q1: 技能安装后不生效?
检查依赖是否安装: cd skills/xxx && npm install检查 Skill 目录结构是否正确 重启 OpenClaw
Q2: ClawHub 搜索被限速?
稍等几分钟后再试,或者手动安装。
Q3: 如何卸载技能?
clawhub uninstall my-skill或者直接删除目录:
rm -rf ~/.openclaw/workspace/skills/my-skill今日小结
今天我们学会了:
了解 Skill 的结构和原理 从 ClawHub 安装技能 配置和使用 Prometheus 技能 动手编写自己的第一个技能
下期预告
小龙虾养殖日记(三)将会介绍:
安全加固:给小龙虾装上门锁(SSH、权限管理) 自动化巡检:让小龙虾每天自动巡检服务器 故障自愈:小龙虾发现问题了怎么办 定制外观:让小龙虾的输出更好看
敬请期待!
小龙虾 OpenClaw 养殖日记(一)
小龙虾养殖日记,记录你与 AI 助手的日常*
夜雨聆风