跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw 接入飞书机器人并集成 Ollama 本地大模型实战

OpenClaw 接入飞书机器人并集成 Ollama 本地大模型的完整流程涵盖环境准备、模型部署及渠道配置。首先需在本地部署 Ollama 运行 DeepSeek 或 Llama 等模型,随后安装基于 Node.js 的 OpenClaw 框架。关键步骤在于飞书开放平台创建应用并配置权限,通过 onboard 向导或手动命令将飞书渠道接入 OpenClaw,最后完成配对验证。该方案实现了数据本地化处理的智能办公助手,支持模型热切换与系统级技能扩展。

GopherDev发布于 2026/3/24更新于 2026/10/18110 浏览

OpenClaw 接入飞书机器人并集成 Ollama 本地大模型实战

在当前的 AI 技术环境下,出于数据隐私、定制化需求或离线可用的考虑,将本地部署的 AI 大模型接入日常办公软件已成为刚需。本文将带你从零开始,完成以下目标:

  1. 安装 OpenClaw:一个强大的开源个人 AI 助理框架。
  2. 部署 Ollama:在本地运行大模型(如 DeepSeek-R1、Llama 3 等),作为 AI 的'大脑'。
  3. 接入飞书:将你的 AI 助理添加到飞书好友或群聊中,实现随叫随到的智能办公体验。

环境准备与核心思想

开始前,我们需要明确技术架构:飞书 → OpenClaw(调度器) → Ollama(本地模型)。

  • 操作系统:Windows(建议 WSL2)、macOS 或 Linux。本文以 Windows 11 + WSL2 (Ubuntu 22.04) 为例。
  • 硬件要求:
    • CPU:4 核以上(推荐 8 核)
    • 内存:16GB 以上(若运行 7B-8B 模型,需预留 8-10GB 内存给模型)
    • 磁盘:20GB 以上剩余空间。

部署 Ollama——把大模型'养'在本地

Ollama 是目前最便捷的本地模型运行工具,支持 Llama 3、DeepSeek-R1、Qwen 2.5 等一系列主流模型。

1. 安装 Ollama

访问 Ollama 官网下载对应系统的安装包,或使用命令行安装(以 Linux/WSL 为例):

curl -fsSL https://ollama.com/install.sh | sh

安装完成后,验证版本:

ollama --version

并通过 ollama serve 确保服务在后台运行(通常安装后会自动注册为服务)。

2. 拉取并运行模型

根据你的硬件配置选择合适的模型。对于大多数用户,推荐使用 DeepSeek-R1(7B)或 Llama 3.2(3B),兼顾性能与资源占用。

# 运行 DeepSeek-R1(会自动下载)
ollama run deepseek-r1:7b

# 或者运行 Llama 3.2(更轻量)
ollama run llama3.2

出现 Send a message 提示即表示模型启动成功。注意:记下这个终端,后续 OpenClaw 会通过 API 调用它。

3. 确认 API 可用性

Ollama 默认会在本地 11434 端口开启 API 服务。我们可以用 curl 测试一下:

curl http://localhost:11434/api/generate -d'{ "model": "deepseek-r1:7b", "prompt": "你好,你是谁?", "stream": false }'

看到包含'DeepSeek'或对应模型名的 JSON 返回,说明 Ollama 已经准备就绪。

安装 OpenClaw——AI 大脑的'躯干'

OpenClaw 负责连接聊天软件(飞书)和 AI 大脑(Ollama),并管理各种工具(Skills)。

1. 安装 Node.js

OpenClaw 需要 Node.js 22.0 或更高版本。以 Ubuntu 为例:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v

2. 一键安装 OpenClaw

官方提供了一键安装脚本,会自动处理大部分配置。

curl -fsSL https://openclaw.bot/install.sh | bash

安装完成后,执行初始化向导。注意:最新版的向导已经支持直接配置飞书和模型了,非常方便!

openclaw onboard --install-daemon

在向导中:

  • AI 模型配置:由于我们要用 Ollama,这里可以选择'Other/OpenAI Compatible'。API 地址填:http://localhost:11434/v1/(Ollama 兼容 OpenAI 格式),API Key 可以随便填(如 ollama),模型名填你下载的,比如 deepseek-r1:7b。
  • 通信渠道:先跳过(Telegram/WhatsApp 等),我们后面手动配置飞书。

