2026年阿里云部署OpenClaw（Clawdbot）一键接入飞书保姆级教程-阿里云开发者社区

2026年，AI自动化工具与协同办公平台的深度融合成为效率升级的核心趋势，OpenClaw（前身为Clawdbot、Moltbot）作为阿里云生态下轻量化、高适配的AI自动化代理工具，凭借“零编程基础、全场景适配、高扩展性”的优势，成为个人与企业构建专属AI助手的首选；而飞书作为高效协同办公平台，广泛应用于各类团队的日常沟通、任务管理与文档协作。将OpenClaw部署在阿里云，并一键接入飞书，可实现“飞书端直接下达指令、OpenClaw自动执行任务、结果实时反馈”的闭环，无需频繁切换平台，让AI助手真正融入协同办公流程，大幅减少重复手工劳动，提升团队协作与个人办公效率。

此前，不少用户在部署OpenClaw并接入飞书时，常因“环境配置复杂、凭证获取繁琐、对接步骤混乱”等问题卡壳，甚至因参数错误导致部署失败、对接失效。本文整合阿里云官方实操指南、OpenClaw最新稳定版（v2026.2.0）特性、飞书开放平台对接规范及全网实测经验，重写优化全流程教程，严格保留“阿里云部署+飞书接入”的核心逻辑，剔除冗余技术细节，补充可直接复制的代码命令、新手避坑要点、凭证获取详解及常见问题排查方案。文中明确标注阿里云OpenClaw（Clawdbot）部署简单速记步骤，全程不含无关云厂商信息，聚焦阿里云与OpenClaw、飞书的深度适配，从前期准备、服务器部署、API配置，到飞书应用创建、一键对接、功能验证，每一步都拆解到位、细节拉满，确保无论是否有技术基础，都能跟着步骤顺利完成部署与对接，成功搭建专属AI协同助手。

需明确的是，OpenClaw、Clawdbot、Moltbot本质是同一套AI自动化系统，仅为品牌迭代后的名称差异——2025年11月最初命名为Clawd（因商标纠纷更名），2026年1月更名为Moltbot（因名称冷僻、域名被抢注再次更名），最终确定为OpenClaw，强调开源属性与核心标识，目前GitHub仓库已完成全面迁移，开发与部署需以“OpenClaw”为准，旧名相关命令（如clawdbot dashboard）仍可兼容使用，本文所有操作步骤、代码命令均适配三者，无需额外调整。2026年OpenClaw最新版本已优化飞书接入流程，封装好飞书对接核心功能，无需额外开发，通过简单配置即可实现一键接入，同时与阿里云轻量应用服务器、无影云电脑、百炼大模型深度适配，进一步降低部署与使用门槛，详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：部署对接逻辑与核心优势

1. 整体操作逻辑（新手必懂）

本次“阿里云部署OpenClaw+一键接入飞书”的核心逻辑的是：以阿里云轻量应用服务器（或无影云电脑）为载体，通过阿里云专属镜像一键部署OpenClaw，配置阿里云百炼API-Key激活AI能力；再通过飞书开放平台创建企业自建应用，获取应用凭证（App ID、App Secret等），将凭证录入OpenClaw配置中心，建立两者之间的通信连接；最后通过阿里云AppFlow或OpenClaw内置对接功能，完成飞书机器人配置与事件订阅，实现飞书端与OpenClaw的双向交互——飞书端发送自然语言指令，OpenClaw解析指令并自动执行（如文档生成、数据抓取、日程提醒等），执行结果实时反馈至飞书单聊或群聊中，全程无需切换平台。

2. 核心优势（为什么首选阿里云+OpenClaw+飞书）

零技术门槛：阿里云提供OpenClaw专属镜像，提前完成运行环境、核心依赖（Node.js 22+、Docker等）的安装配置，一键部署无需手动调试；飞书对接流程已被OpenClaw封装优化，无需编写代码，复制命令、填写凭证即可完成对接，纯新手也能上手。
高效协同：接入后可在飞书私聊、群聊中直接@OpenClaw机器人发送指令，无需登录OpenClaw Web控制台，适配团队协同场景，例如“@机器人生成本周团队工作周报”“@机器人抓取行业资讯并整理成飞书文档”，结果即时反馈，提升协作效率。
稳定可靠：阿里云云服务器具备24小时稳定运行、弹性伸缩、故障自动恢复的优势，确保OpenClaw全天候待命；OpenClaw与飞书官方接口深度适配，通信稳定，避免指令丢失、结果反馈延迟等问题，同时阿里云百炼大模型提供稳定的AI推理能力，新用户可领取90天免费模型调用额度（超7000万tokens），足够前期测试使用。
成本可控：阿里云轻量应用服务器新用户月付低至9.9元，按需付费模式可灵活控制成本，长期不使用时可停止实例，避免资源浪费；OpenClaw开源免费，无需支付软件费用；飞书对接无需额外付费，仅需完成应用配置即可免费使用核心功能。
扩展性强：OpenClaw支持安装各类技能（如文件管理、网页抓取、钉钉集成等），可根据需求扩展AI助手功能；飞书对接支持单聊、群聊、日程、文档等多场景联动，可自定义自动化工作流，适配个人办公与团队协同的多元需求。

3. 适用场景（看完明确是否需要部署）

团队协同：飞书群聊中@OpenClaw机器人，自动生成会议纪要、分配任务、统计工作进度、发送日程提醒，减少人工协调成本；
个人办公：飞书私聊发送指令，让OpenClaw自动生成工作周报、整理邮件、抓取网页资料、创建飞书文档，解放双手，聚焦核心工作；
高效管理：管理员可通过飞书远程控制OpenClaw，查看任务执行日志、管理技能、配置权限，实现AI助手的统一管理；
自动化办公：搭建自定义工作流，如“每天9点抓取行业资讯→整理成飞书文档→发送到指定飞书群→提醒相关人员查看”，全程无需人工干预。

二、部署对接前必做准备（5分钟搞定，缺一不可）

1. 账号准备（全部需提前注册/登录）

