前言:大家好,接上一篇 Day1 的内容,我们已经成功搭建了 OpenClaw+Ollama 的本地智能体基础环境,实现了核心的 AI 对话功能。今天 Day2 的实战重点是为 OpenClaw 安装各类技能插件,让本地智能体拥有文件操作、天气查询、GitHub 集成等实用能力,同时实现飞书机器人对接,让飞书客户端直接调用本地 OpenClaw 智能体,实现办公场景的 AI 辅助,全程踩坑实录,附详细解决方法。
一、核心前提
- 确保 Day1 的 OpenClaw+Ollama 环境正常运行,能通过 TUI/Web UI 正常对话;
- 终端仍使用管理员模式 PowerShell,所有命令在该终端执行;
- 已安装 Node.js(OpenClaw 安装时自动携带,无需手动安装,技能安装依赖 npm)。
二、基础技能安装(基于 ClawHub,官方技能市场)
OpenClaw 的技能生态基于ClawHub,类似 Python 的 PyPI,支持一键安装官方 / 社区技能,核心步骤是先安装 ClawHub 客户端,再通过 ClawHub 安装各类技能。
Step1:全局安装 ClawHub 客户端
npm install -g clawhub
执行完成后,出现added 35 packages in Xs即代表安装成功(速度较快,无需翻墙)。
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]。
技能安装避坑:Rate limit exceeded
安装多个技能时,大概率会出现报错:× Rate limit exceeded,原因是 ClawHub 的官方接口有请求频率限制,解决方法:
- 等待 5-10 分钟后重新执行安装命令,避免连续请求;
- 单个技能单独安装,不要一次性安装多个;
- 后续 Day3 会分享离线安装技能包的高阶方法,彻底解决频率限制问题。
三、进阶实战:飞书机器人对接(打通办公场景)
将 OpenClaw 与飞书机器人对接,实现在飞书客户端直接向机器人发指令,调用本地 OpenClaw 智能体执行,比如查询天气、处理文件、生成摘要,完美适配办公场景,核心步骤如下(附踩坑点)。
前置准备
- 拥有飞书账号,且有飞书开放平台的开发者权限(个人账号可申请,免费);
- 本地 OpenClaw 服务正常运行(保持
openclaw gateway start启动状态); - 飞书客户端已登录,且与开发者账号一致。
Step1:飞书开放平台创建机器人应用
- 访问飞书开放平台:open.feishu.cn/,登录后进入「开发者后台」;
- 点击「创建应用」,选择「自定义机器人」,填写应用名称(如「OpenClaw 本地智能体」)、头像,完成创建;
- 进入应用的「配置」页面,记录App ID、App Secret、Verification Token(后续对接需要);
- 开启「机器人能力」,配置「消息接收」,设置消息接收地址为本地 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:飞书客户端添加机器人,实现交互
- 回到飞书开放平台的应用页面,点击「发布应用」,选择「仅自己可见」(个人使用,无需审核);
- 飞书客户端中,通过「应用搜索」找到创建的机器人,添加到「我的机器人」;
- 直接向机器人发送指令,比如「深圳今天天气」,飞书机器人会将指令转发到本地 OpenClaw,执行后返回结果。
在openclaw 后台窗口,会有输出
飞书对接核心踩坑点与解决方法
坑点 1:飞书插件安装失败报错 Failed to start ClI Error: spwan npm ENOENT
原因:由于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
安装还会缺少依赖包
原因:问ai, 知道是飞书技能打包时缺乏依赖包导致
解决办法:先将目录切换到飞书插件所在的目录,就是你的报错信息提示的这个目录(根据你自己的报错目录修改一下路径,命令只作演示):
cd C:\Users\zxj\.clawdbot\extensions\feishu
npm install
再切换到你最开始安装飞书插件的目录下面执行安装命令:
openclaw plugins install ./feishu-0.1.3.tgz
坑点 2:飞书长连接失败
原因:没有正确配置好飞书插件,导致openclaw无法与飞书进行通信;
解决:飞书事件与回调,订阅方式改为长连接
四、技能使用验证(以文件操作 + 天气查询为例)
安装技能和对接飞书后,分别在OpenClaw TUI和飞书机器人中验证技能使用,确保功能正常。
验证 1:TUI 终端使用技能
启动 OpenClaw TUI,执行以下指令,验证核心技能:
powershell
openclaw tui
# 输入指令1:查询天气
深圳今天天气
# 输入指令2:文件操作
在D盘创建一个名为test_openclaw的文本文档,内容为「OpenClaw+Ollama本地智能体实战」
技能正常运行的话,会直接返回天气结果,且 D 盘会出现对应的文本文档。
验证 2:飞书机器人使用技能
直接向飞书机器人发送上述相同指令,机器人会返回与 TUI 一致的结果,代表技能和飞书对接均正常。
五、Day2 实战总结
今天完成了 OpenClaw 的技能生态搭建和飞书机器人的对接,核心成果:
- 安装了 ClawHub 客户端,一键部署了文件操作、天气查询、摘要生成等常用官方技能;
- 解决了 ClawHub 安装技能时的「频率限制」问题,掌握了基础的排错方法;
- 实现了 OpenClaw 与飞书机器人的无缝对接,打通了本地智能体 + 办公软件的场景;
- 验证了技能的正常使用,实现了终端和飞书双端的 AI 指令执行。
核心问题与后续解决方向
- 目前技能安装依赖 ClawHub 在线接口,存在频率限制,后续 Day3 会分享离线下载技能包,手动安装的高阶方法;
- 部分海外技能(如 GitHub、X/Twitter)在国内使用可能存在网络问题,后续会分享国内适配方案;
- 尚未实现本地系统监控、数据分析等高阶技能,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