OpenClaw实战--Day2:低阶技能

6 阅读7分钟

前言:大家好,接上一篇 Day1 的内容,我们已经成功搭建了 OpenClaw+Ollama 的本地智能体基础环境,实现了核心的 AI 对话功能。今天 Day2 的实战重点是为 OpenClaw 安装各类技能插件,让本地智能体拥有文件操作、天气查询、GitHub 集成等实用能力,同时实现飞书机器人对接,让飞书客户端直接调用本地 OpenClaw 智能体,实现办公场景的 AI 辅助,全程踩坑实录,附详细解决方法。

一、核心前提

  1. 确保 Day1 的 OpenClaw+Ollama 环境正常运行,能通过 TUI/Web UI 正常对话;
  2. 终端仍使用管理员模式 PowerShell,所有命令在该终端执行;
  3. 已安装 Node.js(OpenClaw 安装时自动携带,无需手动安装,技能安装依赖 npm)。

二、基础技能安装(基于 ClawHub,官方技能市场)

OpenClaw 的技能生态基于ClawHub,类似 Python 的 PyPI,支持一键安装官方 / 社区技能,核心步骤是先安装 ClawHub 客户端,再通过 ClawHub 安装各类技能。

Step1:全局安装 ClawHub 客户端

npm install -g clawhub

执行完成后,出现added 35 packages in Xs即代表安装成功(速度较快,无需翻墙)。

image.png

Step2:一键安装常用官方技能

ClawHub 支持npx clawhub install 技能名一键安装,以下是日常高频使用的技能,按需安装,附功能说明:

# 核心基础技能(必装)
npx clawhub install filesystem-mcp # 文件操作:读写/创建/删除文件,带安全沙箱
npx clawhub install weather # 天气查询:无需API密钥,支持全球任意地点
npx clawhub install summarize # 摘要生成:支持URL/本地文件,一键提取核心内容

# 开发/办公技能(按需装)
npx clawhub install github # GitHub集成:需提前安装gh CLI,支持仓库管理
npx clawhub install nano-pdf # PDF编辑:本地PDF读写/修改/提取内容
npx clawhub install notion/obsidian # 笔记同步:对接Notion/Obsidian,自动同步内容
npx clawhub install trello # 任务管理:对接Trello,管理看板/列表/卡片
npx clawhub install openai-whisper # 本地语音识别:纯离线,支持音频转文字
npx clawhub install sherpa-onnx-tts # 本地语音合成:纯离线,文字转语音

技能安装验证(必做)

安装完成后,执行以下命令查看已安装技能列表,状态显示ready即代表安装成功:

openclaw skills list

成功示例:filesystem-mcp [ready]weather [ready]

image.png

技能安装避坑:Rate limit exceeded

安装多个技能时,大概率会出现报错:× Rate limit exceeded,原因是 ClawHub 的官方接口有请求频率限制,解决方法:

  1. 等待 5-10 分钟后重新执行安装命令,避免连续请求;
  2. 单个技能单独安装,不要一次性安装多个;
  3. 后续 Day3 会分享离线安装技能包的高阶方法,彻底解决频率限制问题。

三、进阶实战:飞书机器人对接(打通办公场景)

将 OpenClaw 与飞书机器人对接,实现在飞书客户端直接向机器人发指令,调用本地 OpenClaw 智能体执行,比如查询天气、处理文件、生成摘要,完美适配办公场景,核心步骤如下(附踩坑点)。

前置准备

  1. 拥有飞书账号,且有飞书开放平台的开发者权限(个人账号可申请,免费);
  2. 本地 OpenClaw 服务正常运行(保持openclaw gateway start启动状态);
  3. 飞书客户端已登录,且与开发者账号一致。

Step1:飞书开放平台创建机器人应用

  1. 访问飞书开放平台:open.feishu.cn/,登录后进入「开发者后台」;
  2. 点击「创建应用」,选择「自定义机器人」,填写应用名称(如「OpenClaw 本地智能体」)、头像,完成创建;
  3. 进入应用的「配置」页面,记录App ID、App Secret、Verification Token(后续对接需要);
  4. 开启「机器人能力」,配置「消息接收」,设置消息接收地址为本地 OpenClaw 网关地址:http://127.0.0.1:18789/feishu(核心,飞书通过该地址调用本地服务)。

Step2:OpenClaw 安装飞书技能

在 PowerShell(管理员模式)中,执行以下命令:

openclaw plugins install @m1heng-clawd/feishu

