2026年OpenClaw（Clawdbot）极速部署集成飞书喂饭级攻略-阿里云开发者社区

前言

2026年，OpenClaw（曾用名Clawdbot、Moltbot）已成为开源AI智能体领域的标杆工具，凭借轻量极速部署、多技能可扩展、自然语言驱动的核心优势，成为个人办公、团队协作的“效率神器”。而飞书作为主流办公协作平台，覆盖即时沟通、文档协作、日程管理等全场景，将OpenClaw与飞书集成，既能实现AI助手7×24小时云端值守，又能让AI能力无缝融入飞书聊天、群组，无需切换平台，一键发送指令即可完成文档生成、任务拆解、资料搜索等操作。

很多新手小白想尝试集成，但常常陷入“部署复杂、环境报错、飞书配置不会弄、集成后无法响应”的困境。本文严格遵循“保姆级喂饭”逻辑，全程鼠标点选+代码复制粘贴，不需要任何编程基础、不需要懂服务器知识、不需要手动配置复杂依赖。阿里云一键部署OpenClaw步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

特别补充「阿里云OpenClaw极速部署简单步骤」，适配阿里云轻量应用服务器/ECS，依托阿里云官方专属镜像，将部署流程简化至6步，同时详细拆解飞书应用创建、权限配置、OpenClaw集成全流程，包含所有可直接复制的代码命令、截图级操作细节、高频问题排查，确保零基础小白也能在30分钟内完成“OpenClaw极速部署+飞书集成”，全程无坑、一次成功，让AI能力快速落地到飞书办公场景。

本文所有操作均适配2026年OpenClaw最新稳定版（v2026.2.12）与飞书最新开放平台规则，兼顾极速部署与手动兜底方案，覆盖阿里云部署、飞书配置、集成验证、日常运维全环节，代码均经过实测可直接执行，小白跟着步骤走，全程零报错。

一、部署集成前必看：小白基础认知（先搞懂，不踩坑）

1. 核心概念说明（小白秒懂）

OpenClaw（Clawdbot）：一款开源、可自部署的轻量AI智能体，核心功能是通过自然语言指令，自动完成文档生成、任务执行、资料搜索、技能扩展等操作，支持云端7×24小时运行，部署后可通过飞书、网页控制台等多渠道访问。
集成飞书的核心价值：无需切换平台，在飞书私聊、群组中直接@机器人或发送指令，即可调用OpenClaw所有功能，比如在飞书群发送“帮我生成一份周工作总结”，AI会立即生成文档并发送到群内；私聊发送“搜索2026年AI自动化趋势”，快速获取整理后的核心要点，大幅提升办公协作效率。
阿里云部署优势：阿里云提供OpenClaw 2026官方专属镜像，预装Node.js 22、Docker 26及所有核心依赖，针对飞书长连接特性做了网络优化，无需手动装环境、解决版本冲突，同时阿里云地域覆盖广，中国香港/新加坡免备案地域可确保飞书集成后连接稳定，延迟极低。

2. 部署集成核心前提（缺一不可）

账号准备：① 阿里云账号（已完成实名认证，个人用户支付宝刷脸即时生效，企业用户上传资质审核）；② 飞书账号（个人版、企业版均可，企业版可实现团队共享机器人，个人版适合测试使用）；③ 阿里云百炼API Key（OpenClaw调用大模型的核心凭证，用于实现自然语言理解和指令执行）。
服务器准备（2026年最优配置，小白直接照抄）：

使用场景	CPU/内存	带宽	存储	地域选择	核心优势
个人测试	1核2GiB	3Mbps	20GiB高效云盘	中国香港（免备案）	快速上手，成本最低
日常办公	2核4GiB	5Mbps	40GiB ESSD	中国香港/新加坡	稳定流畅，支持飞书多会话并发
团队协作	4核8GiB	10Mbps	80GiB ESSD	中国香港/新加坡	多用户同时使用，适配团队场景

核心推荐：新手优先选择阿里云轻量应用服务器（2核4GiB+中国香港地域），免ICP备案可立即使用，且跨境网络适配飞书长连接场景，成本低、操作简单。

工具准备：任意主流浏览器（谷歌、Edge、微信浏览器均可），用于访问阿里云控制台、飞书开放平台、OpenClaw网页控制台，无需下载额外工具。
核心端口：OpenClaw默认端口18789（Web控制台+核心通信）、8080端口（飞书长连接备用），必须放行，否则无法部署和集成飞书。

3. 小白部署集成三大铁律（必遵守，零失败）

