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

OpenClaw 接入飞书实现本地化 AI 助手部署

介绍如何在本地环境部署开源 AI 智能体 OpenClaw，并集成至飞书机器人。内容涵盖环境准备、Node.js 安装、模型配置（以通义千问为例）、飞书应用创建与权限设置、以及常用命令管理。通过本地化部署保障数据隐私，实现自然语言指令控制电脑任务。

锁机制发布于 2026/4/6更新于 2026/5/2348 浏览

一、OpenClaw 是什么？

OpenClaw（前身为 ClawdBot / Moltbot）是一个开源 AI 智能体项目。与 ChatGPT 等云端 AI 不同，OpenClaw 运行在你自己的本地环境（个人电脑或云服务器）中，核心理念是'将控制权交还给用户'。

简单来说，OpenClaw 是一个 AI 网关——它连接了你日常使用的通信工具（如飞书、钉钉、Telegram）和强大的大型语言模型（LLM），让 AI 无缝融入你的工作流，并赋予其操作你电脑的能力。

OpenClaw vs 传统云端 AI
特性OpenClaw传统云端 AI (如 ChatGPT)
部署位置本地服务器或个人电脑供应商的云服务器
数据隐私数据完全由用户掌控，存储在本地数据存储在云端，由服务商管理
系统访问可读写文件、执行 Shell 命令、控制浏览器无法访问本地系统
主动性支持定时任务和外部事件触发只能被动响应用户输入
平台集成飞书、钉钉、Telegram 等多平台局限于自身网页或 App
可扩展性开放的技能和插件系统定制能力有限
为什么要接入飞书？

将 OpenClaw 接入飞书后，你可以直接在飞书聊天窗口中用自然语言指挥 AI 完成各种任务——整理文件、查询资料、运行代码、发送报告，无需在多个应用之间切换。同时，OpenClaw 的本地化部署确保所有数据都留在企业内部，满足数据安全合规要求。

二、准备工作

2.1 硬件与系统要求
项目最低要求推荐要求
操作系统Linux / macOS / Windows (WSL2)Ubuntu 22.04 LTS
内存 (RAM)2 GB4 GB 或更高
网络能访问 GitHub 和 npm 仓库稳定的网络连接

⚠️ 注意：内存低于 2GB 在安装时极易因 OOM 而失败。如果内存有限，请务必先配置 Swap 交换空间（后文 FAQ 中有详细步骤）。

2.2 安装 Git
sudo apt update
sudo apt install git -y
2.3 安装 Node.js（≥ 22.x）

推荐使用 nvm 管理 Node.js 版本：

# 国内镜像安装 nvm
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 重新加载环境变量
source ~/.bashrc
# 安装 Node.js v22
nvm install 22
# 验证
node -v
# 预期输出：v22.x.x
2.4 准备账号

你需要准备两个账号：

① 飞书账号：前往 飞书官网 注册，需要有创建企业自建应用的权限。

② AI 模型 API Key：OpenClaw 本身不提供 AI 计算能力，需要调用第三方 LLM 的 API。推荐以下服务商：

模型服务商推荐理由官网
通义千问 (Qwen)免费额度充足，支持 OAuth，配置简单tongyi.aliyun.com
KIMI (Moonshot AI)长文本处理能力强，中文理解出色kimi.ai
智谱 GLM性价比高，综合能力均衡bigmodel.cn

本文以通义千问为例进行演示。

三、安装并配置 OpenClaw

3.1 一键安装

打开终端，执行：

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

安装成功后会看到如下输出：

🦞 OpenClaw Installer ✓ Detected: linux ✓ Node.js v22.22.0 found ✓ Git already installed → Installing OpenClaw 2026.2.6-3... ✓ OpenClaw installed 🦞 OpenClaw installed successfully (2026.2.6-3 )!
3.2 初始化配置向导

安装完成后会自动进入 openclaw onboard 交互式配置。按以下步骤操作：

第一步：安全风险确认 → 选择 Yes 并回车

第二步：选择模式 → 选择 QuickStart（推荐新手使用）

3.3 配置 AI 大模型

这是配置的核心步骤，需要关联一个 LLM 作为 OpenClaw 的'大脑'。

第一步：选择模型服务商 → 选择 Qwen (OAuth)

第二步：完成 OAuth 授权

终端会显示一个授权链接：

◇ Qwen OAuth ─────────────────────────────────────╮ │ │ │ Open https://chat.qwen.ai/authorize?... │ │ to approve access. │ │ │ ├────────────────────────────────────────────────────╯ ◓ Waiting for Qwen OAuth approval…...

