亲测无坑，火山官方预制 OpenClaw 镜像底层为 Ubuntu 24.04 LTS 稳定版，所有运行依赖预装，零环境配置成本
前置准备
已实名认证的火山引擎账号
飞书账号（支持创建企业自建应用，个人 / 企业版均可）
大模型 API 密钥（推荐火山方舟 Coding Plan，也可使用智谱、通义千问等第三方 API）
一、云实例部署（核心：官方预制 Ubuntu 24.04 镜像）
openclaw云服务器和codingplan入口
无需手动装系统、配 Node.js/Git 等依赖，火山预制镜像全部搞定：
登录「火山引擎实例控制台」，选择创建实例
核心配置：
配置项 要求 说明
实例规格 ≥2 核 4G OpenClaw 最低运行要求，低配会出现卡顿 / 崩溃
镜像 公共应用镜像→「OpenClaw」 官方预制，底层为 Ubuntu 24.04 LTS 稳定版，OpenClaw 核心、运行依赖全部预装
网络 默认分配公网 IP 无需额外配置
安全组 新增 TCP 18789 入方向规则（源 IP 仅设为自己的公网 IP） 用于访问 OpenClaw 管理后台，避免公网暴露风险
付费后等待 3-5 分钟，实例状态变为「运行中」即完成部署，无需登录服务器操作
二、飞书端配置
登录飞书开放平台，创建企业自建应用，添加「机器人」应用能力
进入「开发配置→权限管理」，点击「批量导入权限」，导入以下 JSON 后申请权限：
{
"scopes": {
"tenant": [
"contact:user.base:readonly",
"im:chat:read",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:send_as_bot",
"im:resource",
"docx:document",
"base:app:read"
]
}
}
在「凭证与基础信息」页复制App ID、App Secret备用
三、OpenClaw 对接飞书
浏览器访问http://<你的实例公网IP>:18789，进入 OpenClaw 管理后台
选择「通道配置→添加通道→飞书」，填入之前复制的App ID、App Secret，平台选「国内飞书」，群聊策略选「@时响应」，私聊权限选「允许所有用户」，保存
回到飞书开放平台，进入「开发配置→事件与回调」：
订阅方式选长连接（无需内网穿透 / 备案域名），保存
点击「添加事件」，勾选所有「消息与群组」类事件，确认添加
点击顶部「创建版本」，提交发布（需发布 2 次：首次开权限，配置完长连接后二次发布，否则飞书聊天框无输入入口）
四、验证效果
飞书搜索你创建的机器人名称，发送「你好」，收到 AI 回复即为部署成功。
高频踩坑速查
实例必须≥2 核 4G，已有低配置实例可直接切换为 Ubuntu 24.04 的 OpenClaw 预制镜像，无需重买
飞书修改权限 / 配置后必须发布新版本，否则配置不生效
安装 OpenClaw 插件前先执行npm config set registry https://registry.npmmirror.com切国内源，避免安装报错
飞书长连接显示未连接：检查App ID/Secret是否填写正确，是否已发布最新版本
开发常用场景（装对应官方 Skill 即可用，无需二次开发）
技术群问题整理：@助手 整理今日群内技术问题，分前后端附解决方案，生成飞书文档 → 自动爬取群消息生成结构化文档
报错自动排查：粘贴 IDE 报错 + 场景说明 → 自动检索官方文档 / Stack Overflow，给出修复代码，支持对接 GitLab 定位出错行
接口文档生成：发送 Postman 导出的接口 JSON → 1 分钟生成规范接口文档，自动同步到飞书
线上告警处理：绑定监控告警通知 → 自动查询服务指标 / 日志，OOM、端口占用等简单问题自动重启服务
周报自动生成：发送「生成我本周工作周报」 → 自动拉取飞书日程、Git 提交记录生成结构化草稿
会议资料准备：绑定飞书日程 → 会前 10 分钟自动推送相关文档、代码分支链接