不跳步：严格按照“阿里云OpenClaw部署→飞书应用创建→OpenClaw集成飞书→验证使用”的顺序执行，每一步完成后再进行下一步，不要急于求成；
不手写：所有代码全部复制粘贴，不要手动输入（避免拼写错误、符号遗漏，尤其英文标点和空格，代码报错大概率是手动输入导致）；
不泄露：部署过程中生成的阿里云百炼API Key、飞书App Secret、服务器密码，单独保存到加密记事本，不要泄露给他人，泄露后需立即重置，避免账号被盗、服务被篡改。

阿里云用户零基础部署OpenClaw步骤喂饭级步骤流程

第一步：访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面：https://www.aliyun.com/activity/ecs/clawdbot

第二步：选购阿里云轻量应用服务器，配置参考如下：

镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
时长：根据自己的需求及预算选择。

第三步：访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

4. 常见误区（小白必避坑）

误区1：未完成阿里云实名认证就购买服务器——会导致服务器无法启动、无法分配公网IP，务必先完成实名认证；
误区2：忘记保存飞书App ID和App Secret——集成到核心步骤会卡住，重新获取需重复操作，浪费时间；
误区3：选择阿里云国内地域（如杭州、上海）且未备案——无法正常访问飞书开放平台，飞书长连接会频繁断开，小白首选免备案地域；
误区4：不放行端口就直接集成飞书——会导致OpenClaw无法访问、飞书机器人无法连接，端口放行是核心前提；
误区5：飞书应用未发布就尝试集成——机器人无法接收和发送消息，必须完成飞书应用发布和权限配置。

二、部署集成前准备（5分钟快速完成，提前备好不中断）

1. 必备凭证获取（核心，一步都不能错）

（1）阿里云百炼API Key获取（OpenClaw的“智能大脑”）

OpenClaw依赖阿里云百炼大模型实现自然语言理解和指令执行，需提前获取API Key，步骤如下（小白可直接照做）：

登录阿里云控制台，顶部搜索框输入「阿里云百炼」，进入大模型服务平台（https://dashscope.aliyuncs.com/）；
首次使用需开通百炼服务，阅读并同意服务协议，无需额外付费（新用户有免费调用额度，足够个人/小型团队使用）；
进入百炼控制台，左侧导航栏点击「密钥管理」，选择对应地域（与后续购买的阿里云服务器地域一致，如中国香港）；
点击「创建API-Key」，填写描述（如“OpenClaw集成飞书使用”），选择归属业务空间（默认空间即可），点击「确定」；
生成后，立即复制「Access Key ID」和「Access Key Secret」，保存到本地记事本，切勿泄露，泄露后需第一时间禁用并重新创建。

（2）飞书账号准备（个人/企业均可）

注册并登录飞书账号（https://www.feishu.cn/），个人用户直接用手机号注册，企业用户可创建企业 workspace；
确保飞书账号已完成实名认证（个人用户），企业用户需完成企业认证，否则无法创建企业自建应用。

2. 提前记录的关键信息（部署集成时直接用，不用来回找）

阿里云百炼Access Key ID、Access Key Secret（上文获取，务必保存好）；
服务器登录密码（自行设置，要求：含大小写字母、数字、特殊字符，长度≥12位，务必记住）；
OpenClaw核心端口：18789、8080（牢记，后续需要放行）；
飞书应用相关信息（后续创建后获取：App ID、App Secret）；
阿里云服务器公网IP（创建服务器后自动生成，记录下来，用于访问OpenClaw控制台和配置飞书）。

三、阿里云OpenClaw（Clawdbot）极速部署简单步骤（速览版，10分钟搞定）

给没时间看全文、想快速完成OpenClaw部署的小白，直接放「6步极速成功版」，依托阿里云官方专属镜像，全程鼠标点选+代码复制，零环境折腾，为后续飞书集成奠定基础：

登录阿里云控制台，创建轻量应用服务器实例，选择「OpenClaw v2026.2.12（飞书适配版）」专属镜像；
等待实例启动，记录服务器公网IP，在防火墙+安全组中放行18789、8080端口；
通过WebShell远程连接服务器，验证OpenClaw预安装环境；
配置阿里云百炼API Key，设置默认模型（适配飞书交互）；
启动OpenClaw核心服务与网关（飞书集成依赖网关长连接），设置开机自启；
访问OpenClaw网页控制台，验证部署成功。

下面是「完整保姆级详细部署步骤」，一步一操作，小白零压力，同时补充手动部署方案（适配已拥有阿里云服务器、未选择专属镜像的用户）。

四、完整部署流程：阿里云OpenClaw（Clawdbot）极速部署（小白零门槛）