复制链接在浏览器中打开，登录通义千问并点击允许授权。

第三步：选择默认模型 → 直接回车选择默认的 Keep current (qwen-portal/coder-model)

后续向导会询问是否配置 Channel 和 Skills，暂时都选择 Skip for now，我们在下一步专门配置飞书。

四、对接飞书机器人（核心步骤）

这是整个流程最关键的部分，分为三个阶段：飞书创建应用 → OpenClaw 配置连接 → 飞书完成握手。

4.1 飞书侧：创建机器人应用

① 创建企业自建应用

  1. 访问 飞书开放平台，登录后进入开发者后台
  2. 点击创建应用 → 选择企业自建应用
  3. 填写应用名称（如'我的 AI 助手'）和描述

② 获取 App ID 与 App Secret

在应用详情页左侧导航栏，点击凭证与基础信息，记录下 App ID 和 App Secret，这是连接 OpenClaw 的关键凭证。

③ 启用机器人能力

在左侧导航栏找到应用能力 → 机器人，点击进入并为机器人起一个名字（如'智能小爪'）。

4.2 OpenClaw 侧：配置连接

回到服务器终端，执行：

openclaw config

在交互式菜单中依次操作：

  1. 选择 Channels（渠道）
  2. 选择 Feishu/Lark (飞书)
  3. 输入上一步获取的 Feishu App ID 和 Feishu App Secret
  4. 域名选择：Feishu (feishu.cn) - China
  5. 群聊策略：Open - respond in all groups (requires mention)
  6. 选择 Finished (Done) 结束配置

重启服务使配置生效：

openclaw gateway restart
4.3 飞书侧：完成握手

回到飞书开发者后台，完成最后三步配置。

① 配置事件订阅

  1. 左侧导航栏 → 事件与回调
  2. 将订阅方式切换为 使用长连接接收事件
  3. 如果 OpenClaw 服务已正常运行，连接状态会显示'已连接'
  4. 点击添加事件，搜索并勾选 im:message:receive_v1（接收消息）

② 分配应用权限

进入权限管理，搜索并开通以下权限：

权限标识类型说明
contact:user.base:readonly用户信息获取基础用户信息
im:message消息收发消息（建议全部勾选）
im:message.p2p_msg:readonly私信读取机器人的私信消息
im:message.group_at_msg:readonly群聊接收群内@机器人的消息
im:message:send_as_bot发送以机器人身份发送消息
im:resource媒体上传/下载图片和文件

③ 发布应用

  1. 左侧导航栏 → 版本管理与发布
  2. 点击创建新版本，填写版本说明
  3. 点击保存 → 申请线上发布
  4. 等待管理员审批通过

五、开始使用

5.1 找到你的机器人

应用发布成功后，在飞书客户端中：

• 通过左侧导航栏的'应用'或'工作台'找到你的应用 • 或直接在搜索框中搜索机器人名字

5.2 首次交互设置

第一次对话时，机器人需要知道如何称呼你。发送 Hello 后，按提示设置：

Name: OpenClaw My Name: 老板

设置完成后，AI 助手就正式准备好为你服务了。

5.3 常用指令示例

你可以直接在飞书对话框中用自然语言下达指令：

场景示例指令
文件整理'帮我把下载文件夹里上周的截图都移动到一个叫'上周截图'的文件夹里'
网页摘要'帮我总结一下这个页面的内容：https://example.com/article'
代码编写'写一个 Python 脚本，批量将当前目录下的 .jpg 文件转换为 .png 格式'
数据查询'连接本地数据库，查询上周的销售数据并生成报表'

六、进阶管理

6.1 访问 Web UI 管理面板

OpenClaw 提供了可视化的 Web 管理界面，默认监听 127.0.0.1:18789。通过 SSH 隧道从本地访问：

第一步：在本地电脑建立 SSH 隧道

ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP

第二步：在服务器终端获取访问链接

openclaw dashboard

复制输出的 http://127.0.0.1:18789/#token=... 链接，在本地浏览器中打开即可。

6.2 常用命令速查表
命令功能
openclaw status查看各项服务运行状态
openclaw gateway restart重启网关服务（修改配置后必须执行）
openclaw update更新到最新版本
openclaw onboard重新进入配置向导
openclaw health系统健康检查
openclaw doctor深度诊断工具
openclaw security audit安全审计
openclaw uninstall完全卸载

七、常见问题 FAQ

Q1：安装时提示 npm install failed 或进程卡住？

原因：服务器内存不足。

解决：配置 Swap 交换空间：

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 开机自动挂载
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
Q2：执行 openclaw 提示 command not found？

