跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI大前端

基于 OpenClaw 打造飞书 AI 办公机器人:本地模型与技能自动化实战

综述由AI生成基于 OpenClaw 框架搭建飞书 AI 办公机器人,涵盖本地 Ollama 模型接入与云端模型切换方案。教程详解了环境初始化、守护进程配置及 contextWindow 参数修正方法,解决常见报错。通过飞书开放平台创建企业自建应用,完成长连接订阅与配对流程。支持自动安装 find-skills、playwright 等扩展技能,实现浏览器操作、地图数据可视化等功能,助力办公场景智能化落地。

落日余晖发布于 2026/4/8更新于 2026/5/2113 浏览
基于 OpenClaw 打造飞书 AI 办公机器人:本地模型与技能自动化实战

基于 OpenClaw 搭建飞书 AI 办公机器人

本文将带你从零开始,使用 OpenClaw 框架构建一个支持飞书集成的 AI 办公机器人。我们将涵盖环境配置、本地 Ollama 模型接入、飞书应用对接以及自动化技能的扩展。

1. 环境准备与初始化

首先克隆项目并进入目录:

git clone https://github.com/openclaw/openclaw
cd openclaw

文章配图

检查 Node.js 版本是否不低于 22,若未安装请自行补全。接着全局安装 pnpm 作为包管理器,并安装项目依赖:

node --version
npm install -g pnpm
pnpm install

文章配图

首次运行需要构建 Web UI 和主程序:

pnpm ui:build
pnpm build

文章配图

执行配置向导以安装守护进程并完成初始化:

pnpm openclaw onboard --install-daemon

按提示选择 Yes 确认操作。

文章配图

2. 模型配置与调试

在向导中选择模型提供商。如果没有特定密钥可跳过。对于本地模型,推荐使用 vLLM(需 Linux CUDA 环境)或 Custom Provider。

Custom Provider 最为灵活,支持连接任何兼容 OpenAI 或 Anthropic 的端点,包括托管服务和自托管服务。

支持的常见本地后端:

  • ✅ Ollama(自动检测)
  • ✅ vLLM (localhost:8000/v1)
  • ✅ LM Studio (localhost:1234/v1)
  • ✅ llama.cpp (localhost:8080/v1)
  • ✅ Text Generation WebUI

a) 本地模型接入与报错处理

填写 Endpoint ID 后,如果提示 alias 被占用,可以不填 Model alias,或者清理用户隐藏目录 .openclaw/openclaw.json 中的冲突配置。

文章配图

如果遇到长时间无响应或报错,建议在新终端查看日志:

pnpm openclaw logs --follow

关键报错通常指向上下文窗口不足。OpenClaw 2026.2 版本要求 contextWindow 必须 ≥ 16000,但默认向导仅设为 4096。

文章配图

退出当前会话后,编辑配置文件调整参数:

// .openclaw/openclaw.json
{
  "contextWindow": 16000
}

重启网关服务:

pnpm openclaw gateway restart

再次通过 TUI 输入问题测试,应能正常回答。

文章配图

b) 云端模型切换

如需使用云端模型,按流程注册账号并验证激活。密码需包含数字及大小写字母。

文章配图

按需安装对接插件,无需则选 Skip。

3. 飞书应用对接

下载飞书插件后,登录 飞书开放平台 创建企业自建应用。

  1. 基础信息:填写应用名称和描述,点击创建。
  2. 凭证管理:复制 APP ID 和 APP Secret。
  3. 发布版本:填写版本号及更新说明,保存并发布。

文章配图

将凭证粘贴回 OpenClaw 配置界面,选择中国版飞书。

群聊响应策略建议:

选项效果适用场景
Allowlist仅在指定群聊响应推荐,安全可控
Open所有群聊都响应(需@)团队小、群少
Disabled完全不在群聊响应仅私聊使用

若担心误触,建议选择 Allowlist 并在配置文件中指定允许响应的群 ID。

后续安装 Skills 时,Hooks 部分建议先 Skip,熟悉后再根据需求开启。例如 session-memory 可提升长期对话体验。

文章配图

配置完成后,可通过浏览器访问 http://127.0.0.1:18789/chat?session=main 修改配置,或直接启动 Dashboard。

回到飞书应用后台,添加机器人能力,创建新版本。订阅方式选择长连接,并添加以下四个事件:

  1. 用户进入与机器人的会话
  2. 解散群
  3. 机器人进群
  4. 接收消息

发布后,在飞书测试中若出现配对码,需在终端执行命令批准:

pnpm openclaw pairing approve feishu <code>

激活后即可在飞书中测试对话,并支持随时切换模型。

4. 技能扩展与自动化

OpenClaw 的强大之处在于其 Skill 生态。我们可以动态安装工具来增强机器人能力。

安装 find-skills

执行以下命令安装发现技能的工具:

npx skills add https://github.com/vercel-labs/skills --skill find-skills

选择 OpenClaw 环境,全局安装并采用符号链接。安装后可通过 pnpm openclaw skills list 验证。

MacOS 用户建议提前设置权限,否则可能无法加载工具。若遇到任务分析失败,可尝试让机器人自行分析原因并重新加载。

浏览器操作与数据可视化

切换至更智能的模型后,直接指令机器人执行复杂任务,例如打开浏览器获取数据或生成地图可视化。

文章配图

机器人会自动调用 playwright-skill 打开浏览器,获取数据并生成 CSV 下载链接。

文章配图

初始生成的地图可能过于简化,可通过进一步指令优化。如果需要更高精度或美观度,建议更换更强大的模型或调整工具参数。

文章配图

通过以上步骤,我们完成了一个具备本地模型支持、飞书集成及自动化技能扩展能力的 AI 办公机器人部署。

目录

  1. 基于 OpenClaw 搭建飞书 AI 办公机器人
  2. 1. 环境准备与初始化
  3. 2. 模型配置与调试
  4. a) 本地模型接入与报错处理
  5. b) 云端模型切换
  6. 3. 飞书应用对接
  7. 4. 技能扩展与自动化
  8. 安装 find-skills
  9. 浏览器操作与数据可视化
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 大语言模型综述(中):预训练、适配与量化技术详解
  • OpenClaw 在 Windows 环境下的 WSL 部署与飞书配置指南
  • LLaMA-Pro:基于块扩展的大语言模型微调方案
  • 腾讯 Qclaw 内测:基于微信的 AI 智能体工具使用指南
  • RoboBrain2.0 具身大脑模型复现:统一感知、推理与规划能力
  • 斯坦福 2025 AI Index Report 深度解读
  • 阿里开源 PageAgent:让 AI 住进网页,用自然语言操控界面
  • VSCode Github Copilot 使用 OpenAI 兼容自定义模型方法
  • LTX-2.3:开源音视频生成新标杆,单模型同步输出视频与音频
  • 2024 年大模型行业报告:深入解析发展方向与产业现状
  • ComfyUI Mixlab 插件 Whisper.available False 报错修复
  • Web 自动化测试入门:核心概念与 Selenium 实战指南
  • 网络安全入门常见误区与学习路径指南
  • 基于 Nexent 知识库与 MCP 生态打造智能烹饪顾问实战
  • OpenSpec 实战指南:在 Cursor 中落地 AI 原生开发工作流
  • 2026 年 2 月 GitHub 热门项目 Top 10(1)
  • GitHub 连接 443 端口报错及 SSL 证书配置解决方案
  • 大厂 Android 性能优化项目实战:腾讯、字节、阿里等技术解析
  • Hadoop YARN SLS 运行中常见问题及解决方案
  • 二分查找实战:旋转数组最小值与缺失数字求解

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online