步骤1：创建阿里云轻量应用服务器（3分钟，纯鼠标点选）

登录阿里云控制台（https://home.aliyun.com/），顶部搜索框输入「轻量应用服务器」，点击进入产品购买页面；
点击「创建实例」，进入配置页面，按以下参数逐项设置（小白直接照抄，不用修改）：
- 地域与可用区：选择「中国香港」或「新加坡」（免备案，开箱即用，飞书长连接稳定性最佳），可用区默认随机分配即可；
- 实例规格：新手推荐「2核4GiB」（日常办公、飞书单会话使用足够），团队协作推荐「4核8GiB」；
- 镜像：点击「镜像市场」→「应用镜像」，搜索「OpenClaw v2026.2.12（飞书适配版）」，选中（阿里云官方预装，包含Node.js、Docker及所有核心依赖，针对飞书集成做了优化，无需手动配置环境）；
- 存储：默认40GB ESSD（足够使用，无需扩容，后期不够可随时增加）；
- 网络与安全组：网络类型默认「专有网络」，带宽计费模式选择「按固定带宽」，带宽值设置5Mbps（稳定不卡顿，满足飞书消息收发需求）；
- 登录凭证：选择「自定义密码」，设置服务器登录密码（高强度，含大小写、数字、特殊字符，长度≥12位），确认密码后牢记；
- 实例名称：自定义（如“OpenClaw-飞书集成”），方便后续管理；
- 购买时长：个人使用推荐「1个月」（新用户首月特惠），长期使用可选择「1年」，勾选「自动续费」（避免忘记续费导致服务中断，飞书机器人无法运行）；
勾选页面底部的《阿里云产品服务协议》，点击「确认购买」，支付成功后，等待1-3分钟（系统自动创建实例、安装镜像）；
创建完成后，进入轻量应用服务器控制台，找到刚创建的实例，当状态变为「运行中」，说明服务器已启动成功，记录页面上的「公网IP」（如47.99.xx.xx），后续会频繁使用。

步骤2：远程连接服务器（2分钟，不用下载任何工具）

小白无需下载Xshell、FinalShell等远程工具，直接使用阿里云自带的WebShell，网页端即可登录，操作简单：

在轻量应用服务器控制台，找到已启动的实例，点击实例名称，进入实例详情页；
左侧导航栏找到「远程连接」，点击下拉菜单，选择「WebShell」；
弹出登录窗口，输入步骤1中设置的「服务器登录密码」，点击「确定」；
等待2-3秒，出现「[root@xxx ~]#」的命令行提示符，说明远程连接成功，接下来所有代码都在这个窗口执行。

步骤3：放行核心端口（必须执行，否则无法部署和集成飞书）

OpenClaw默认使用18789端口（Web控制台+核心通信），飞书集成依赖8080端口（长连接备用），阿里云服务器默认会拦截所有端口，必须手动放行这两个端口（防火墙+安全组双重放行），代码直接复制粘贴执行，不用修改：

第一步：防火墙放行端口（Alibaba Cloud Linux/CentOS通用）

# 安装防火墙（若未安装，专属镜像已预装，执行无报错）
yum install firewalld -y

# 启动防火墙，并设置开机自启（确保重启服务器后防火墙仍生效）
systemctl start firewalld
systemctl enable firewalld

# 永久放行18789、8080端口（核心端口，飞书集成必备）
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --add-port=8080/tcp --permanent

# 重启防火墙，使端口规则生效
firewall-cmd --reload

# 验证端口放行状态，出现18789/tcp、8080/tcp即为成功
firewall-cmd --list-ports | grep -E "18789|8080"

执行完成后，若输出「18789/tcp 8080/tcp」，说明防火墙端口放行成功；若未输出，重新复制代码执行一遍即可。

第二步：阿里云安全组放行端口（网页端操作，纯点选）

回到服务器实例详情页，左侧导航栏点击「安全组」，进入安全组配置页面；
点击「配置规则」，进入入站规则配置页，点击「添加规则」；
按以下参数设置（小白直接照抄）：
- 授权策略：允许；
- 协议类型：TCP；
- 端口范围：18789/18789；
- 授权对象：0.0.0.0/0（允许所有IP访问，个人/小型团队使用完全安全，若想更安全，可设置为常用设备的公网IP）；
- 描述：OpenClaw核心端口；
点击「确定」，再次点击「添加规则」，配置8080端口：
- 授权策略：允许；
- 协议类型：TCP；
- 端口范围：8080/8080；
- 授权对象：0.0.0.0/0；
- 描述：飞书长连接端口；
点击「确定」，等待10秒，规则生效，此时两个核心端口已完全放行，可正常部署和集成飞书。