Step3:OpenClaw 配置飞书机器人参数

在 PowerShell(管理员模式)中,执行以下命令配置飞书机器人的核心参数(替换为自己的飞书开放平台信息):

# 设置飞书App ID
openclaw config set feishu.appId 你的飞书App ID
# 设置飞书App Secret
openclaw config set feishu.appSecret 你的飞书App Secret
# 设置飞书Verification Token
openclaw config set feishu.verificationToken 你的飞书Verification Token
# 重启OpenClaw网关,使配置生效
openclaw gateway restart

Step4:飞书客户端添加机器人,实现交互

  1. 回到飞书开放平台的应用页面,点击「发布应用」,选择「仅自己可见」(个人使用,无需审核);
  2. 飞书客户端中,通过「应用搜索」找到创建的机器人,添加到「我的机器人」;
  3. 直接向机器人发送指令,比如「深圳今天天气」,飞书机器人会将指令转发到本地 OpenClaw,执行后返回结果。

image.png

在openclaw 后台窗口,会有输出 image.png

飞书对接核心踩坑点与解决方法

坑点 1:飞书插件安装失败报错 Failed to start ClI Error: spwan npm ENOENT

image.png

原因:由于openclaw多次改名openclaw 的 CLI找不到npm安装服务,所以没办法执行远程下载安装 解决办法:先下载到本地,再安装 下载插件包

curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz

从本地安装

openclaw plugins install ./feishu-0.1.3.tgz

安装还会缺少依赖包

image.png

原因:问ai, 知道是飞书技能打包时缺乏依赖包导致

image.png

解决办法:先将目录切换到飞书插件所在的目录,就是你的报错信息提示的这个目录(根据你自己的报错目录修改一下路径,命令只作演示):

cd C:\Users\zxj\.clawdbot\extensions\feishu
npm install

再切换到你最开始安装飞书插件的目录下面执行安装命令:

openclaw plugins install ./feishu-0.1.3.tgz

坑点 2:飞书长连接失败

原因:没有正确配置好飞书插件,导致openclaw无法与飞书进行通信; 解决:飞书事件与回调,订阅方式改为长连接 image.png

四、技能使用验证(以文件操作 + 天气查询为例)

安装技能和对接飞书后,分别在OpenClaw TUI飞书机器人中验证技能使用,确保功能正常。

验证 1:TUI 终端使用技能

启动 OpenClaw TUI,执行以下指令,验证核心技能:

powershell

openclaw tui
# 输入指令1:查询天气
深圳今天天气
# 输入指令2:文件操作
在D盘创建一个名为test_openclaw的文本文档,内容为「OpenClaw+Ollama本地智能体实战」

技能正常运行的话,会直接返回天气结果,且 D 盘会出现对应的文本文档。

验证 2:飞书机器人使用技能

直接向飞书机器人发送上述相同指令,机器人会返回与 TUI 一致的结果,代表技能和飞书对接均正常。

五、Day2 实战总结

今天完成了 OpenClaw 的技能生态搭建和飞书机器人的对接,核心成果:

  1. 安装了 ClawHub 客户端,一键部署了文件操作、天气查询、摘要生成等常用官方技能;
  2. 解决了 ClawHub 安装技能时的「频率限制」问题,掌握了基础的排错方法;
  3. 实现了 OpenClaw 与飞书机器人的无缝对接,打通了本地智能体 + 办公软件的场景;
  4. 验证了技能的正常使用,实现了终端和飞书双端的 AI 指令执行。

核心问题与后续解决方向

  1. 目前技能安装依赖 ClawHub 在线接口,存在频率限制,后续 Day3 会分享离线下载技能包,手动安装的高阶方法;
  2. 部分海外技能(如 GitHub、X/Twitter)在国内使用可能存在网络问题,后续会分享国内适配方案;
  3. 尚未实现本地系统监控、数据分析等高阶技能,Day3 会重点实战。

核心命令速查(收藏备用)

powershell

# ClawHub技能管理
npm install -g clawhub # 安装ClawHub客户端
npx clawhub install 技能名 # 安装指定技能
openclaw skills list # 查看已安装技能列表

# OpenClaw网关管理
openclaw gateway start # 启动网关
openclaw gateway restart # 重启网关
openclaw gateway stop # 停止网关

# 飞书机器人配置
openclaw config set feishu.appId 你的App ID
openclaw config set feishu.appSecret 你的App Secret
openclaw config set feishu.verificationToken 你的Verification Token