OpenClaw 部署 + 飞书对接完整教程【防踩坑版】

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

本教程基于 Linux 系统实现 OpenClaw 开源本地 AI 助手的部署，以及飞书机器人的完整对接流程，全程实操可落地，强调数据自主可控与隐私安全，适配零基础入门。

OpenClaw（原名 Clawdbot，后更名 Moltbot，2025 年 1 月正式定名）是运行在本地环境的高权限 AI 智能体，核心特性如下：

本地部署：运行在自有服务器/电脑，数据完全自主可控
多平台支持：适配飞书、WhatsApp、Telegram、Discord 等主流聊天工具
浏览器控制：可浏览网页、填写表单、提取网页数据
系统访问：读写文件、执行 Shell 命令、运行脚本
持久化记忆：记住用户偏好和交互上下文
插件扩展：支持社区技能插件，也可自定义开发插件

适用场景：邮件管理、日程安排、数据查询、代码编写、系统运维等，是专属的开源 AI 助手。

环境要求

项目具体要求操作系统 Linux（推荐）/macOS / Windows (WSL2) Node.js ≥ 22.x 内存 ≥ 2GB（建议 4GB，不足需配置 swap）网络可访问 GitHub、npm 仓库（国内服务器需配置代理） AI 模型通义千问、OpenAI、Claude、KIMI 等任一 API Key（通义千问免费额度充足，推荐入门）

部署方式选择

阿里云一键部署（推荐新手）：直接使用阿里云预置镜像，几分钟完成服务器搭建，无需手动配置环境
手动部署：适合有基础的用户，按步骤安装依赖和程序

3.1 方式一：阿里云一键部署（新手首选）

直接使用阿里云 OpenClaw 专属部署方案，无需手动配置依赖、解决环境冲突，几分钟即可完成服务器搭建。访问阿里云 OpenClaw 一键部署地址，按页面提示完成云服务器创建与 OpenClaw 部署即可。部署完成后直接跳至 3.3 初始化配置 步骤。

3.2 方式二：手动安装（分步操作）

步骤 1：安装 Git 版本控制工具

OpenClaw 安装需通过 Git 拉取相关资源，先完成 Git 安装：

步骤 2：安装 Node.js 22.x（核心运行环境）

OpenClaw 要求 Node.js 版本 ≥ 22.x，推荐通过 NVM（Node 版本管理器）安装，适配性更强：

步骤 3：安装 OpenClaw 主程序

通过官方一键安装脚本执行，自动拉取最新版本并完成基础部署：

注意事项：

国内服务器若安装失败，优先检查网络代理是否配置，确保能访问 GitHub、npm 仓库；
其他操作系统（macOS/Windows WSL2）安装方式，参考 OpenClaw 官方安装文档；
安装过程中会自动检测环境，若提示依赖缺失，按控制台提示补充安装即可。

3.3 初始化配置（安装后必做）

主程序安装完成后，控制台会自动进入 OpenClaw 配置向导，按以下固定步骤选择，完成基础初始化：

安全风险确认：控制台弹出安全警告，提示 OpenClaw 具备系统高权限，选择并回车（确认知晓风险并继续）；
配置模式选择：选择（快速配置模式，复杂细节可后续通过命令调整，推荐入门）；
AI 模型服务商选择：选择（通义千问，免费额度充足，无需额外充值，适配中文场景）；
通义千问账号授权：
- 继续选择，控制台会生成一个授权链接和验证码；
- 复制授权链接在本地浏览器打开，按提示登录通义千问账号，若需验证则输入控制台的验证码；
- 授权完成后，控制台提示，表示模型对接成功；
默认模型选择：选择（默认编码模型，兼顾聊天与代码编写，适合入门）；
消息通道选择：选择（先跳过通道配置，后续单独针对性配置飞书通道，避免混乱）；
技能插件配置：选择（暂不配置技能，先完成基础部署，后续按需开启）；
启动方式选择：选择（推荐终端交互界面，轻量且易验证安装结果）。

3.4 安装成功验证

选择 TUI 启动后，控制台会进入 OpenClaw 的终端聊天界面，输入并回车，若控制台出现交互性回复，说明基础安装成功；
若需退出 TUI 界面，按即可，后续可通过命令重新启动服务；
首次验证后，建议先关闭 TUI，继续完成飞书通道配置，避免端口占用。

4.1 查看服务状态

输出包含 Dashboard 地址、系统信息、服务运行状态、内存占用等，若显示，说明服务正常启动。