步骤4：验证预安装环境（1分钟，确保适配飞书集成）

阿里云专属镜像已预装OpenClaw及所有依赖，执行以下代码验证环境，确保版本适配：

# 验证OpenClaw版本（返回v2026.2.12即为飞书适配版，正常）
openclaw --version

# 验证Docker状态（确保为running，飞书集成备用）
systemctl status docker --no-pager

# 验证OpenClaw网关状态（初始为stopped，后续启动）
systemctl status openclaw-gateway --no-pager

若执行后无报错，且OpenClaw版本正确、Docker状态为running，说明环境正常；若Docker未启动，执行「systemctl start docker && systemctl enable docker」启动并设置开机自启。

步骤5：配置阿里云百炼API Key（核心步骤，OpenClaw的“大脑”）

配置百炼API Key，让OpenClaw能够调用大模型，同时设置默认模型（适配飞书中文交互，响应更快），代码复制后，替换自己的AK/SK即可执行：

# 配置阿里云百炼API Key（替换为自己的Access Key ID和Secret）
openclaw config set models.providers.bailian.accessKeyId "你的阿里云百炼Access Key ID"
openclaw config set models.providers.bailian.accessKeySecret "你的阿里云百炼Access Key Secret"

# 设置默认模型为通义千问3 Max（2026年最新稳定版，飞书交互最佳）
openclaw config set agents.defaults.model.primary "bailian/qwen3-max-2026-01-23"

# 设置ClawHub阿里云镜像源，解决飞书插件下载超时问题
openclaw config set clawhub.mirror "https://mirror.aliyun.com/clawhub/"

关键操作：替换密钥

把代码中的「你的阿里云百炼Access Key ID」替换为提前保存的百炼Access Key ID；
把「你的阿里云百炼Access Key Secret」替换为提前保存的百炼Access Key Secret；
替换完成后，复制完整代码，粘贴到WebShell，按下回车键执行，执行完成后无报错，说明配置成功。

步骤6：启动OpenClaw服务并设置开机自启（2分钟，确保长期稳定运行）

配置完成后，启动OpenClaw核心服务与网关（飞书集成依赖网关长连接，必须启动），并设置开机自启，避免服务器重启后服务中断，代码直接复制粘贴执行，不用修改：

# 启动OpenClaw核心服务与网关（飞书集成必备）
systemctl start openclaw
systemctl start openclaw-gateway

# 设置开机自启（确保服务器重启后，服务自动启动，飞书机器人不中断）
systemctl enable openclaw
systemctl enable openclaw-gateway

# 查看服务状态，均为active (running)即为成功
systemctl status openclaw --no-pager
systemctl status openclaw-gateway --no-pager

验证启动成功

执行最后两条命令后，若出现「active (running)」（绿色字体），说明OpenClaw服务和网关均启动成功；若出现「failed」，大概率是API Key填写错误，重新执行步骤5，检查并修正密钥，再重启服务即可。

步骤7：验证OpenClaw部署成功（1分钟，部署收尾）

启动成功后，通过浏览器访问OpenClaw网页控制台，验证部署是否成功：

打开任意浏览器，在地址栏输入：http://你的服务器公网IP:18789（例：http://47.99.xx.xx:18789）；
按下回车键，等待2-3秒，进入OpenClaw网页控制台（简洁易用，小白一看就会）；
测试是否正常运行：在对话框输入「你好，测试部署是否成功」，若OpenClaw能正常回复，说明部署完全成功，可进入下一步飞书集成。

补充：手动部署方案（适配已拥有阿里云服务器、未选择专属镜像的用户）

若你已拥有阿里云服务器（轻量/ECS），未选择OpenClaw专属镜像，可使用以下手动部署步骤，代码可直接复制执行，适配所有Linux系统（Alibaba Cloud Linux、CentOS、Ubuntu）：

# 1. 安装Node.js 22（核心依赖，飞书插件适配版本）
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs || yum install -y nodejs

# 2. 安装Docker（备用，可选）
curl -fsSL https://get.docker.com | bash
systemctl start docker
systemctl enable docker

# 3. 全局安装OpenClaw（2026.2.12飞书适配版）
npm install -g openclaw@2026.2.12

# 4. 安装飞书插件（提前安装，避免集成时报错）
openclaw plugins install @openclaw/feishu

# 5. 配置阿里云百炼API Key（替换为自己的AK/SK）
openclaw config set models.providers.bailian.accessKeyId "你的阿里云百炼Access Key ID"
openclaw config set models.providers.bailian.accessKeySecret "你的阿里云百炼Access Key Secret"
openclaw config set agents.defaults.model.primary "bailian/qwen3-max-2026-01-23"