注册阿里云账号：打开阿里云官网，用手机号快速注册，登录后进入“账号中心”完成实名认证——个人用户可通过支付宝刷脸或身份证验证（即时生效），企业用户需上传营业执照及法人信息（审核1-3个工作日）。未完成实名认证的账号，无法购买云服务器、开通阿里云百炼服务，进而无法完成OpenClaw部署与API配置，同时需确保账号状态正常，无欠费记录。
飞书账号：注册飞书账号（https://www.feishu.cn/），若为团队使用，建议使用团队管理员账号登录（需拥有飞书企业自建应用创建权限）；个人用户可直接使用个人飞书账号，后续创建个人可见的企业自建应用即可，无需企业认证。需注意，飞书账号需具备企业管理员或开发者权限，若为普通账号，需联系企业组织管理员获取开发者权限，否则无法创建应用与机器人。
阿里云百炼账号：无需单独注册，使用部署OpenClaw的同一阿里云账号 访问阿里云百炼大模型服务平台 即可，用于获取API-Key，为OpenClaw提供大模型授权，需提前开通阿里云百炼服务，若开通时提示“尚未进行实名认证”，请先完成阿里云账号实名认证。

2. 服务器准备（新手首选轻量应用服务器）

新手优先选择阿里云轻量应用服务器，配置要求低、操作简单、成本可控，核心配置参考如下（足够流畅运行OpenClaw并对接飞书）：

实例规格：2vCPU + 2GiB内存 + 40GiB SSD存储（最低配置，可后续弹性升级，基础版推荐2核4GB内存、5Mbps带宽、40GB高效云盘，满足90%用户需求）；
地域选择：优先选择中国香港、新加坡等海外地域（免ICP备案，网络稳定，无联网限制，避免飞书对接时出现通信异常）；国内用户若需对接飞书国内服务器，可选择华东1（杭州）、华北2（北京）地域，目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限；
系统镜像：选择“OpenClaw（原Clawdbot/Moltbot）官方镜像”（应用镜像分类下搜索即可），该镜像基于Alibaba Cloud Linux 3.2104 LTS 64位操作系统，来源于阿里云计算巢，已提前安装好OpenClaw及所有核心依赖，无需手动配置环境；
付费类型：新手推荐“按需付费”（测试阶段成本低，不用可随时停止），长期使用建议“包年包月”，性价比更高；
密码设置：设置复杂登录密码（含大小写、数字、特殊字符），保存好密码与服务器公网IP（后续远程连接、登录控制台需用到）。

已有阿里云服务器的用户，无需重新购买，可通过“实例详情→重置系统”，选择OpenClaw官方镜像，重置前需备份服务器内重要数据（重置系统会清除系统盘数据）；使用阿里云无影云电脑的用户，可直接在无影云电脑控制台选择OpenClaw专属镜像，无需额外配置服务器，可视化操作更适合纯新手。

3. 工具与凭证准备（重点，后续高频使用）

远程连接工具：推荐FinalShell（新手首选，可视化操作，免费），或Xshell、Windows PowerShell、macOS终端，用于远程连接阿里云服务器，执行代码命令；
浏览器：推荐Chrome/Edge，用于登录阿里云控制台、飞书开放平台、OpenClaw Web控制台；
辅助工具：记事本（用于保存服务器公网IP、密码、API-Key、飞书应用凭证等，避免丢失）；
核心凭证（后续逐步获取）：阿里云百炼API-Key（激活OpenClaw AI能力）、飞书应用凭证（App ID、App Secret、Encrypt Key、Verification Token，用于对接飞书）、OpenClaw访问Token（登录Web控制台、配置飞书对接）。

4. 注意事项

网络通畅：部署与对接过程中保持网络稳定，不中断远程连接、不刷新关键配置页面，避免部署失败、凭证获取异常；
端口提前知晓：需放通4个核心端口——22端口（SSH远程连接）、18789端口（OpenClaw通信端口）、8080端口（Web控制台端口）、443端口（飞书对接通信端口），后续将详细拆解放通步骤；
凭证保护：所有获取的API-Key、飞书应用凭证、OpenClaw访问Token需妥善保存，切勿泄露，泄露可能导致账号被盗用、模型调用额度流失或飞书机器人被恶意操作；
版本适配：确保选择的OpenClaw镜像为2026年稳定版（v2026.2.0及以上），旧版本可能存在飞书对接兼容问题，可在阿里云实例创建页面确认镜像版本；
权限确认：提前确认阿里云账号具备轻量应用服务器购买、百炼API-Key创建权限，飞书账号具备企业自建应用创建、机器人配置权限。

三、阿里云OpenClaw(Clawdbot)部署简单速记步骤（4步核心，新手快速上手）

阿里云一键部署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步，5分钟即可完成OpenClaw基础部署，后续再进行飞书对接，快速拥有AI协同助手：

阿里云控制台创建轻量应用服务器实例，选择OpenClaw官方镜像，完成基础配置并启动实例，记录公网IP与登录密码；
登录阿里云百炼控制台，创建API-Key，复制并保存（核心凭证，用于激活OpenClaw AI能力）；
远程连接服务器，执行简单代码命令，配置百炼API-Key并生成OpenClaw访问Token；
登录OpenClaw Web控制台，验证服务正常运行，准备进行飞书对接。

四、详细操作步骤：阿里云部署OpenClaw（含代码命令）

本次操作全程基于阿里云轻量应用服务器（OpenClaw官方镜像），所有代码命令均可直接复制粘贴，无需修改，新手逐一步骤执行即可，全程不超过10分钟，同时适配阿里云无影云电脑用户（步骤基本一致，仅服务器操作略有差异）。

第一步：创建阿里云服务器实例（5分钟，核心部署基础）