4.2 访问 Web UI 管理面板

OpenClaw 默认监听，服务器本地可直接访问，远程需通过 SSH 隧道映射端口，步骤如下：

本地执行 SSH 隧道命令（本地电脑终端执行，非服务器）：
输入服务器登录密码，完成端口映射（保持终端窗口打开，不可关闭）；
获取 Web UI 授权链接（服务器终端执行）：
本地浏览器访问：复制控制台输出的（含授权 token），在本地浏览器打开，即可进入 OpenClaw 可视化管理面板，查看聊天记录、配置服务。

4.3 初始化 AI 助手名称

在 TUI 界面或 Web UI 聊天框首次输入后，OpenClaw 会提示设置名称，按以下格式输入即可：

配置后，AI 助手会按该名称进行交互。

5.1 配置 OpenClaw 飞书通道

重新进入配置向导：服务器端执行以下命令，打开通道配置界面：
选择飞书通道：在通道列表中找到并选择；
安装飞书官方插件：控制台提示，选择并回车，自动安装飞书对接所需插件；
插件安装报错处理：若出现错误，说明缺失依赖，执行以下命令修复后，重新配置飞书通道：

5.2 飞书开放平台配置（获取应用凭证）

登录飞书开放平台：访问 https://open.feishu.cn，使用企业飞书账号登录，进入「开发者后台」；;
创建企业自建应用：点击「创建应用」→ 选择「企业自建应用」→ 填写应用名称（如）→ 点击「创建」；
获取核心凭证：进入应用的「凭据管理」页面，复制和（妥善保存，后续需回填到 OpenClaw，不可泄露）；
添加机器人组件：在应用配置页的「功能模块」中，找到并添加「机器人」组件，完成机器人基础名称配置。

5.3 回填飞书凭证到 OpenClaw

控制台会依次弹出输入框，按提示完成信息填写，所有步骤按以下选择执行：

粘贴飞书开放平台获取的，回车；
粘贴飞书开放平台获取的，回车；
飞书域名选择：选择（国内版飞书，企业版均选此项）；
群聊触发策略：选择（所有群聊可 @机器人触发对话，推荐企业使用）；
通道配置完成：在通道列表中选择，完成飞书通道基础配置；
私信权限配置：
- 控制台提示，选择；
- 私信策略选择（允许所有人向机器人发私信，按需选择）；
显示名称配置：选择（暂不配置，后续可在飞书开放平台修改）。

5.4 验证飞书配置文件

配置完成后，可通过查看 OpenClaw 配置文件，确认飞书通道是否开启：

飞书配置段需包含以下核心内容，确保（表示飞书通道已开启）：

5.5 重启 OpenClaw 服务（使配置生效）

重启完成后，控制台会提示，表示飞书通道配置已生效。

5.6 飞书应用最终配置（开放平台端）

飞书机器人需完成事件配置、权限开通、版本发布，才能正常接收消息，步骤如下：

开启长连接模式：飞书开放平台应用页 → 「事件和回调」 → 选择「长连接模式」，页面提示「连接成功」即完成；
添加消息接收事件：在「事件和回调」 → 「添加事件」，搜索并选择「接收消息」事件，添加到应用中；
开通必备权限：进入「权限管理」页面，勾选以下权限（全部开启，缺一不可），并提交审批（企业自建应用审批自动通过）：
权限名称权限作用允许机器人获取用户基础信息允许机器人发送和接收所有消息（含子权限）
发布应用版本：所有配置完成后，进入「版本管理与发布」 → 「创建版本」 → 填写版本描述 → 「发布」；

关键提醒：每次修改飞书应用配置（事件/权限）后，都需要重新创建并发布版本，否则配置不生效。

5.7 飞书机器人测试

飞书客户端中，在「工作台」找到已发布的 OpenClaw 应用，打开聊天窗口；
发送，若收到机器人的回复，说明飞书对接完全成功；
群聊中需 @机器人 并发送消息，机器人才会回复（与群聊策略配置一致）。

命令功能说明查看服务运行状态重新进入配置向导（修改通道/模型）启动 OpenClaw 核心服务停止 OpenClaw 核心服务重启核心服务（配置修改后必用）升级 OpenClaw 到最新版本执行服务健康检查，排查基础问题深度诊断部署/运行问题，给出修复建议获取 Web UI 授权访问链接（含 token）执行深度安全审计，检查权限/风险卸载 OpenClaw（删除所有配置和程序）