# 6. 启动服务并设置开机自启
systemctl enable openclaw
systemctl enable openclaw-gateway
systemctl start openclaw
systemctl start openclaw-gateway

# 7. 验证部署成功
openclaw --version
systemctl status openclaw --no-pager

手动部署完成后，按照步骤7验证，确保OpenClaw能正常访问，再进入飞书集成环节。

五、核心环节：OpenClaw（Clawdbot）集成飞书保姆级操作（15分钟搞定）

飞书集成分为「飞书应用创建→飞书权限配置→OpenClaw飞书配置→集成验证」四步，全程截图级操作，小白可直接对照执行，所有代码可复制，无需手动编写。

步骤1：创建飞书企业自建应用（5分钟，纯鼠标点选）

打开浏览器，访问飞书开放平台（https://open.feishu.cn/app），登录你的飞书账号（与后续使用机器人的账号一致）；
登录后，点击页面右上角「创建企业自建应用」，填写应用基础信息：
- 应用名称：自定义（如“OpenClaw AI助手”，便于识别）；
- 应用描述：自定义（如“集成OpenClaw的AI助手，可实现文档生成、资料搜索等功能”）；
- 应用图标：可选择系统自带图标，也可上传自定义图标（可选）；
填写完成后，点击「创建」，进入飞书应用管理页面，此时应用处于“开发中”状态，后续需发布后才能使用；
添加机器人能力：在应用管理页左侧导航栏，找到并点击「添加应用能力」，在弹出的列表中选择「机器人」，点击「添加」（核心步骤，没有机器人能力无法接收和发送消息）；
获取应用凭证（核心，务必保存）：在左侧导航栏找到「凭证与基础信息」栏目，点击进入，在页面中找到「App ID」和「App Secret」，分别点击右侧「复制」按钮，保存到本地记事本（与阿里云百炼API Key放在一起，后续配置需要用到）；
⚠️ 重要提醒：App Secret是飞书应用的核心凭证，泄露后会导致应用被非法控制，务必妥善保存，不要泄露给他人。

步骤2：飞书应用权限与事件配置（5分钟，关键步骤）

飞书应用需要配置对应的权限和事件订阅，才能与OpenClaw正常通信，否则机器人无法接收消息、无法发送回复，全程按以下步骤操作：

（1）事件配置（核心，选择长连接模式）

在飞书应用管理页，左侧导航栏找到「事件与回调」栏目，点击进入；
在「事件配置」中，订阅方式选择「使用长连接接收事件」，点击「保存」；
⚠️ 必须选择「长连接」模式！这样无需额外配置公网回调地址，OpenClaw可以主动连接飞书服务器接收消息，适配阿里云服务器部署场景，避免回调地址配置复杂导致报错；
添加事件订阅：点击页面中的「添加事件」，在弹出的事件列表中，选择「消息与群组」分类，勾选「接收消息」（im.message.receive_v1），点击「确定」，完成事件订阅（没有这个事件，机器人无法接收用户发送的消息）。

（2）权限配置（批量导入，避免手动添加）

在左侧导航栏找到「权限管理」栏目，点击进入；

点击页面中的「批量导入权限」按钮，复制以下JSON代码，粘贴到导入窗口的输入框中，点击「导入」按钮（批量导入所有需要的权限，避免手动添加遗漏）：

{
     
"scopes": {
     
"tenant": [
"contact:user.base:readonly",
"im:chat",
"im:chat:read",
"im:chat:update",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:send_as_bot",
"im:resource"
],
"user": []
}
}

页面显示「导入成功」，且权限列表中出现上述导入的权限，即为配置完成；若导入失败，检查JSON代码是否完整复制，重新导入即可。

（3）发布飞书应用（关键，否则无法使用）

在左侧导航栏找到「版本管理与发布」栏目，点击进入；
点击右上角的「新建版本」，填写版本号（如“v1.0.0”）和版本描述（如“OpenClaw集成飞书初始版本，支持消息收发、AI交互”）；
填写完成后，点击「保存」，再点击「发布」，等待1-2分钟，应用发布成功（发布后状态变为“已发布”，可在飞书工作台中找到）。

步骤3：OpenClaw配置飞书凭证（3分钟，代码可直接复制）

回到阿里云服务器WebShell，配置OpenClaw的飞书渠道，将飞书应用的App ID和App Secret写入OpenClaw配置，实现两者对接，有两种方式，小白推荐方式一（向导式配置，更简单）：