解决：

  1. 关闭终端重新打开
  2. 执行 source ~/.bashrc 重新加载环境变量
  3. 以上无效则重启服务器
Q3：安装飞书插件提示 Cannot find module 'zod'？

解决：

npm install -g zod
rm -rf ~/.openclaw/extensions/feishu
openclaw config # 重新添加飞书渠道
Q4：飞书后台长连接状态显示'未连接'？

排查步骤：

  1. 运行 openclaw status 确认 Gateway 处于 running 状态
  2. 核对 ~/.openclaw/openclaw.json 中的 appId 和 appSecret 是否正确
  3. 执行 openclaw gateway restart 重启服务
  4. 检查服务器防火墙是否阻止了飞书的连接
Q5：机器人配置完成后发消息没反应？

排查步骤：

  1. 检查飞书后台'权限管理'中所有必需权限是否已开通
  2. 确认'事件与回调'中已添加 im:message:receive_v1 事件
  3. 每次修改权限或事件后，必须到'版本管理与发布'创建新版本并发布
Q6：OpenClaw、Clawdbot、Moltbot 是什么关系？

它们是同一个项目的不同曾用名。最初叫 Clawdbot，后更名 Moltbot，最终定名 OpenClaw。

八、成本说明

OpenClaw 本身完全免费开源，但运行会产生两方面成本：

成本项说明
服务器入门级云服务器（2 核 4G）即可，月费几十到上百元；也可用闲置电脑
AI 模型 API取决于使用频率和模型定价。推荐通义千问的免费额度，可零成本入门

目录

  1. 一、OpenClaw 是什么？
  2. OpenClaw vs 传统云端 AI
  3. 为什么要接入飞书？
  4. 二、准备工作
  5. 2.1 硬件与系统要求
  6. 2.2 安装 Git
  7. 2.3 安装 Node.js（≥ 22.x）
  8. 国内镜像安装 nvm
  9. 重新加载环境变量
  10. 安装 Node.js v22
  11. 验证
  12. 预期输出：v22.x.x
  13. 2.4 准备账号
  14. 三、安装并配置 OpenClaw
  15. 3.1 一键安装
  16. 3.2 初始化配置向导
  17. 3.3 配置 AI 大模型
  18. 四、对接飞书机器人（核心步骤）
  19. 4.1 飞书侧：创建机器人应用
  20. 4.2 OpenClaw 侧：配置连接
  21. 4.3 飞书侧：完成握手
  22. 五、开始使用
  23. 5.1 找到你的机器人
  24. 5.2 首次交互设置
  25. 5.3 常用指令示例
  26. 六、进阶管理
  27. 6.1 访问 Web UI 管理面板
  28. 6.2 常用命令速查表
  29. 七、常见问题 FAQ
  30. Q1：安装时提示 npm install failed 或进程卡住？
  31. 开机自动挂载
  32. Q2：执行 openclaw 提示 command not found？
  33. Q3：安装飞书插件提示 Cannot find module 'zod'？
  34. Q4：飞书后台长连接状态显示“未连接”？
  35. Q5：机器人配置完成后发消息没反应？
  36. Q6：OpenClaw、Clawdbot、Moltbot 是什么关系？
  37. 八、成本说明
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 2025 年广东省人工智能赋能制造业高质量发展公需课考核题及答案
  • Java 算法：前缀和进阶应用
  • Awesome GitHub Copilot 自定义功能介绍
  • Jetpack Activity Results API 详解与源码分析
  • RTX5060 显卡 PyTorch 与 CUDA 环境适配方案
  • 安卓手机使用 Termux 部署 AstrBot 与 NapCat 搭建 QQ 机器人
  • 滑动窗口算法：长度最小的子数组
  • C++ 四十年演进史与命名空间基础
  • IntelliJ IDEA Git 暂存（Stash）功能详解
  • 大疆无人机开发实战：MSDK/PSDK/上云 API 指南
  • Java 编译警告：源发行版 17 需要目标发行版 17 排查指南
  • VSCode Copilot 认证失败排查与修复实战
  • Vue Router 核心功能详解：导航守卫与状态管理
  • C++ Lambda 表达式详解
  • VLA 机器人革命：解析 10 篇关键视觉 - 语言 - 动作模型论文
  • Python、PyCharm 与 Anaconda 的关系解析及环境配置指南
  • Sebastian Raschka 新书发布：从零开始构建大型语言模型
  • 2026 高校论文 AI 率新规与 AIGC 检测要求汇总
  • Llama-2-7b 在昇腾 NPU 上的六大核心场景性能基准
  • Stable Diffusion 画质增强：Consistency Decoder 使用教程

相关免费在线工具

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online