3. 验证安装

启动服务并检查状态:

openclaw gateway start
openclaw status

此时访问 http://127.0.0.1:18789 应该能看到 OpenClaw 的 Web 控制台(Dashboard)。

打通飞书——创建并配置机器人

这是让 AI'落地'的关键一步,我们需要在飞书开放平台注册一个机器人应用。

1. 创建飞书应用

  1. 登录飞书开发者后台。
  2. 点击'创建企业自建应用',填写名称和描述,上传头像。
  3. 创建成功后,进入应用详情页,点击左侧'凭证与基础信息',记录下 App ID 和 App Secret(非常重要!)。

2. 配置机器人能力

  1. 在左侧'添加应用能力'中,点击'机器人'进行添加。
  2. 点击左侧'权限管理',为机器人开通必要权限。最简单的方法是搜索并添加以下权限:
    • im:message 相关的收发权限(im:message:send_as_bot, im:message.group_msg, im:message.p2p_msg)。
    • contact:contact.base:readonly(读取通讯录,用于识别@你的人)。
    • 如果有操作文档的需求,还需开通文档相关的权限。
  3. 点击左侧'事件与回调',选择'事件配置'。
    • 订阅方式选择'使用长连接接收事件'(开发测试阶段最方便)。点击保存。
    • 添加事件:搜索并添加 im.message.receive_v1(接收消息事件)。

3. 发布应用

  1. 点击左侧'版本管理与发布',创建一个版本,填写版本日志。
  2. 点击'申请发布'(如果是你自己的企业,审核会秒过,直接发布成功)。
  3. 发布后,在飞书搜索框搜索你的应用名称,找到它并发送一条消息'你好',此时应该收到来自飞书官方的'配对码'提示,因为我们的后端还没连上。

OpenClaw 与飞书'握手'

现在,我们要让 OpenClaw 认识这个飞书机器人。

方法一:使用 onboard 向导重新配置(推荐最新版)

openclaw onboard

当问到渠道时,选择 feishu,并输入刚才拿到的 App ID 和 App Secret。

方法二:手动添加渠道

如果已经完成了 onboard,可以使用 channels 命令:

openclaw channels add
# 选择 feishu,按提示输入 APP ID 和 APP SECRET

配置完成后,必须重启网关才能使配置生效:

openclaw gateway restart
# 或者旧版本命令 openclaw-cn gateway restart

查看实时日志,确认飞书连接是否成功:

openclaw logs --follow

看到类似 Feishu client connected 或 login success 的字样,说明连接成功。

批准配对

再次回到飞书,向你的机器人发送任意消息(例如'你好')。此时,飞书机器人会回复一串 Pairing code: xxxx-xxxx。在命令行中执行批准命令:

openclaw pairing approve feishu <你收到的 code>

实战测试与玩法拓展

现在,你的飞书 AI 助理已经可以工作了。你可以把它拉到群里,或者私聊。

1. 本地能力测试

在飞书里输入指令:

  • '帮我看看我电脑的存储占用情况'(如果 OpenClaw 配置了相关系统 Skill,它会执行命令并返回结果)。
  • '帮我整理桌面的文件夹,按类型分类'。

2. 结合 Ollama 的优势

由于我们用的是 Ollama,你可以随时切换模型而无需重启 OpenClaw。只需修改 OpenClaw 配置中的模型名,或者通过 OpenClaw 的 TUI 界面临时切换模型。

# 在 OpenClaw 的 TUI 界面 /model deepseek-r1:7b

3. 云端模型备用

如果你的本地机器性能不足,或者需要处理超长文本,Ollama 也支持调用云端模型(如 GLM4.7 等),可以在配置中随时切换,实现本地与云端的'双模'运行。