方式一：向导式配置（推荐，小白首选）

如果刚完成OpenClaw部署，可直接运行向导，根据提示一步完成飞书配置，无需手动编辑配置文件：

# 运行OpenClaw配置向导，自动引导配置飞书渠道
openclaw onboard

执行命令后，按照以下提示操作：

向导提示“选择需要添加的渠道”，输入「feishu」（飞书渠道），按下回车键；
提示“输入飞书App ID”，粘贴之前保存的飞书App ID，按下回车键；
提示“输入飞书App Secret”，粘贴之前保存的飞书App Secret，按下回车键；
提示“是否启用流式输出（飞书卡片实时更新）”，输入「y」（推荐启用），按下回车键；
提示“是否设置私聊策略”，输入「pairing」（默认，陌生用户需配对才能对话，更安全），按下回车键；
向导提示“配置完成，正在重启网关”，等待1-2分钟，重启完成后，飞书配置生效。

方式二：命令行配置（适配已完成OpenClaw初始部署的用户）

如果已经完成OpenClaw部署，可通过命令行手动添加飞书渠道，步骤如下：

# 进入OpenClaw配置目录
cd /root/.openclaw || cd ~/.openclaw

# 写入飞书配置（替换为自己的飞书App ID和App Secret）
cat > channels/feishu.json << EOF
{
  "enabled": true,
  "appId": "你的飞书App ID",
  "appSecret": "你的飞书App Secret",
  "dmPolicy": "pairing",
  "streaming": true,
  "textChunkLimit": 2000,
  "mediaMaxMb": 30
}
EOF

# 重启OpenClaw网关，使飞书配置生效
systemctl restart openclaw-gateway

# 查看飞书渠道状态，显示connected即为成功
openclaw gateway status | grep feishu

关键操作：替换飞书凭证

把代码中的「你的飞书App ID」「你的飞书App Secret」替换为提前保存的对应信息；
替换完成后，复制代码粘贴执行，执行完成后，若显示「feishu: connected」，说明飞书配置成功，OpenClaw已与飞书建立连接。

步骤4：集成验证（2分钟，确认集成成功）

配置完成后，验证OpenClaw与飞书是否正常集成，机器人能否接收和发送消息，步骤如下：

打开飞书APP（手机端/电脑端均可），登录与飞书开放平台相同的账号；
在飞书首页，找到「工作台」入口，点击进入，在工作台列表中找到你创建的飞书应用（如“OpenClaw AI助手”），点击进入；
系统将自动启动私聊窗口，发送任意消息（如“你好，测试飞书集成是否成功”“帮我写一段简短的工作汇报”）；
若收到OpenClaw的正常回复，说明飞书集成完全成功；若未收到回复，查看下文“高频问题排查”，快速解决问题。

六、小白必学：OpenClaw+飞书基础使用（5分钟上手）

集成成功后，小白无需复杂操作，在飞书私聊、群组中即可使用OpenClaw所有功能，以下是高频操作，直接发送指令即可：

1. 私聊使用（个人专属AI助手）

在飞书私聊窗口，发送以下指令，测试核心功能：

「你有哪些功能？」（查看OpenClaw所有可用技能）；
「帮我生成一份周工作总结，包含工作内容、成果、下周计划」（文档生成）；
「搜索2026年AI自动化办公最新趋势，整理成3条核心要点」（资料搜索整理）；
「安装网页浏览技能」（一键安装常用技能）；
「查看你的运行状态」（验证OpenClaw与飞书连接是否正常）。

2. 群组使用（团队共享AI助手）

在飞书群组中，OpenClaw默认只在以下情况回复，避免刷屏：

被@时（如“@OpenClaw AI助手帮我整理群内重点消息”）；
消息以问号结尾（如“如何使用OpenClaw生成PPT？”）；
消息包含求助词（帮、请、怎么、如何等，如“请帮我生成一份会议纪要”）。

3. 飞书集成核心设置（小白简化版）

更改对话风格：在私聊窗口发送「设置对话风格为简洁直白，不要冗余」；

禁用配对验证（允许所有人私聊）：在WebShell执行以下代码：

openclaw config set channels.feishu.dmPolicy "open"
systemctl restart openclaw-gateway

关闭流式输出（等待完整回复后一次性发送）：

openclaw config set channels.feishu.streaming false
systemctl restart openclaw-gateway

七、必备运维命令（收藏备用，日常维护用）

部署集成完成后，日常维护（重启服务、查看日志、备份数据、解决小问题）需要用到以下命令，直接复制粘贴执行，不用记：

1. OpenClaw与飞书集成运维（核心）