登录阿里云控制台，在顶部搜索框输入“轻量应用服务器”，点击进入服务页面；
点击页面右上角“创建实例”，进入实例购买页面，按以下配置填写（新手直接照抄）：
- 地域：中国香港（推荐，免备案，网络稳定，避免飞书对接通信异常）；
- 镜像类型：切换至“应用镜像”，搜索“OpenClaw（原Clawdbot/Moltbot）”，选中官方认证镜像（避免第三方镜像有安全风险，确保为2026年稳定版）；
- 实例规格：默认2vCPU+2GiB内存+40GiB SSD，新手无需修改，足够使用；基础需求较高的用户可选择2核4GB内存、5Mbps带宽、40GB高效云盘；
- 付费类型：按需付费（勾选“我已阅读并同意相关服务条款”），长期使用建议“包年包月”；
- 实例名称：自定义填写（如“OpenClaw-飞书对接”），便于后续管理；
点击“立即购买”，支付成功后，进入“轻量应用服务器实例管理”页面，等待实例创建完成（约1-2分钟）；
实例创建成功后，记录页面中的“公网IP地址”，并点击“重置密码”，设置服务器登录密码（与购买时密码可一致），重置后重启实例（确保密码生效）；
（可选）无影云电脑用户操作：登录阿里云无影云电脑控制台，选择OpenClaw专属镜像，创建云电脑实例，启动后直接进入可视化桌面，无需远程连接，后续步骤直接在云电脑终端执行即可。

避坑提醒

镜像必须选择“OpenClaw官方镜像”，不要选错为系统镜像（如CentOS、Ubuntu），否则需手动配置依赖，新手难以完成；
公网IP地址务必保存好，后续远程连接、登录Web控制台、飞书对接均需用到，地域一旦确定无法修改，需谨慎选择；
实例创建后，默认处于“运行中”状态，若状态为“已停止”，需点击“启动实例”；若实例创建失败，检查阿里云账号是否完成实名认证、是否有足够余额（按需付费无需提前充值，仅使用时扣费）。

第二步：获取阿里云百炼API-Key（3分钟，激活AI能力）

OpenClaw本身不具备AI推理能力，需对接阿里云百炼大模型，通过API-Key获取授权，才能实现指令解析与任务执行，这是核心关键步骤，新手按以下步骤操作，同时支持两种类型的百炼API-Key配置（按Token用量计费、Coding Plan套餐专属API-Key）：

保持服务器实例管理页面不变，打开新浏览器标访问阿里云百炼大模型服务平台，用已实名认证的阿里云账号登录（自动关联，无需重新输入密码）；
登录后，点击左侧导航栏“密钥管理”（默认地域为华北2北京，不同地域API-Key相互独立，无需修改，系统会推荐离服务器最近的百炼模型服务的API Key，时延较低）；
点击“创建API-Key”，系统自动生成一组Access Key ID和Access Key Secret组合密钥，生成后立即点击“复制”，将两组密钥保存到记事本中（关键提醒：该密钥仅创建时可完整查看，页面刷新后Access Key Secret将隐藏，无法再次查看，若怀疑泄露，需立即禁用并重新创建）；
领取免费额度：新用户登录后，会自动弹出“领取免费额度”提示，点击“立即领取”，即可领取90天免费模型调用额度（超7000万tokens），足够前期测试使用；若免费额度耗尽，可充值或订阅百炼Coding Plan套餐，享受固定月费与月度调用额度，性价比更高，Coding Plan仅支持抵扣qwen3-max-2026-01-23和qwen3-coder-plus模型调用费用，不支持调用多模态模型；
权限确认：进入百炼控制台“权限管理”页面，确保当前API-Key已关联“模型调用”权限，若未关联，手动添加并保存；若使用子账号创建API-Key，需确保子账号具备“AliyunDashScopeFullAccess”权限。

补充说明

若使用阿里云百炼Coding Plan，需生成专属API-Key，并使用对应Base URL，按地域区分如下，后续配置需用到：

华北2（北京）：https://coding.dashscope.aliyuncs.com/v1
新加坡：https://coding-intl.dashscope.aliyuncs.com/v1
美国（弗吉尼亚）：https://coding-us.dashscope.aliyuncs.com/v1
未购买Coding Plan的用户，无需单独配置Base URL，使用默认地址即可（https://dashscope.aliyuncs.com/compatible-mode/v1）。

第三步：远程连接服务器，配置OpenClaw（7分钟，含代码命令）

新手优先使用FinalShell远程连接服务器，可视化操作更简单，全程复制代码命令即可，无需手动编写；无影云电脑用户可直接打开桌面终端，跳过远程连接步骤，直接执行后续命令。

1. 远程连接服务器

打开FinalShell，点击左上角“新建连接”，选择“SSH连接”；
填写连接信息：主机（粘贴服务器公网IP）、用户名（默认root）、密码（服务器登录密码）、端口（默认22）；
点击“确定”，双击连接，弹出“连接成功”提示，即完成远程连接（若提示“连接超时”，需检查服务器实例是否运行、22端口是否放通，可在阿里云实例管理页面“防火墙”中查看）。

2. 检查OpenClaw镜像配置（必做）

连接成功后，复制以下命令，粘贴到终端中，按Enter键执行，检查OpenClaw是否已正确安装、依赖是否齐全（兼容旧版Clawdbot命令）：

# 检查OpenClaw版本（兼容旧版Clawdbot命令）
openclaw --version
# 若提示command not found，切换旧命令
clawdbot --version
# 检查Node.js版本（需≥22，OpenClaw运行核心依赖）
node --version
# 检查Docker版本（镜像已预装，用于容器管理）
docker --version
# 查看OpenClaw服务状态（输出active(running)即为正常）
systemctl status openclaw

成功输出OpenClaw版本（如v2026.2.0）、Node.js版本（如v22.0.0）、Docker版本（如26.0.0），且OpenClaw服务状态为active(running)，说明镜像配置正常；若Node.js版本过低，执行以下命令升级；若服务未运行，执行systemctl start openclaw启动服务：

# 升级Node.js至22版本
npm install -g n
n 22
# 验证升级结果
node --version
# 启动OpenClaw服务（若未运行）
systemctl start openclaw
# 设置OpenClaw开机自启，避免服务器重启后服务失效
systemctl enable openclaw

