云部署 OpenClaw 与飞书无缝对接完整指南

云部署 OpenClaw 与飞书无缝对接完整指南

云部署OpenClaw并对接飞书

这篇分享深度解决云托管场景下的AI智能体自主可控问题，核心是通过腾讯云LightHouse轻量应用服务器部署OpenClaw，实现AI与飞书的无缝对接，让你的AI助手拥有专属服务器运行环境，数据全掌控、服务7×24小时不中断，同时适配企业办公场景的自动化需求 🚀。

一、核心前置准备

1.1 环境与资源要求

• 服务器配置：推荐2核4G及以上（锐驰型套餐），基础体验可选2核2G，内存建议≥4GB避免多任务卡顿，存储≥60GB SSD满足依赖与数据存储需求

• 系统环境：腾讯云LightHouse预置CentOS 7/Ubuntu，优先选择CentOS 7（适配OpenClaw 2026.2.26版本），需确保glibc≥2.17、GCC≥9.x、Node.js≥22.16.0

• 账号权限：腾讯云实名认证账号（LightHouse购买/管理权限）、飞书企业自建应用创建权限（企业版/个人版均可）

• 关键凭证：大模型API Key（通义千问、豆包、DeepSeek等）、飞书开放平台App ID/App Secret

1.2 为什么选择腾讯云LightHouse

LightHouse是轻量级应用服务器，相比传统云服务器更易上手，无需复杂运维配置，同时具备三大核心优势：

• 成本友好：新用户专属优惠套餐，几十元即可启动长期运行，支持按需升级

• 环境预置：一键预装Node.js、CMake、GCC等OpenClaw依赖，省去手动配置繁琐

• 安全便捷：固定公网IP、可视化防火墙配置、快照一键回滚，规避本地部署风险

• 生态适配：独家提供OpenClaw应用模板，1-3分钟完成一键部署，无需手动编译

二、云端部署流程（6大核心步骤）

第一步：注册腾讯云账号

1. 打开腾讯云官网（cloud.tencent.com），点击右上角「注册」，选择微信扫码注册（快捷高效）

2. 按照指引完成账号注册与实名认证（未实名认证无法购买LightHouse实例）

3. 注册成功后进入腾讯云控制台，搜索「轻量应用服务器」进入专属管理页面

第二步：购买轻量应用服务器（LightHouse）

方式一：新购实例（推荐新手）

1. 进入LightHouse购买页，通过OpenClaw专属活动入口进入（享受专属优惠）

2. 配置实例参数：

• 地域：国内业务选广州/上海/北京（延迟低），海外业务选新加坡/硅谷（适配跨境场景）

• 套餐类型：优先选「锐驰型」（高性价比），配置选2核4G及以上（满足OpenClaw运行）

• 镜像：选择「应用模板」→「AI智能体」→「OpenClaw(Clawdbot)」（一键预置环境）

• 网络与带宽：默认100M峰值带宽，按需调整，支持按流量/带宽计费

• 实例名称：自定义（如OpenClaw-AI-Bot），登录方式选「自定义密码」（牢记密码）

3. 确认配置后点击「立即购买」，支付完成后等待30秒，实例状态转为「运行中」即部署完成

方式二：重装现有实例（旧数据无需保留）

1. 进入LightHouse控制台，找到目标实例，点击右侧「...」→「重装系统」

2. 选择「应用模板」→「AI智能体」→「OpenClaw(Clawdbot)」，设置登录凭证

3. 点击「确定」，等待重装完成（约1分钟），重装后需配置防火墙放行端口

第三步：配置服务器防火墙（关键）

OpenClaw默认运行在18789/18790端口，需在LightHouse控制台放行：

1. 进入目标实例管理页，点击「防火墙」标签页

2. 点击「添加规则」，填写：

• 协议：TCP

• 端口：18789（核心端口）、18790（可选）

• 授权对象：[0.0.0.0/0](0.0.0.0/0)（允许所有IP访问，也可限定企业办公IP）

3. 点击「确定」，端口放行生效（未配置会导致飞书无法连接）

第四步：登录服务器并验证基础环境

方式一：使用腾讯云OrcaTerm（推荐）

1. 进入实例管理页，点击「登录」→「OrcaTerm终端」（无需额外安装软件）

2. 输入登录账号（默认root）与密码（购买时设置的密码），完成登录

方式二：第三方终端（SSH）

1. 复制实例公网IP，打开本地终端（Windows用PowerShell/CMD，Mac/Linux用原生终端）

2. 执行登录命令：ssh root@你的公网IP，输入密码即可登录

环境验证（必做）

登录后依次执行以下命令，确认依赖环境正常：

验证Node.js版本（需≥22.16.0）

node -v

验证GCC版本（需≥9.x）

gcc --version

验证OpenClaw安装

openclaw --version

若输出版本信息且无报错，说明基础环境配置成功；若异常，执行yum update -y更新系统依赖后重试。

第五步：初始化OpenClaw配置

执行初始化向导，完成核心参数配置：

启动配置向导

openclaw configure

按指引依次填写：

1. 安全风险确认：输入Yes（知晓OpenClaw高权限特性）

2. 配置模式：选择QuickStart（快速配置，新手友好）

3. 大模型配置：

• 选择模型服务商（如通义千问、豆包）

• 输入对应API Key（从模型服务商控制台获取）

• 确认模型端点（如OpenAI-compatible、腾讯混元专属端点）

