开源 AI 智能体项目 OpenClaw 的安装部署及与飞书平台的集成方法。内容涵盖环境准备（Node.js、Git）、OpenClaw 一键安装与初始化配置、AI 模型（如通义千问）API 对接、飞书自建应用创建与权限设置、事件订阅配置以及常见问题排查。通过本地化部署实现数据隐私保护，用户可在飞书聊天窗口中利用自然语言指挥 AI 完成文件整理、代码执行等任务。
OpenClaw（前身为 ClawdBot / Moltbot）是 2026 年迅速崛起的一个开源 AI 智能体项目。与 ChatGPT 等云端 AI 不同，OpenClaw 运行在你自己的本地环境（个人电脑或云服务器）中，核心理念是'将控制权交还给用户'。
简单来说，OpenClaw 是一个 AI 网关——它连接了你日常使用的通信工具（如飞书、钉钉、Telegram）和强大的大型语言模型（LLM），让 AI 无缝融入你的工作流，并赋予其操作你电脑的能力。
| 特性 | OpenClaw | 传统云端 AI (如 ChatGPT) |
|---|---|---|
| 部署位置 | 本地服务器或个人电脑 | 供应商的云服务器 |
| 数据隐私 | 数据完全由用户掌控，存储在本地 | 数据存储在云端，由服务商管理 |
| 系统访问 | 可读写文件、执行 Shell 命令、控制浏览器 | 无法访问本地系统 |
| 主动性 | 支持定时任务和外部事件触发 | 只能被动响应用户输入 |
| 平台集成 | 飞书、钉钉、Telegram 等多平台 | 局限于自身网页或 App |
| 可扩展性 | 开放的技能和插件系统 | 定制能力有限 |
将 OpenClaw 接入飞书后，你可以直接在飞书聊天窗口中用自然语言指挥 AI 完成各种任务——整理文件、查询资料、运行代码、发送报告，无需在多个应用之间切换。同时，OpenClaw 的本地化部署确保所有数据都留在企业内部，满足数据安全合规要求。
| 项目 | 最低要求 | 推荐要求 |
|---|---|---|
| 操作系统 | Linux / macOS / Windows (WSL2) | Ubuntu 22.04 LTS |
| 内存 (RAM) | 2 GB | 4 GB 或更高 |
| 网络 | 能访问 GitHub 和 npm 仓库 | 稳定的网络连接 |
⚠️ 注意：内存低于 2GB 在安装时极易因 OOM 而失败。如果内存有限，请务必先配置 Swap 交换空间（后文 FAQ 中有详细步骤）。
sudo apt update
sudo apt install git -y
推荐使用 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
你需要准备两个账号：
① 飞书账号：前往 飞书官网 注册，需要有创建企业自建应用的权限。
② AI 模型 API Key：OpenClaw 本身不提供 AI 计算能力，需要调用第三方 LLM 的 API。推荐以下服务商：
| 模型服务商 | 推荐理由 | 官网 |
|---|---|---|
| 通义千问 (Qwen) | 免费额度充足，支持 OAuth，配置简单 | tongyi.aliyun.com |
| KIMI (Moonshot AI) | 长文本处理能力强，中文理解出色 | kimi.ai |
| 智谱 GLM | 性价比高，综合能力均衡 | bigmodel.cn |
本文以通义千问为例进行演示。
打开终端，执行：
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 )!
安装完成后会自动进入 openclaw onboard 交互式配置。按以下步骤操作：
第一步：安全风险确认 → 选择 Yes 并回车
第二步：选择模式 → 选择 QuickStart（推荐新手使用）
这是配置的核心步骤，需要关联一个 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 配置连接 → 飞书完成握手。
① 创建企业自建应用
② 获取 App ID 与 App Secret
在应用详情页左侧导航栏，点击凭证与基础信息，记录下 App ID 和 App Secret，这是连接 OpenClaw 的关键凭证。
③ 启用机器人能力
在左侧导航栏找到应用能力 → 机器人，点击进入并为机器人起一个名字（如'智能小爪'）。
回到服务器终端，执行：
openclaw config
在交互式菜单中依次操作：
重启服务使配置生效：
openclaw gateway restart
回到飞书开发者后台，完成最后三步配置。
① 配置事件订阅
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 | 媒体 | 上传/下载图片和文件 |
③ 发布应用
应用发布成功后，在飞书客户端中：
• 通过左侧导航栏的'应用'或'工作台'找到你的应用 • 或直接在搜索框中搜索机器人名字
第一次对话时，机器人需要知道如何称呼你。发送 Hello 后，按提示设置：
Name: OpenClaw
My Name: 老板
设置完成后，AI 助手就正式准备好为你服务了。
你可以直接在飞书对话框中用自然语言下达指令：
| 场景 | 示例指令 |
|---|---|
| 文件整理 | '帮我把下载文件夹里上周的截图都移动到一个叫'上周截图'的文件夹里' |
| 网页摘要 | '帮我总结一下这个页面的内容：https://example.com/article' |
| 代码编写 | '写一个 Python 脚本，批量将当前目录下的 .jpg 文件转换为 .png 格式' |
| 数据查询 | '连接本地数据库，查询上周的销售数据并生成报表' |
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=... 链接，在本地浏览器中打开即可。
| 命令 | 功能 |
|---|---|
| openclaw status | 查看各项服务运行状态 |
| openclaw gateway restart | 重启网关服务（修改配置后必须执行） |
| openclaw update | 更新到最新版本 |
| openclaw onboard | 重新进入配置向导 |
| openclaw health | 系统健康检查 |
| openclaw doctor | 深度诊断工具 |
| openclaw security audit | 安全审计 |
| openclaw uninstall | 完全卸载 |
原因：服务器内存不足。
解决：配置 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
解决：
解决：
npm install -g zod
rm -rf ~/.openclaw/extensions/feishu
openclaw config # 重新添加飞书渠道
排查步骤：
排查步骤：
它们是同一个项目的不同曾用名。最初叫 Clawdbot，后更名 Moltbot，最终定名 OpenClaw。
OpenClaw 本身完全免费开源，但运行会产生两方面成本：
| 成本项 | 说明 |
|---|---|
| 服务器 | 入门级云服务器（2 核 4G）即可，月费几十到上百元；也可用闲置电脑 |
| AI 模型 API | 取决于使用频率和模型定价。推荐通义千问的免费额度，可零成本入门 |
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online