3. 配置百炼API-Key（核心命令，激活AI能力）

复制以下命令，粘贴到终端执行，配置OpenClaw对接阿里云百炼大模型（替换命令中的“你的Access Key ID”和“你的地域Base URL”为实际信息，若未购买Coding Plan，无需修改Base URL）：

# 进入OpenClaw配置目录
cd /root/.openclaw
# 编辑配置文件（中文注释，新手可直接复制，无需修改其他参数）
cat > openclaw.json << EOF
{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "你的Access Key ID",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-max-2026-01-23",
            "name": "qwen3-max-thinking",
            "reasoning": false
          }
        ]
      }
    }
  },
  "gateway": {
    "port": 18789,
    "host": "0.0.0.0"
  },
  "feishu": {
    "enabled": false, # 暂设为false，后续飞书对接时改为true
    "appId": "", # 后续填写飞书App ID
    "appSecret": "", # 后续填写飞书App Secret
    "encryptKey": "", # 后续填写飞书Encrypt Key
    "verificationToken": "" # 后续填写飞书Verification Token
  }
}
EOF

配置说明

baseUrl：根据服务器地域选择，未购买Coding Plan的用户，华北2（北京）地域填写https://dashscope.aliyuncs.com/compatible-mode/v1，新加坡地域填写https://dashscope-intl.aliyuncs.com/compatible-mode/v1；购买Coding Plan的用户，替换为对应地域的Coding Plan Base URL；
apiKey：粘贴第二步获取的Access Key ID，务必填写正确，否则无法调用百炼大模型；
reasoning：必须设置为false，否则会导致回复内容为空，这是OpenClaw对接百炼模型的关键配置；
feishu相关配置：目前暂不填写，后续飞书对接时再补充，enabled设为false避免配置错误导致服务异常。

4. 重启OpenClaw服务，生成访问Token

配置完成后，重启OpenClaw服务使配置生效，并生成访问Token（用于登录Web控制台、后续飞书对接配置），复制以下命令执行：

# 重启OpenClaw服务，使API-Key配置生效
systemctl restart openclaw
# 查看服务运行状态（确保状态为active(running)）
systemctl status openclaw
# 生成OpenClaw访问Token（用于登录Web控制台）
openclaw token generate
# 若使用旧版命令，切换为
clawdbot token generate

执行完成后，终端会输出一串随机字符串（即访问Token），复制并保存到记事本中（丢失后可重新执行generate命令生成），同时可执行以下命令验证API-Key配置是否生效：

# 进入OpenClaw容器环境（可选，用于验证配置）
docker exec -it openclaw-core /bin/bash
# 验证API-Key配置（输出API-Key即为成功）
openclaw config get models.providers.bailian.apiKey
# 退出容器环境
exit

5. 放通核心端口（必做，否则无法访问Web控制台、飞书对接失败）

OpenClaw Web控制台、飞书对接需依赖18789、8080、443端口，需手动放通端口（阿里云控制台可视化操作，无需执行命令，也可通过命令放通）：

回到阿里云轻量应用服务器实例管理页面，点击左侧“防火墙”；
点击“添加规则”，分别添加以下4个端口的入站规则（确保飞书对接与Web控制台访问正常）：
- 端口：22，协议：TCP，来源：0.0.0.0/0（已默认放通，若未放通则添加，用于远程连接）；
- 端口：18789，协议：TCP，来源：0.0.0.0/0（OpenClaw通信端口，飞书对接核心端口）；
- 端口：8080，协议：TCP，来源：0.0.0.0/0（OpenClaw Web控制台端口）；
- 端口：443，协议：TCP，来源：0.0.0.0/0（飞书对接通信端口，确保双向通信）；

保存规则，端口放通完成；也可通过以下命令手动放通端口（Alibaba Cloud Linux/CentOS系统）：

# 手动放通核心端口（永久生效）
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --add-port=8080/tcp --permanent
firewall-cmd --add-port=443/tcp --permanent
firewall-cmd --reload
# 验证端口放通状态（输出对应端口即为成功）
firewall-cmd --list-ports | grep 18789
firewall-cmd --list-ports | grep 8080
firewall-cmd --list-ports | grep 443

避坑提醒

执行配置命令时，确保复制完整，不要遗漏字符或空格，否则会配置失败，若配置错误，可删除配置文件重新执行命令（rm -rf /root/.openclaw/openclaw.json）；

若启动服务提示“失败”，执行以下命令查看错误日志，针对性解决：

# 查看OpenClaw服务错误日志
journalctl -u openclaw
# 查看OpenClaw运行日志（排查错误）
openclaw logs
# 重启服务
systemctl restart openclaw

端口必须全部放通，缺少任意一个端口，都会导致Web控制台无法访问或飞书对接失败；
若使用旧版命令clawdbot启动失败，可替换命令为clawdbot gateway run，确保服务正常运行。

第四步：验证OpenClaw部署成功（1分钟，必做）

打开浏览器，输入地址：http://你的服务器公网IP:8080，跳转至OpenClaw登录页面；
粘贴第三步生成的访问Token，点击“登录”，即可进入OpenClaw全中文Web控制台（左侧为对话窗口，右侧为功能菜单，新手易上手）；
在Web控制台左侧对话窗口，发送以下测试指令，验证AI能力是否激活（即API-Key配置是否正确）：
- 基础指令：“帮我生成一份个人工作周报模板，包含本周工作、下周计划，用中文分点列出”；
- 文档生成指令：“帮我创建一个名为‘OpenClaw部署测试’的文本文件，内容为‘阿里云部署OpenClaw成功，准备对接飞书’”。
若OpenClaw能快速响应，生成符合要求的内容，说明部署成功，AI能力已激活；若提示“模型调用失败”，需检查API-Key填写是否正确、Base URL是否匹配，或百炼免费额度是否耗尽，排查无误后重新配置并重启服务。

五、详细操作步骤：OpenClaw一键接入飞书（含代码命令）