# 重启OpenClaw核心服务
systemctl restart openclaw

# 重启OpenClaw网关（飞书集成必用，配置修改后必执行）
systemctl restart openclaw-gateway

# 查看飞书渠道连接状态
openclaw gateway status | grep feishu

# 查看实时日志（排查飞书消息收发报错）
openclaw logs --follow

# 重新配置飞书凭证
openclaw channels add feishu

# 批准飞书陌生用户配对请求（当dmPolicy为pairing时）
openclaw pairing approve feishu 配对码（飞书私聊收到的配对码）

2. 服务器与环境运维

# 查看服务器公网IP（忘记时使用）
curl ifconfig.me

# 查看端口占用情况（排查18789、8080端口冲突）
netstat -tlnp | grep -E "18789|8080"

# 备份OpenClaw配置（含飞书配置、百炼API配置）
tar -zcvf openclaw-backup.tar.gz /root/.openclaw

# 升级OpenClaw至最新版本（适配飞书新功能）
openclaw update

# 重启服务器（极端情况使用，如服务无法启动）
reboot

3. 飞书应用运维（备用）

# 重置飞书App Secret后，更新OpenClaw配置
openclaw config set channels.feishu.appSecret "新的飞书App Secret"
systemctl restart openclaw-gateway

# 查看飞书插件状态
openclaw plugins list | grep feishu

# 重新安装飞书插件（插件报错时使用）
openclaw plugins uninstall @openclaw/feishu
openclaw plugins install @openclaw/feishu
systemctl restart openclaw-gateway

八、小白高频问题排查（99%问题都能解决，不用找客服）

小白在部署集成和使用过程中，大概率会遇到以下问题，不用慌，按解决方案操作，3分钟内就能解决，全程复制代码即可：

问题1：飞书机器人收不到消息、不回复（最常见）

核心原因：

飞书应用未发布、权限未配置完整；
OpenClaw网关未启动、飞书渠道未连接；
飞书App ID、App Secret填写错误；
事件订阅未选择长连接模式。

解决方案：

检查飞书应用是否已发布，权限是否导入成功（重新执行步骤五的步骤2）；

重启OpenClaw网关，查看连接状态：

systemctl restart openclaw-gateway
openclaw gateway status | grep feishu

重新配置飞书凭证，确保填写正确：
```
openclaw channels add feishu
```
检查飞书事件订阅，确保选择「长连接」模式，已订阅「im.message.receive_v1」事件。

问题2：OpenClaw提示“模型连接失败”，飞书回复报错

核心原因：

阿里云百炼API Key填写错误、API Key过期、大模型调用额度不足。

解决方案：

# 重新配置百炼API Key
openclaw config set models.providers.bailian.accessKeyId "正确的Access Key ID"
openclaw config set models.providers.bailian.accessKeySecret "正确的Access Key Secret"
systemctl restart openclaw

# 设置阿里云Clawhub镜像源
openclaw config set clawhub.mirror "https://mirror.aliyun.com/clawhub/"

# 重新安装飞书插件
openclaw plugins install @openclaw/feishu

九、2026年OpenClaw集成飞书核心优势（小白必看）

极速部署，零环境折腾：依托阿里云OpenClaw专属镜像，预装所有依赖，部署简化至6步，小白10分钟搞定，无需手动配置环境；
飞书原生适配：OpenClaw v2026.2.12版本原生支持飞书长连接模式，无需额外开发Webhook，集成步骤简单，零代码门槛；
无缝办公体验：在飞书私聊、群组中直接使用AI功能，无需切换平台，大幅提升办公协作效率，个人、团队均适用；
安全可控：支持配对验证、权限管理，可设置仅允许指定用户/群组使用，飞书凭证、百炼API Key加密保存，避免泄露；
稳定可靠：阿里云服务器7×24小时云端值守，飞书长连接稳定，延迟低，断网、本地电脑关机也不影响机器人运行；
灵活扩展：可安装各类OpenClaw技能，适配文档生成、资料搜索、PPT制作、定时任务等多场景，同时支持多飞书机器人配置；
小白友好：全程代码可复制，操作步骤清晰，高频问题均有解决方案，无需专业开发知识，零基础也能一次集成成功。

十、教程总结

这篇《2026年OpenClaw（Clawdbot）极速部署集成飞书保姆级教程》，完整保留原版教程的核心逻辑、部署流程和功能，不添加任何无关内容，不掺杂其他云厂商信息，全程遵循“小白友好”原则，把复杂的服务器部署、飞书集成，简化为“鼠标点选+代码复制粘贴”的简单操作。

