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

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

通过 OpenClaw 框架连接飞书机器人,结合 Ollama 本地部署的大语言模型(如 DeepSeek-R1),实现私有化、低延迟的智能办公助手。教程涵盖环境搭建、应用配置、权限开通及联调测试,确保数据不出本地即可享受 AI 能力。

SqlMaster发布于 2026/4/6更新于 2026/9/970 浏览

在 AI 技术爆发的当下,出于数据隐私、定制化需求或离线可用的考虑,本地部署 AI 大模型并接入日常办公软件成为了新的刚需。本文将带你从零开始,完成以下目标:安装 OpenClaw(一个强大的开源个人 AI 助理框架),部署 Ollama(在本地运行大模型),以及接入飞书(将 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. 环境准备与架构思路
  2. 部署 Ollama——把大模型“养”在本地
  3. 1. 安装 Ollama
  4. 2. 拉取并运行模型
  5. 运行 DeepSeek-R1(会自动下载)
  6. 或者运行 Llama 3.2(更轻量)
  7. 3. 确认 API 可用性
  8. 安装 OpenClaw——AI 大脑的“躯干”
  9. 1. 安装 Node.js
  10. 以 Ubuntu 为例
  11. 检查版本
  12. 2. 一键安装 OpenClaw
  13. 3. 验证安装
  14. 打通飞书——创建并配置机器人
  15. 1. 创建飞书应用
  16. 2. 配置机器人能力
  17. 3. 发布应用
  18. OpenClaw 与飞书“握手”
  19. 方法一:使用 onboard 向导重新配置(推荐最新版)
  20. 方法二:手动添加渠道
  21. 选择 feishu,按提示输入 APP ID 和 APP SECRET
  22. 或者旧版本命令 openclaw-cn gateway restart
  23. 批准配对
  24. 实战测试与玩法拓展
  25. 1. 本地能力测试
  26. 2. 结合 Ollama 的优势
  27. 在 OpenClaw 的 TUI 界面 /model deepseek-r1:7b
  28. 3. 云端模型备用
  29. 常见问题与避坑指南
  30. 总结

更多推荐文章

查看全部
  • 路径类动态规划入门:最小路径和、迷雾森林及过河卒
  • 机器人 DH 参数模型与正运动学
  • Spring MVC 参数绑定详解:单多参/对象/集合/JSON/文件上传
  • Coze 智能体开发与工作流实践
  • QGroundControl 跨平台安装指南:Windows、macOS、Linux 与 Android 部署
  • 2025 年学生常用 AI 降重工具指南
  • Java JDK 安装与环境配置教程
  • 中国信通院 2024 大模型典型示范应用案例集与学习指南
  • 线程池单例、线程安全、重入与死锁
  • P2P 网络(Peer-to-Peer Network)基础架构与区块链应用
  • ESP32-S3结合百度文心一言大模型打造智能语音助手(从零实现自定义唤醒词与多API集成)
  • 多模态 AI 技术解析与未来人机交互演进
  • 通义万相 2.1 文生视频技术解析与多显卡性能测试
  • 冷启动数据与多阶段训练在 DeepSeek 模型中的作用
  • AIGC 技术如何颠覆娱乐产业的创意与生产
  • AI 从“能说会道”到“自主思考”:技术演进与应用全景
  • 数据洞察系统 InsightPilot 技术解析与架构分析
  • HarmonyOS 5.0 物联网开发:基于星闪技术的智能家居边缘计算网关
  • NVIDIA Jetson 部署 LeRobot 端到端机器人学习流程
  • 2019 年 CSP-S 提高组初赛真题解析:C++ 选择题 1-5

相关免费在线工具

  • 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