完成OpenClaw部署后，进入核心对接环节，全程分为“创建飞书企业自建应用→获取飞书应用凭证→配置OpenClaw飞书对接→配置飞书机器人→验证对接效果”5步，无需编写代码，复制命令、填写凭证即可完成，新手逐一步骤执行，全程不超过10分钟，同时可通过阿里云AppFlow实现更便捷的对接。

第一步：创建飞书企业自建应用（3分钟，获取对接凭证基础）

打开飞书开放平台（https://open.feishu.cn/），用已注册的飞书账号登录（建议使用管理员账号，确保具备应用创建权限）；
登录后，点击页面右上角“创建应用”，选择“企业自建应用”，填写应用基本信息：
- 应用名称：自定义填写（如“OpenClaw-AI助手”），将显示在飞书机器人列表中；
- 应用描述：简要填写（如“阿里云部署的OpenClaw AI助手，可通过指令自动执行任务”）；
- 应用图标：可选，上传自定义图标（便于在飞书识别）；
- 开发模式：选择“自定义开发”，点击“创建”，完成应用创建。
应用创建成功后，进入应用管理页面，点击左侧导航栏“添加应用能力”，选择“按能力添加”页签，找到“机器人”卡片，点击“添加”，启用机器人功能（飞书对接的核心能力，用于接收指令、反馈结果）；
启用机器人后，点击左侧导航栏“权限管理”，点击“开通权限”，搜索并添加以下5个必需权限（缺少权限会导致对接失败、功能异常），开通后需提交审批（企业自建应用权限审批即时生效，无需等待），权限说明如下表：

权限代码	用途说明	注意事项
im:message:send_as_bot	允许机器人以应用身份发送消息	必需权限，确保OpenClaw可将任务执行结果反馈至飞书
contact:user.employee_id:readonly	获取用户user ID	必需权限，用于识别发送指令的飞书用户身份
im:message.group_at_msg:readonly	允许机器人接收群聊中@它的消息	核心交互权限，群聊场景下必需
im:message.p2p_msg:readonly	允许机器人读取用户私聊发给它的消息	单聊场景下必需
im:message.group_msg	允许机器人获取所在群组的所有消息	敏感权限，按需开通，群聊全消息接收需启用

避坑提醒

应用类型必须选择“企业自建应用”，不要选择“第三方应用”，否则无法获取对接所需的完整权限；
必需权限必须全部开通，缺少任意一个，都会导致飞书无法发送指令、OpenClaw无法反馈结果；
权限开通后需提交审批，否则权限不生效，企业自建应用审批无需等待，提交后即时生效。

第二步：获取飞书应用凭证（2分钟，核心对接凭证）

飞书应用凭证是OpenClaw与飞书对接的核心身份凭证，包括App ID、App Secret、Encrypt Key、Verification Token，需在飞书应用管理页面获取，全部复制保存到记事本中（后续配置需用到），步骤如下：

在飞书应用管理页面，点击左侧导航栏“凭证与基础信息”，找到“应用凭证”模块，复制“App ID”和“App Secret”（这两个凭证用于OpenClaw与飞书的身份认证）；
点击左侧导航栏“事件与回调”，找到“加密策略”页签，复制“Encrypt Key”和“Verification Token”（这两个凭证用于加密通信，避免指令被篡改，确保对接安全）；
若当前Encrypt Key为空，点击“重置”生成一个新Encrypt Key，生成后立即复制保存（仅生成时可完整查看，刷新页面后无法再次获取）；
核对凭证：确保4个凭证（App ID、App Secret、Encrypt Key、Verification Token）全部获取，无遗漏、无拼写错误，粘贴到记事本中，后续配置直接复制使用，避免手动输入出错。

避坑提醒

4个凭证务必保存完整，切勿泄露，泄露可能导致飞书应用被恶意操作、指令被篡改；
App Secret、Encrypt Key仅生成时可完整查看，刷新页面后无法再次获取，若丢失，需重新重置并更新OpenClaw配置；
凭证区分大小写，复制时不要遗漏空格、特殊字符，否则会导致对接失败。

第三步：配置OpenClaw飞书对接（3分钟，含代码命令）

回到远程连接终端（或无影云电脑终端），将飞书应用凭证录入OpenClaw配置文件，启用飞书对接功能，复制以下命令执行（替换命令中的4个凭证为实际获取的飞书凭证，直接复制粘贴，无需修改其他参数）：

# 进入OpenClaw配置目录
cd /root/.openclaw
# 编辑配置文件，补充飞书对接配置（覆盖原有feishu相关配置）
cat > openclaw.json << EOF
{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "你的Access Key ID",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-max-2026-01-23",
            "name": "qwen3-max-thinking",
            "reasoning": false
          }
        ]
      }
    }
  },
  "gateway": {
    "port": 18789,
    "host": "0.0.0.0"
  },
  "feishu": {
    "enabled": true, # 启用飞书对接功能
    "appId": "你的飞书App ID", # 粘贴飞书App ID
    "appSecret": "你的飞书App Secret", # 粘贴飞书App Secret
    "encryptKey": "你的飞书Encrypt Key", # 粘贴飞书Encrypt Key
    "verificationToken": "你的飞书Verification Token", # 粘贴飞书Verification Token
    "webhookUrl": "http://你的服务器公网IP:18789/feishu/webhook", # 飞书回调地址，自动通信
    "replyMode": "direct", # 直接回复指令发送者
    "groupReplyMode": "atReply" # 群聊中@机器人后回复
  }
}
EOF

配置说明

enabled：设为true，启用飞书对接功能，此前设为false是为了避免配置错误导致服务异常；
webhookUrl：飞书回调地址，格式为“http://你的服务器公网IP:18789/feishu/webhook”，替换为自己的服务器公网IP即可，飞书会通过该地址向OpenClaw发送指令，OpenClaw通过该地址反馈结果，务必填写正确；
replyMode：设置为direct，OpenClaw会直接回复给指令发送者（单聊场景）；
groupReplyMode：设置为atReply，群聊中只有@机器人，机器人才会回复，避免无关消息触发回复，减少干扰；
其他参数：无需修改，保持默认即可，确保与飞书接口适配。