说明：OpenClaw 更名前的旧命令仍可使用，与功能完全一致，官方推荐新用户使用命令。

OpenClaw 本身完全免费开源，无任何软件授权费用，仅可能产生以下两类成本，入门阶段可实现 0 成本使用：

7.1 服务器成本

最低配置的云服务器（1 核 2G）即可满足运行要求，月均费用较低；若使用本地电脑/服务器部署，无此成本。推荐阿里云一键部署方案，省去环境配置时间，云服务器可按需选择配置。

7.2 AI 模型 API 调用成本

OpenClaw 需对接 AI 模型才能实现交互，各服务商均提供免费额度，入门推荐通义千问，免费额度充足，无需充值，具体模型对比：

模型服务商免费额度适合场景通义千问（Qwen）充足（长期有效）入门首选、中文场景、日常办公/代码编写小米 MiMo 免费试用额度成本敏感用户、轻量聊天场景 KIMI (Moonshot) 每日免费额度中文理解能力强、长文本处理（如文档总结） GLM 4.7 (Z.AI) 免费额度性价比高、企业办公/数据查询场景 OpenAI GPT 新用户试用额度（后续付费）英文场景、高精度代码编写 Anthropic Claude 付费（无免费额度）复杂任务处理、专业代码开发

8.1 安装时提示？

原因：服务器内存不足（新版本 OpenClaw 对内存要求提升，2G 内存易出现 OOM 内存溢出）；
解决方案：配置 swap 交换空间，将硬盘空间作为虚拟内存使用，执行以下命令：

8.2 飞书机器人配置后无法收到消息？

按以下优先级顺序排查，90% 的问题可解决：

确认 OpenClaw 飞书通道已开启（配置文件中）；
检查和是否填写正确（无空格/输错）；
确认飞书开放平台已添加「接收消息」事件，且开启长连接模式；
检查和权限是否全部开通并审批；
确认应用已发布新版本（配置修改后未发布是最常见问题）；
执行重启服务，飞书客户端退出重新进入。

8.3 服务器终端提示？

原因：NVM 环境变量未加载，导致命令无法识别；
解决方案：

关闭当前服务器终端，重新打开后再次尝试；
手动重新加载环境变量：；
若仍无效，执行诊断问题，按提示修复；
最后尝试重启服务器，彻底加载环境变量。

8.4 安装过程中控制台卡住不动？

按中断当前操作，避免占用服务器资源；
执行检查环境/网络问题，按控制台提示修复；
排查服务器网络：确保能正常访问 GitHub、npm 仓库（国内服务器需配置代理）；
重新执行，重新进入配置向导。

8.5 端口 18789 被占用，无法启动 Web UI？

使用参数指定其他端口启动服务，示例如下（端口可自定义，如 ¹⁸⁷⁹⁰⁄₁₈₇₉₁）：

8.6 OpenClaw 的数据是否安全？

核心安全：OpenClaw 运行在自有服务器/电脑，所有聊天记录、操作数据均本地存储，不会上传到第三方云端，数据隐私完全可控；
注意事项：因 OpenClaw 具备系统级权限（可执行 Shell 命令、读写文件），建议在独立的服务器/虚拟机部署，避免在生产环境、存储重要数据的机器上运行，降低风险。

8.7 除飞书外，OpenClaw 还支持哪些平台？

支持主流的国内外聊天/协作平台，每个平台需安装对应的专属插件，包括：WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Lark（国际版飞书）等。

8.8 OpenClaw 能实现哪些实际工作功能？

OpenClaw 并非单纯的聊天机器人，可直接操作服务器完成自动化任务，典型使用场景：

文件管理：按类型/时间分类本地文件、批量重命名/删除文件；
网页处理：提取 URL 内容生成摘要、自动填写网页表单、爬取公开数据；
代码开发：编写 Python/Shell/Java 脚本、直接在服务器运行代码并返回结果；
数据查询：连接本地 MySQL/Redis 等数据库，执行查询并返回格式化结果；
日程管理：定时发送提醒、自动回复邮件、生成每日工作简报；
系统运维：执行服务器监控命令、查看系统日志、自动化部署轻量项目。

本教程详细完成了 OpenClaw 的两种安装方式（一键部署/手动安装）及飞书机器人的对接、配置、测试全流程，按步骤操作后，即可拥有专属的本地 AI 助手，实现 「飞书聊天窗口下达指令，服务器自动执行任务」 的高效协作模式。