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

OpenClaw 接入飞书机器人与 Ollama 本地大模型部署指南

本地部署 Ollama 运行大模型,结合 OpenClaw 框架接入飞书机器人。通过配置飞书应用权限、回调地址及配对码,实现私有化 AI 助理在即时通讯软件中的交互。支持本地模型推理与云端备用切换,保障数据隐私的同时提供智能办公能力。

王初壹发布于 2026/3/30更新于 2026/6/1322 浏览

引言

在 AI 技术爆发的当下,出于数据隐私、定制化需求或离线可用的考虑,本地部署 AI 大模型并接入日常办公软件成为了新的刚需。

本文将带你从零开始,完成以下目标:

  1. 安装 OpenClaw:一个强大的开源个人 AI 助理框架(前身为 ClawdBot/Moltbot)。
  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 -
 apt install -y nodejs

node -v
sudo
# 检查版本

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. 第一步:环境准备与核心思想
  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. 以 Ubuntu 为例
  12. 检查版本
  13. 2. 一键安装 OpenClaw
  14. 3. 验证安装
  15. 第四步:打通飞书——创建并配置机器人
  16. 1. 创建飞书应用
  17. 2. 配置机器人能力
  18. 3. 发布应用
  19. 第五步:OpenClaw 与飞书“握手”
  20. 方法一:使用 onboard 向导重新配置(推荐最新版)
  21. 方法二:手动添加渠道
  22. 选择 feishu,按提示输入 APP ID 和 APP SECRET
  23. 或者旧版本命令 openclaw-cn gateway restart
  24. 批准配对
  25. 第六步:实战测试与玩法拓展
  26. 1. 本地能力测试
  27. 2. 结合 Ollama 的优势
  28. 在 OpenClaw 的 TUI 界面 /model deepseek-r1:7b
  29. 3. 云端模型备用
  30. 常见问题与避坑指南
  31. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 无需公网 IP 安全访问本地 AI 服务的实践方案
  • JavaScript 正则表达式详解与使用指南
  • 基于鳄鱼伏击算法的多无人机三维协同路径规划及 Matlab 实现
  • 渗透测试基本流程详解:从信息收集到报告撰写
  • Visual C++ 运行库缺失修复指南
  • DJI DroneID 无人机信号解析工具与流程指南
  • Oracle 迁移至 MySQL 的关键差异与注意事项
  • AMD显卡llama.cpp Vulkan后端兼容性问题与部署指南
  • 滑动窗口算法实战:长度最小的子数组与无重复字符的最长子串
  • Vue Skills:让 AI 掌握 Vue 最佳实践
  • Linux 基础命令与文件操作实战笔记
  • 23 个 Python 实战项目与源码实例指南
  • 基于 YOLOv8 的无人机枸杞树病害检测数据集与训练方案
  • Python 基础语法练习题
  • Node.js 安装与环境配置教程
  • Win10/11 系统下 WSL2 安装 Ubuntu 20.04 并迁移至 D 盘指南
  • Git 推送报错 Updates were rejected 常见原因及解决方法
  • Redis 哨兵模式高可用架构部署与优化
  • Elasticsearch 核心概念与 Java 客户端实战
  • 基于 Prophet 的家庭用电数据时间序列预测分析

相关免费在线工具

  • 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