配置完成后，重启OpenClaw服务使飞书对接配置生效，复制以下命令执行：

# 重启OpenClaw服务，使飞书对接配置生效
systemctl restart openclaw
# 查看服务运行状态（确保状态为active(running)，无报错）
systemctl status openclaw
# 查看飞书对接日志，确认无异常（可选）
openclaw logs --module feishu

若服务启动正常、日志无报错，说明OpenClaw飞书对接配置完成；若启动失败，检查飞书凭证是否填写正确、webhookUrl是否正确，排查无误后重新配置并重启服务。

补充：通过阿里云AppFlow对接飞书（可选，更便捷）

若觉得手动配置麻烦，可通过阿里云AppFlow实现OpenClaw与飞书的快速对接，步骤如下：

访问阿里云AppFlow控制台，搜索“OpenClaw-飞书对接”模板，点击“立即使用”；
点击“添加飞书鉴权凭证”，填写凭证名称，录入获取的飞书App ID、App Secret、Encrypt Key、Verification Token，点击“确定”并选中该凭证；
创建OpenClaw鉴权凭证，录入OpenClaw访问Token、服务器公网IP，点击“确定”并选中该凭证；
填写OpenClaw回调地址（http://你的服务器公网IP:18789/feishu/webhook），点击“发布”，复制生成的WebhookUrl；
后续步骤参考“第四步：配置飞书机器人”，将WebhookUrl填入飞书事件回调配置中，即可完成对接，无需手动修改OpenClaw配置文件。

第四步：配置飞书机器人（2分钟，确保指令接收与反馈正常）

完成OpenClaw配置后，需在飞书应用管理页面配置机器人事件回调、订阅事件，确保飞书能向OpenClaw发送指令、接收结果，步骤如下：

回到飞书应用管理页面，点击左侧导航栏“事件与回调”，在“事件配置”页签，点击“配置订阅方式”；
选择“将事件发送至开发者服务器”，在“服务器地址”中粘贴第三步配置的webhookUrl（或阿里云AppFlow生成的WebhookUrl），点击“保存”；
在“事件配置”页签的“已添加事件”区域，点击“添加事件”，搜索并添加以下2个核心事件（用于接收指令、反馈结果）：
- 事件1：im.message.receive_v1（接收消息事件，用于接收飞书端发送的指令）；
- 事件2：im.message.send（发送消息事件，用于向飞书端反馈执行结果）；
点击“保存”，完成事件订阅；
点击左侧导航栏“版本管理与发布”，创建版本（自定义版本号，如v1.0.0），填写版本描述（如“OpenClaw AI助手对接版本，支持指令接收与结果反馈”），保存并提交审批；
审批通过后，点击“发布应用”，选择“全量发布”（或“测试发布”，仅指定用户可见），发布后飞书机器人即可正常使用。

避坑提醒

服务器地址（webhookUrl）务必填写正确，否则飞书无法向OpenClaw发送指令，这是对接失败的高频原因；
必须添加“im.message.receive_v1”和“im.message.send”两个事件，缺少任意一个，都会导致指令无法接收或结果无法反馈；
应用必须发布后才能正常使用，未发布的应用，机器人无法接收指令，发布后即时生效；
飞书机器人的Webhook地址需要在PC端获取，暂不支持从移动端获取。

第五步：验证飞书对接效果（1分钟，必做，确认对接成功）

对接完成后，通过飞书单聊、群聊测试指令接收与结果反馈，确保对接成功，步骤如下：

1. 单聊测试（新手首选，简单易操作）

打开飞书客户端，搜索创建的飞书应用名称（如“OpenClaw-AI助手”），进入单聊窗口；
发送以下测试指令，查看OpenClaw是否能正常响应、反馈结果：
- 指令1：“@OpenClaw 帮我生成一份团队工作周报模板，包含本周总结、下周计划、问题与改进”；
- 指令2：“@OpenClaw 帮我抓取阿里云轻量应用服务器的最新优惠，整理成文本发送给我”；
- 指令3：“@OpenClaw 帮我创建一个飞书文档，标题为‘OpenClaw飞书对接测试’，内容为‘对接成功，可正常使用’”。
若OpenClaw能在10-30秒内响应，反馈符合要求的结果（如周报模板、优惠信息、飞书文档链接），说明单聊对接成功；若无响应，检查webhookUrl是否正确、飞书事件是否订阅、OpenClaw服务是否正常运行，排查无误后重新测试。

2. 群聊测试（团队场景必测）

打开飞书群聊，点击群聊设置→“群机器人”→“添加机器人”，搜索并添加创建的OpenClaw机器人；
在群聊中@机器人，发送测试指令（如“@OpenClaw 统计本周群聊中提到的任务，分点列出”）；
若机器人能正常响应，仅回复@它的指令，说明群聊对接成功；若群聊中未@机器人也回复，检查OpenClaw配置中的groupReplyMode是否设为atReply，修改后重启服务。

3. 功能扩展测试（可选，提升实用性）

安装飞书集成相关技能，提升对接实用性，复制以下命令执行（通过ClawHub技能市场安装）：

# 安装ClawHub CLI工具（用于技能管理）
npm i -g clawhub
# 登录ClawHub（使用OpenClaw访问Token）
clawhub login --token 你的访问Token
# 安装飞书文档集成技能（支持创建、编辑飞书文档）
clawhub install feishu-doc-integration
# 安装飞书日程集成技能（支持创建、提醒飞书日程）
clawhub install feishu-calendar-integration
# 安装飞书群聊管理技能（支持统计群聊任务、成员发言）
clawhub install feishu-group-manager
# 重启OpenClaw服务，使技能生效
systemctl restart openclaw

技能安装完成后，发送指令“@OpenClaw 帮我创建一个明天10点的飞书日程，标题为‘OpenClaw使用培训’，邀请我自己参加”，测试日程创建功能；或发送“@OpenClaw 帮我将刚才生成的周报模板保存为飞书文档，分享到当前群聊”，测试文档集成功能，确保技能正常使用。