常见问题与避坑指南

  1. OpenClaw 提示 command not found
    • 原因:npm 全局路径未加入系统 PATH。
    • 解决:执行 npm prefix -g 找到路径(如 /usr/local),然后将 export PATH="$(npm prefix -g)/bin:$PATH" 加入 ~/.bashrc 或 ~/.zshrc。
  2. 飞书机器人无响应
    • 检查步骤:
      1. openclaw status 确认网关运行。
      2. 日志中是否有飞书连接报错(检查 APP ID/Secret 是否正确)。
      3. 检查 OpenClaw 的配置文件 ~/.openclaw/openclaw.json,确保 feishu 配置块存在且 enabled 为 true。
  3. Ollama 模型推理速度慢
    • 优化:关闭其他大型应用释放内存;尝试使用量化版本模型(如 deepseek-r1:7b-q4_0);确认 Ollama 是否成功利用了 GPU(ollama run deepseek-r1:7b --verbose 查看日志)。
  4. 飞书长连接配置失败
    • 如果 onboard 向导报错,可以先用飞书官方的'Python 示例代码'建立一个临时连接,让飞书后台通过验证,然后再切回 OpenClaw。

总结

通过 OpenClaw + Ollama + 飞书的组合,我们成功搭建了一个完全私有、免费、可定制的 AI 助理。它不仅能在日常聊天中提供帮助,还能通过 OpenClaw 强大的'技能'体系,真正去操作你的电脑、管理文件、甚至执行代码。

这套方案将数据留在本地,既保证了隐私安全,又锻炼了动手能力。现在,去给你的 AI 助理添加更多酷炫的技能吧!

目录

  1. OpenClaw 接入飞书机器人并集成 Ollama 本地大模型实战
  2. 环境准备与核心思想
  3. 部署 Ollama——把大模型“养”在本地
  4. 1. 安装 Ollama
  5. 2. 拉取并运行模型
  6. 运行 DeepSeek-R1(会自动下载)
  7. 或者运行 Llama 3.2(更轻量)
  8. 3. 确认 API 可用性
  9. 安装 OpenClaw——AI 大脑的“躯干”
  10. 1. 安装 Node.js
  11. 2. 一键安装 OpenClaw
  12. 3. 验证安装
  13. 打通飞书——创建并配置机器人
  14. 1. 创建飞书应用
  15. 2. 配置机器人能力
  16. 3. 发布应用
  17. OpenClaw 与飞书“握手”
  18. 方法一:使用 onboard 向导重新配置(推荐最新版)
  19. 方法二:手动添加渠道
  20. 选择 feishu,按提示输入 APP ID 和 APP SECRET
  21. 或者旧版本命令 openclaw-cn gateway restart
  22. 批准配对
  23. 实战测试与玩法拓展
  24. 1. 本地能力测试
  25. 2. 结合 Ollama 的优势
  26. 在 OpenClaw 的 TUI 界面 /model deepseek-r1:7b
  27. 3. 云端模型备用
  28. 常见问题与避坑指南
  29. 总结

更多推荐文章

查看全部
  • 哈希表原理及模拟实现
  • Hunyuan-MT-7B-WEBUI 部署避坑指南与性能优化
  • Spring Boot 4 集成 MyBatis-Plus 实战指南
  • 动态规划专题:子序列问题的核心思路与实战
  • AI 代码安全新纪元:Claude Code Security 深度解析与实战
  • Flutter 与 Web 混合开发实践
  • 手势控制电脑方案分析与 Python 实战
  • FUXA:基于 Web 的 HMI-SCADA-Dashboard 可视化组态平台
  • 线性 DP 经典四题详解:台阶、子段和、传球与乌龟棋
  • LLaMA Factory 本地部署与依赖安装指南
  • 在C语言中连接MySQL:用户创建、权限配置与查询示例
  • 基于 CloudBase AI ToolKit 构建智能医疗网站实战
  • FPGA 以太网接口设计:纯 Verilog 实现 UDP/TCP 协议与校验重发
  • 基于 IDEA 搭建 Spring Boot + MyBatis + MySQL 工程实践
  • 生成式 AI 落地现状:19 个场景、26 个行业与 106 个案例深度分析
  • 低代码平台在人事管理中的应用方案
  • 前端流式输出实现详解:从原理到实践
  • Python 核心知识体系与实战技能指南
  • SkyWalking 全链路监控实战:Spring Cloud、Dubbo、RocketMQ 及 ShardingSphere 集成
  • 基于 Llama Factory 搭建大模型微调环境指南

相关免费在线工具

  • 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