4. 消息通道：暂时选择Skip for now（后续单独配置飞书通道）

5. 技能插件：选择No（后续按需开启）

6. 启动方式：选择Hatch in TUI（终端交互模式，快速验证运行）

第六步：启动OpenClaw服务

1. 启动网关服务：

openclaw gateway start

2. 验证服务状态：

openclaw gateway status

输出Gateway service: running即服务启动成功

3. 配置开机自启（长期运行必备）：

复制服务文件到systemd目录

cp /root/.config/systemd/user/openclaw-node.service /usr/lib/systemd/system/

重载服务配置

systemctl daemon-reload

设置开机自启

systemctl enable openclaw-node

启动服务

systemctl start openclaw-node

三、飞书开放平台配置（核心对接步骤）

第一步：创建飞书企业自建应用

1. 打开飞书开放平台（open.feishu.cn），使用飞书管理员账号登录

2. 点击右上角「创建企业自建应用」，填写基础信息：

• 应用名称：自定义（如「企业AI助手」）

• 应用描述：简述功能（如「基于OpenClaw的办公自动化助手」）

• 应用图标：上传专属图标（提升辨识度）

3. 点击「创建」，进入应用详情页，记录左侧「凭证与基础信息」中的App ID和App Secret（后续配置必备，妥善保存）

第二步：开启机器人能力

1. 进入应用详情页，点击「添加应用能力」→「机器人」→「添加」

2. 开启「接收消息」「发送消息」核心权限，保存配置

第三步：配置权限管理

OpenClaw需要飞书消息读写、成员管理等权限，通过批量导入快速配置：

1. 点击「权限管理」→「批量导入/导出权限」

2. 粘贴以下JSON权限配置，覆盖原有内容：

{

"scopes": {

"tenant": [

"aily:file:read",

"aily:file:write",

"application:bot.menu:write",

"im:chat.access_event.bot_p2p_chat:read",

"im:chat.members:bot_access",

"im:message",

"im:message.group_at_msg:readonly",

"im:message.p2p_msg:readonly",

"im:message:send_as_bot",

"im:resource"

],

"user": [

"aily:file:read",

"aily:file:write",

"im:chat.access_event.bot_p2p_chat:read"

]

}

}

3. 点击「申请开通」→「确认」，完成权限申请（个人自建应用免审，立即生效）

第四步：配置事件订阅（WebSocket）

飞书通过事件订阅向OpenClaw推送消息，采用WebSocket长连接无需公网IP暴露：

1. 点击「事件与回调」→「事件配置」→「订阅方式」

2. 选择「长连接接收事件（WebSocket）」，点击「保存」

3. 点击「添加事件」，添加以下4个核心事件：

• im.message.receive_v1（接收消息）

• im.message.message_read_v1（消息已读回执）

• im.chat.member.bot.added_v1（机器人进群）

• im.chat.member.bot.deleted_v1（机器人移出群）

4. 保存事件配置，飞书平台侧配置完成

四、OpenClaw对接飞书（核心联动配置）

第一步：启用飞书插件

回到服务器终端，执行命令启用飞书插件：

openclaw plugins enable feishu

输出Enabled plugin "feishu". Restart the gateway to apply.即启用成功，重启网关生效：

openclaw gateway restart

第二步：配置飞书通道

1. 执行通道配置命令：

openclaw channels add

2. 按指引选择通道类型：feishu

3. 输入飞书App ID、App Secret（从飞书开放平台复制）

4. 配置完成后，系统会生成一对配对码（如33J7CUVQ，临时有效，需快速使用）

第三步：完成配对验证

1. 打开飞书，找到刚才创建的自建应用，发送任意消息（如「测试连接」）

2. 服务器终端执行配对命令，输入飞书返回的配对码：

openclaw pairing approve feishu 你的配对码

3. 输出Pairing success即配对成功

第四步：最终验证

1. 飞书群组中@机器人，发送指令（如「生成本周工作周报」「查询服务器资源」）

2. 若机器人正常回复，说明对接成功；若无响应，检查：

• 服务器防火墙是否放行18789端口

• OpenClaw服务是否正常运行（openclaw gateway status）

• 飞书事件订阅是否配置正确

五、进阶配置与常见问题排查

5.1 进阶配置（办公场景优化）

1. 配置可视化面板：

执行openclaw dashboard，获取面板访问地址与令牌，本地浏览器访问http://公网IP:18789，输入令牌即可进入可视化管理界面，支持一键切换模型、管理通道

2. 配置定时任务：

通过OpenClaw插件开启「定时任务」，实现每日自动生成日报、同步飞书日程、清理服务器日志等

3. 多通道扩展：

参考飞书配置流程，依次对接企业微信、钉钉、QQ等通道，实现多平台统一AI交互

六、总结与使用场景

通过以上6大步骤，你已完成OpenClaw在腾讯云LightHouse的部署与飞书对接，核心价值在于：

1. 数据自主可控：所有AI交互数据、文件存储均在自有服务器，避免第三方平台泄露

2. 7×24小时在线：服务器长期运行，无需依赖本地电脑，随时随地调用AI助手

3. 办公自动化落地：支持飞书群组智能回复、日程管理、文件处理、周报生成等场景，大幅提升工作效率

后续可根据业务需求，扩展OpenClaw插件（如销售数据统计、服务器运维监控、客户消息自动回复等），打造专属的企业级AI办公助手。