六、日常运维与基础使用技巧（新手必看）

1. 常用运维命令（复制即用，管理OpenClaw与服务器）

后续需管理OpenClaw服务、升级版本、排查问题时，可使用以下命令，无需复杂操作，同时可添加日志清理定时任务，优化服务器性能：

# 重启OpenClaw服务（配置修改、技能安装后必执行）
systemctl restart openclaw
# 停止OpenClaw服务（长期不使用时）
systemctl stop openclaw
# 查看OpenClaw运行日志（排查错误，按模块查看）
openclaw logs
openclaw logs --module feishu # 仅查看飞书对接日志
openclaw logs --module model # 仅查看模型调用日志
# 升级OpenClaw至最新版本（修复bug，优化飞书适配）
openclaw update
# 重新生成OpenClaw访问Token（丢失后使用）
openclaw token generate
# 重新生成飞书对接凭证（可选，若凭证泄露）
openclaw feishu regenerate-token
# 查看服务器CPU/内存占用（确保运行流畅）
top
# 查看端口占用情况（排查端口冲突）
netstat -tlnp | grep 18789
netstat -tlnp | grep 8080
# 添加日志清理定时任务（每天凌晨0点清理日志）
echo "0 0 * * * rm -rf /root/.openclaw/logs/*.log" >> /etc/crontab
crontab /etc/crontab
# 优化OpenClaw性能（可选）
openclaw config set database.poolSize 20 # 数据库连接池大小20
openclaw config set database.cache.enable true # 开启数据库缓存
systemctl restart openclaw

2. 飞书端使用技巧（提升使用效率）

指令格式：单聊中可直接发送指令，无需@机器人；群聊中必须@机器人，否则机器人不响应，指令需简洁明了，避免模糊表述（如“帮我生成周报”比“周报”更易识别）；
常用指令示例（直接复制发送即可）：
- 文档类：“帮我创建一份飞书文档，标题为‘2026年3月工作计划’，分点列出核心任务”；
- 数据类：“帮我抓取本周行业热点，整理成飞书表格，分享到当前群聊”；
- 日程类：“帮我创建明天下午3点的飞书会议，邀请张三、李四参加，备注‘项目进度同步会’”；
- 协作类：“@OpenClaw 统计当前群聊中未完成的任务，提醒相关人员”；
技能管理：飞书端发送指令“@OpenClaw 列出当前已安装的技能”“@OpenClaw 安装网页抓取技能”，可远程管理OpenClaw技能，无需登录Web控制台；
问题反馈：发送指令“@OpenClaw 查看最近的错误日志”，可快速排查飞书对接、指令执行中的问题。

3. 成本控制技巧（新手必看，避免额外费用）

服务器成本：按需付费用户，长期不使用时，进入阿里云实例管理页面，点击“停止实例”，停止后不产生租赁费用，后续可随时启动；长期使用建议选择“包年包月”，性价比更高；新手避免过度升级实例规格，先使用2核2G测试，不够用再弹性升级（无需重新部署）；
模型调用成本：优先使用阿里云百炼免费额度，简单任务用轻量模型（如qwen-plus），复杂任务用通义千问3-Max，避免滥用高成本模型；登录百炼控制台，设置每月最大消费限额（新手建议50元/月），避免超额费用；启用缓存功能，节省重复查询成本；
资源优化：若OpenClaw执行复杂任务（如多线程网页抓取、大量文档生成）时卡顿，可通过阿里云控制台弹性升级服务器配置（如2核2G升级为2核4G），或执行性能优化命令，无需重新部署与对接；
免费资源：关注阿里云新手优惠，定期领取轻量应用服务器、百炼免费额度；OpenClaw开源免费，飞书对接无需付费，最大化降低使用成本。

4. 安全防护建议（避免凭证泄露、服务异常）

凭证保护：定期更换服务器密码、阿里云百炼API-Key、OpenClaw访问Token、飞书应用凭证（建议每3个月一次），不要随意分享，防止他人误操作、恶意调用；
端口限制：测试完成后，可将端口来源改为个人常用IP段或团队IP段，减少安全风险，避免无关人员访问OpenClaw Web控制台、篡改配置；

数据备份：定期备份OpenClaw配置文件、飞书应用配置，执行以下命令备份OpenClaw配置：

# 备份OpenClaw配置文件（包含API-Key、飞书凭证等）
cp /root/.openclaw/openclaw.json /root/.openclaw/openclaw_backup.json
# 备份OpenClaw日志（排查问题用）
cp -r /root/.openclaw/logs /root/.openclaw/logs_backup

安全审计：定期执行以下命令，排查安全风险，确保服务正常运行：

openclaw security audit --deep
# 检查飞书对接安全配置（可选）
openclaw feishu check-security

版本更新：定期升级OpenClaw至最新版本，修复已知bug、提升安全性、优化飞书适配性，执行openclaw update命令即可完成升级，升级前建议备份配置文件。

七、常见问题排查（90%问题可解决，新手无需联系客服）

新手在部署OpenClaw、对接飞书的过程中，可能会遇到一些小问题，无需慌张，以下是最常见的10个问题，附上具体解决方案，覆盖部署失败、服务异常、飞书对接失效等核心场景，兼顾阿里云、OpenClaw、飞书的适配特点，新手可对照排查，快速解决问题，同时可通过相关命令查看日志定位问题。

问题1：远程连接服务器失败，提示“连接超时”

症状：使用FinalShell连接服务器，提示“连接超时”“无法连接到主机”；
原因：① 服务器实例未启动；② 22端口未放通；③ 公网IP输入错误；④ 服务器地域网络异常；
解决方案：
1. 回到阿里云实例管理页面，确认实例状态为“运行中”，若为“已停止”，点击“启动实例”；
2. 检查防火墙规则，确保22端口已放通（TCP协议，来源0.0.0.0/0）；
3. 核对服务器公网IP，避免拼写错误，可在实例管理页面重新复制；
4. 若为国内地域服务器，检查是否已完成ICP备案（未备案无法远程连接），新手推荐选择香港、新加坡地域（免备案）；
5. 更换远程连接工具（如Xshell），重新尝试连接。

