实战指南：将 OpenClaw 集成至飞书，构建自动化办公智能体

一、 前言在企业自动化办公场景中将强大的爬虫与自动化工具集成到即时通讯软件IM中是提高效率的关键 。OpenClaw原 Moltbot作为一款开源的抓取与自动化工具通过与飞书Feishu机器人的集成可以实现高效的信息推送、智能问答及任务自动化 。本文将详细介绍如何在 AWS 环境下完成这一集成过程如果还没在AWS EC2上部署 OpenClaw,可参考文章:OpenClaw(Moltbot) Amazon Bedrock 构建企业级全能 Agent 实战指南二、 基础环境配置在开始集成前请确保您已具备以下基础环境 云基础设施AWS 俄勒冈区域Oregon已创建 VPC、子网及安全组 。计算资源启动 AWS EC2 实例推荐机型t4g.medium运行 Ubuntu 系统 。软件环境已安装 Node.js、Docker 以及 OpenClaw 核心组件 。模型集成配置 Amazon Bedrock推荐使用Nova 2 Lite模型global.amazon.nova-2-lite-v1:0并生成安全网关令牌 。三、 详细操作步骤步骤 1检查与更新 OpenClaw 状态首先在 EC2 终端确认 OpenClaw 的安装版本openclaw --version which openclaw注意如果版本低于1.0请务必升级至最新的2.1版本 。更多updating内容,可参考OpenClaw 官方内容步骤 2安装飞书插件运行以下命令安装飞书专用插件并确认加载状态 # 安装插件 openclaw plugins install m1heng-clawd/feishu # 检查状态确保 Feishu 插件显示为 loaded openclaw plugins list步骤 3飞书开放平台配置1) 创建应用登录飞书开放平台在“开发者后台”创建“企业自建应用”填写应用名称如Bot_Mars并点击创建 。2) 添加能力在应用详情页点击“添加应用能力”选择“机器人” 。3) 获取凭证在“凭证与基础信息”中记录App ID和App Secret在“事件与回调”中记录Verification Token。4) 开通权限在“权限管理”中根据业务需求开通“应用身份权限”及“用户身份权限” 。5) 发布版本点击“版本管理与发布”创建并发布一个版本。注意只有发布后的应用才能配置事件回调。步骤 4OpenClaw 通道配置回到 EC2 终端将获取的凭证配置到 OpenClaw 中并启用长连接模式 # 设置应用信息 openclaw config set channels.feishu.appId 您的AppID openclaw config set channels.feishu.appSecret 您的AppSecret openclaw config set channels.feishu.verificationToken 您的VerificationToken # 修改配置后 需要重启docker 更新gateway # 查找 openclaw 的 container id docker ps # 重启 docker,更新 gateway docker restart container id # 启用并配置 WebSocket 通道 openclaw config set channels.feishu.enabled true openclaw config set channels.feishu.connectionMode websocket openclaw config set channels.feishu.domain feishu openclaw config set channels.feishu.dmPolicy open openclaw config set channels.feishu.groupPolicy open openclaw config set channels.feishu.requireMention false可以通过查看配置文件检查是否配置成功。默认 openclaw 的配置文件在/home/ubuntu/.openclaw/openclaw.json步骤 5配置飞书事件订阅回到飞书开放平台“事件与回调”页面 ,事件配置:选择订阅方式为“长连接”加事件搜索并添加im.message.receive_v1接收消息 v2.0以允许机器人接收用户消息 。回调配置选择订阅方式为“长连接”四、 实测与验收在飞书客户端搜索您创建的机器人名称如Bot_Mars直接发送消息如“深圳天气如何”。如果配置正确OpenClaw 将调用 Bedrock 模型处理请求并返回结果 。注意第一次和机器人对话时如果出现如下回复说明飞书插件已经正常工作了需要进行授权配对在lightsail 实例上执行命令即可。openclaw pairing approve feishu pairing code五、 常见问题排查与注意事项1、如果在连接过程中出现失败请检查以下内容进程冲突确保没有多个网关进程如clawdbot-gateway和openclaw-gateway同时运行这会导致端口占用和连接失败 。版本匹配确保 OpenClaw 版本与插件版本兼容 。以下是可能会用到的命令# 查看到当前 OpenClaw 进程实际占用的端口号 netstat -tunlp | grep openclaw # 强制重启解决端口冲突 openclaw gateway stop sleep 2 openclaw gateway start # 清理进程 pkill -f openclaw.*gateway pkill -f clawdbot-gateway # 检查端口占用 lsof -i :18789 ### 8. 配置验证 # 验证配置完整性 openclaw config get channels.feishu | jq . # 检查必需参数 echo 检查配置完整性 openclaw config get channels.feishu.appId openclaw config get channels.feishu.appSecret openclaw config get channels.feishu.verificationToken openclaw config get channels.feishu.enabled ### 关键成功指标 # 成功的日志标志 grep feishu: WebSocket client started /tmp/openclaw/openclaw-2026-02-03.log grep feishu: bot open_id resolved /tmp/openclaw/openclaw-2026-02-03.log grep ws client ready /tmp/openclaw/openclaw-2026-02-03.log2、确保 OpenClaw 机器人能正常接收用户输入并回传对话内容:应用身份权限:接收单聊消息(im:message.p2p_msg:readonly)、接收群聊消息(im:message.group_at_msg:readonly)、以应用身份发送消息(im:message:send_as_bot)、获取单聊、群聊消息记录(im:message.p2p_msg:readonly,im:message.group_msg:readonly)用户身份权限:获取用户基本信息(contact:user.base:readonly)、获取用户 ID(contact:user.employee_id:readonly)