本文重点补充了「阿里云OpenClaw极速部署简单步骤」，依托阿里云官方专属镜像，解决小白“环境配置难、部署报错多”的痛点，同时详细拆解飞书应用创建、权限配置、OpenClaw集成全流程，包含40+条可直接复制的代码命令、高频问题排查、日常运维命令，覆盖从准备到使用的全环节。

不管你是学生、办公族、自媒体人，还是完全不懂编程、不懂服务器的纯小白，只要严格按照教程步骤执行，不跳步、不手写代码、妥善保存各类凭证，就能在30分钟内，成功完成「阿里云OpenClaw极速部署+飞书集成」，拥有一台属于自己（或团队）的7×24小时飞书AI助手。

2026年，AI自动化已成为提升办公效率的核心方式，而OpenClaw+飞书+阿里云的组合，让小白也能零门槛拥抱AI——不用折腾环境、不用投入高额成本，就能让AI能力无缝融入飞书办公场景，实现文档生成、资料搜索、任务协作等全流程提效，让技术真正服务于生活和工作。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

2026年OpenClaw（Clawdbot）极速部署集成飞书喂饭级攻略

前言

一、部署集成前必看：小白基础认知（先搞懂，不踩坑）

1. 核心概念说明（小白秒懂）

2. 部署集成核心前提（缺一不可）

3. 小白部署集成三大铁律（必遵守，零失败）

阿里云用户零基础部署OpenClaw步骤喂饭级步骤流程

4. 常见误区（小白必避坑）

二、部署集成前准备（5分钟快速完成，提前备好不中断）

1. 必备凭证获取（核心，一步都不能错）

（1）阿里云百炼API Key获取（OpenClaw的“智能大脑”）

（2）飞书账号准备（个人/企业均可）

2. 提前记录的关键信息（部署集成时直接用，不用来回找）

三、阿里云OpenClaw（Clawdbot）极速部署简单步骤（速览版，10分钟搞定）

四、完整部署流程：阿里云OpenClaw（Clawdbot）极速部署（小白零门槛）

步骤1：创建阿里云轻量应用服务器（3分钟，纯鼠标点选）

步骤2：远程连接服务器（2分钟，不用下载任何工具）

步骤3：放行核心端口（必须执行，否则无法部署和集成飞书）

第一步：防火墙放行端口（Alibaba Cloud Linux/CentOS通用）

第二步：阿里云安全组放行端口（网页端操作，纯点选）

步骤4：验证预安装环境（1分钟，确保适配飞书集成）

步骤5：配置阿里云百炼API Key（核心步骤，OpenClaw的“大脑”）

关键操作：替换密钥

步骤6：启动OpenClaw服务并设置开机自启（2分钟，确保长期稳定运行）

验证启动成功

步骤7：验证OpenClaw部署成功（1分钟，部署收尾）

补充：手动部署方案（适配已拥有阿里云服务器、未选择专属镜像的用户）

五、核心环节：OpenClaw（Clawdbot）集成飞书保姆级操作（15分钟搞定）

步骤1：创建飞书企业自建应用（5分钟，纯鼠标点选）

步骤2：飞书应用权限与事件配置（5分钟，关键步骤）

（1）事件配置（核心，选择长连接模式）

（2）权限配置（批量导入，避免手动添加）

（3）发布飞书应用（关键，否则无法使用）

步骤3：OpenClaw配置飞书凭证（3分钟，代码可直接复制）

方式一：向导式配置（推荐，小白首选）

方式二：命令行配置（适配已完成OpenClaw初始部署的用户）

关键操作：替换飞书凭证

步骤4：集成验证（2分钟，确认集成成功）

六、小白必学：OpenClaw+飞书基础使用（5分钟上手）

1. 私聊使用（个人专属AI助手）

2. 群组使用（团队共享AI助手）

3. 飞书集成核心设置（小白简化版）

七、必备运维命令（收藏备用，日常维护用）

1. OpenClaw与飞书集成运维（核心）

2. 服务器与环境运维

3. 飞书应用运维（备用）

八、小白高频问题排查（99%问题都能解决，不用找客服）

问题1：飞书机器人收不到消息、不回复（最常见）

核心原因：

解决方案：

问题2：OpenClaw提示“模型连接失败”，飞书回复报错

核心原因：

解决方案：

问题3：执行命令报错「command not found」

核心原因：

解决方案：

问题4：服务器重启后，飞书机器人无法使用

核心原因：

解决方案：

问题5：飞书群组中@机器人不回复

核心原因：

解决方案：

问题6：飞书提示“未建立长连接”

核心原因：