问题2：OpenClaw服务启动失败，提示“API-Key无效”

症状：执行systemctl start openclaw后，服务启动失败，日志提示“API-Key无效”“模型调用权限不足”；
原因：① API-Key填写错误、不完整；② API-Key未关联“模型调用”权限；③ API-Key被禁用；④ 百炼免费额度耗尽；⑤ Base URL与API-Key地域不匹配；
解决方案：
1. 重新复制第二步获取的Access Key ID，修改OpenClaw配置文件（/root/.openclaw/openclaw.json），确保填写正确，无空格、无多余字符；
2. 进入百炼控制台“权限管理”页面，检查API-Key是否已关联“模型调用”权限，若未关联，手动添加并保存；
3. 进入百炼控制台“密钥管理”，检查API-Key状态，若为“禁用”，点击“启用”，或重新创建新密钥；
4. 登录百炼控制台，查看免费额度是否耗尽，若耗尽，可充值或等待额度刷新，新用户可重新领取免费额度；
5. 核对Base URL与API-Key地域是否匹配，未购买Coding Plan的用户使用默认Base URL，购买的用户替换为对应地域的Coding Plan Base URL；
6. 重新配置API-Key，执行systemctl restart openclaw，查看服务是否正常启动。

问题3：飞书发送指令后，OpenClaw无响应

症状：飞书单聊/群聊发送指令后，机器人无任何响应，OpenClaw日志无飞书相关记录；
原因：① 飞书webhookUrl填写错误；② 飞书事件未订阅或订阅错误；③ 飞书应用未发布；④ 18789、443端口未放通；⑤ OpenClaw飞书对接未启用（enabled设为false）；
解决方案：
1. 核对OpenClaw配置文件中的webhookUrl，确保格式正确（http://你的服务器公网IP:18789/feishu/webhook），替换为正确的服务器公网IP；
2. 回到飞书应用管理页面，检查是否已订阅“im.message.receive_v1”和“im.message.send”两个事件，若未订阅，重新添加并保存；
3. 检查飞书应用是否已发布（版本管理与发布页面），未发布的应用无法接收指令，提交审批并全量发布；
4. 检查阿里云防火墙规则，确保18789、443端口已放通，若未放通，添加入站规则；
5. 检查OpenClaw配置文件中feishu.enabled是否设为true，若为false，修改后重启服务；
6. 重启OpenClaw服务（systemctl restart openclaw），重新发送指令测试，查看飞书对接日志（openclaw logs --module feishu）排查异常。

问题4：OpenClaw回复“模型调用失败”

症状：飞书发送指令后，OpenClaw回复“模型调用失败”“无法连接到百炼大模型”；
原因：① API-Key无效或额度耗尽；② 服务器网络无法访问百炼大模型；③ 模型配置错误（reasoning设为true）；④ OpenClaw版本过低；
解决方案：
1. 参考问题2，排查API-Key有效性与额度；
2. 检查服务器网络。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

2026年阿里云部署OpenClaw（Clawdbot）一键接入飞书保姆级教程

一、核心认知：部署对接逻辑与核心优势

1. 整体操作逻辑（新手必懂）

2. 核心优势（为什么首选阿里云+OpenClaw+飞书）

3. 适用场景（看完明确是否需要部署）

二、部署对接前必做准备（5分钟搞定，缺一不可）

1. 账号准备（全部需提前注册/登录）

2. 服务器准备（新手首选轻量应用服务器）

3. 工具与凭证准备（重点，后续高频使用）

4. 注意事项

三、阿里云OpenClaw(Clawdbot)部署简单速记步骤（4步核心，新手快速上手）

阿里云一键部署OpenClaw步骤流程

四、详细操作步骤：阿里云部署OpenClaw（含代码命令）

第一步：创建阿里云服务器实例（5分钟，核心部署基础）

避坑提醒

第二步：获取阿里云百炼API-Key（3分钟，激活AI能力）

补充说明

第三步：远程连接服务器，配置OpenClaw（7分钟，含代码命令）

1. 远程连接服务器

2. 检查OpenClaw镜像配置（必做）

3. 配置百炼API-Key（核心命令，激活AI能力）

配置说明

4. 重启OpenClaw服务，生成访问Token

5. 放通核心端口（必做，否则无法访问Web控制台、飞书对接失败）

避坑提醒

第四步：验证OpenClaw部署成功（1分钟，必做）

五、详细操作步骤：OpenClaw一键接入飞书（含代码命令）

第一步：创建飞书企业自建应用（3分钟，获取对接凭证基础）

避坑提醒

第二步：获取飞书应用凭证（2分钟，核心对接凭证）

避坑提醒

第三步：配置OpenClaw飞书对接（3分钟，含代码命令）

配置说明

补充：通过阿里云AppFlow对接飞书（可选，更便捷）

第四步：配置飞书机器人（2分钟，确保指令接收与反馈正常）

避坑提醒

第五步：验证飞书对接效果（1分钟，必做，确认对接成功）

1. 单聊测试（新手首选，简单易操作）

2. 群聊测试（团队场景必测）

3. 功能扩展测试（可选，提升实用性）

六、日常运维与基础使用技巧（新手必看）

1. 常用运维命令（复制即用，管理OpenClaw与服务器）

2. 飞书端使用技巧（提升使用效率）

3. 成本控制技巧（新手必看，避免额外费用）

4. 安全防护建议（避免凭证泄露、服务异常）

七、常见问题排查（90%问题可解决，新手无需联系客服）

问题1：远程连接服务器失败，提示“连接超时”

问题2：OpenClaw服务启动失败，提示“API-Key无效”

问题3：飞书发送指令后，OpenClaw无响应

问题4：OpenClaw回复“模型调用失败”

热门文章

最新文章

相关电子书