OpenClaw + LMStudio + 飞书:搭建本地离线 AI 助手
本文详细介绍如何在 Windows 环境下,结合 LMStudio 本地大模型与 OpenClaw 框架,快速搭建一个可接入飞书的私人 AI 助手。全程离线可运行,数据不出本地,适合开发者、技术爱好者及企业私有化部署场景。
系统要求
- Windows 10/11 或 WSL2(推荐)
- Node.js ≥ 22 LTS
本文介绍在 Windows 环境下使用 LMStudio 运行本地大模型,结合 OpenClaw 框架搭建接入飞书的私人 AI 助手。步骤包括安装 Node.js 和 Git、配置 LMStudio API、初始化 OpenClaw 服务、创建飞书企业应用并配置权限、安装飞书插件及发布应用。全程支持离线运行,保障数据隐私,适合开发者私有化部署场景。
本文详细介绍如何在 Windows 环境下,结合 LMStudio 本地大模型与 OpenClaw 框架,快速搭建一个可接入飞书的私人 AI 助手。全程离线可运行,数据不出本地,适合开发者、技术爱好者及企业私有化部署场景。
CMD 窗口安装:
# 1. 下载安装 Node.js ≥ 22
# 手动安装:https://nodejs.org/zh-cn/download 中下载.msi 手动安装
# 验证安装:
node --version
npm --version
# 推荐使用 pnpm 作为包管理器,更节省空间且速度快
npm install -g pnpm@latest
# 2. 安装 Git
# 手动安装:https://git-scm.com/install/windows 中'Git for Windows/x64 Setup.'下载 exe 安装
# 验证安装:重新打开终端
git --version
CMD 窗口安装:
# 1. 设置国内镜像加速
npm config set registry https://registry.npmmirror.com
# 2. 【关键】安装 OpenClaw(跳过可选依赖 + 忽略编译脚本)
npm install -g openclaw@latest --omit=optional --ignore-scripts
# 3. 验证安装
where openclaw
openclaw --version
下载并安装 LMStudio(0.4.6 版本)。
如 Qwen3.5-0.8B-GGUF(Q4_K_M):
模型搜索图标(小机器人加放大镜符号);Download Options 里选择模型文件版本(如 Q4_K_M);Download 按钮开始下载。Developer 图标(类似终端符号);+ Load Model 按钮;手动选择模型加载参数;上下文长度,可设置模型支持最大 token 数;加载模型。Local Server 标签页;Server: Running;http://127.0.0.1:1234。# 记下返回的模型 ID,如 qwen3.5-0.8b
# 方式一:打开 CMD 测试
curl http://127.0.0.1:1234/v1/models
# 方式二:浏览器访问 http://127.0.0.1:1234/v1/models
以【管理员身份】运行 CMD:
openclaw onboard --install-daemon --skip-skills
会弹出新窗口启动服务。如果没有,使用命令前台调试:
openclaw gateway run --verbose --ws-log full
配置输出示例:
🦞 OpenClaw 2026.3.2 (85377a2) — Welcome to the command line
Windows detected — OpenClaw runs great on WSL2!
...
Security warning — please read.
By default, OpenClaw is a personal agent: one trusted operator boundary.
...
Gateway port: 18789
Gateway bind: Loopback (127.0.0.1)
Model ID: qwen3.5-0.8b
Endpoint compatibility: OpenAI-compatible
Feishu: needs app credentials
...
Web UI: http://127.0.0.1:18789/
访问飞书开放平台:https://open.feishu.cn/app;
点击「创建企业自建应用」;
填写应用信息:
点击「创建」。
点击左侧菜单「添加应用能力」;
选择「机器人」 → 点击「添加」。
在「凭证与基础信息」页面记录:
| 字段 | 用途 |
|---|---|
| App ID | 配置必填(如 cli_xxxxxxxxxx) |
| App Secret | 配置必填(查看并复制) |
点击左侧菜单「权限管理」;
点击「批量导入/导出权限」 → 「导入」;
JSON 中,添加以下权限:
{"scopes":{"tenant":["contact:contact.base:readonly","contact:user.base:readonly","im:chat:readonly","im:message","im:message.group_at_msg:readonly","im:message.group_msg","im:message.p2p_msg:readonly","im:message:readonly","im:message:recall","im:message:send_as_bot","im:message:update","im:resource"]}}
点击「下一步,确认新增权限」→「申请开通」。
CMD 中运行以下命令:
openclaw plugins install @openclaw/feishu
输出显示插件安装成功,提示重启网关。
CMD 中运行以下命令,根据交互式提示完成配置:
openclaw channels add
配置流程包括:
openclaw gateway restart
观察日志输出,确认 feishu 插件已注册,WebSocket 连接成功。
重要顺序:先完成 OpenClaw 侧配置并启动服务,再在飞书后台保存,否则 WebSocket 连接会失败!
点击左侧菜单「事件与回调」 → 「事件配置」;
订阅方式选择:「订阅方式」 → 选择「使用 长连接 接收事件」→「保存」;
下拉点击「添加事件」,搜索并添加:im.message.receive_v1
勾选「启用」。
点击左侧菜单「版本管理与发布」;
点击「创建版本」;
填写版本号(如 1.0.0)和更新说明;
点击「保存」 →「确认发布」;
等待状态变为「已启用」。
打开飞书应用,搜索并打开「OpenClaw 大虾机」,开启对话框。
发送任意消息。机器人会回复包含配对码的消息,如:
OpenClaw: access not configured. Your Feishu user id: ou_5cc1xxxxxxxxxxxxxxxxxxxxxxxxx
Pairing code: D8xxxxxxxx
Ask the bot owner to approve with: openclaw pairing approve feishu D8xxxxxxxx
复制配对码,在 OpenClaw 终端中执行批准命令:
# 查看待审批列表
openclaw pairing list feishu
# 批准配对(将 <CODE> 替换为实际配对码)
openclaw pairing approve feishu <CODE>
输出应显示 Approved feishu sender ou_xxx。此后该用户即可正常对话。
打开飞书应用,搜索并打开「OpenClaw 大虾」,开始对话。
你能干嘛?(回复该 AI 助手能力)
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online