实战指南:将 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 的安装版本

bash 复制代码
openclaw --version
which openclaw

注意 :如果版本低于 1.0,请务必升级至最新的 2.1 版本 。

更多updating内容,可参考OpenClaw 官方内容

步骤 2:安装飞书插件

运行以下命令安装飞书专用插件,并确认加载状态 :

bash 复制代码
# 安装插件
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) 发布版本 :点击"版本管理与发布",创建并发布一个版本。注意:只有发布后的应用才能配置事件回调 。

步骤 4:OpenClaw 通道配置

回到 EC2 终端,将获取的凭证配置到 OpenClaw 中,并启用长连接模式 :

bash 复制代码
# 设置应用信息
openclaw config set channels.feishu.appId "您的AppID"
openclaw config set channels.feishu.appSecret "您的AppSecret"
openclaw config set channels.feishu.verificationToken "您的VerificationToken"

# 启用并配置 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

可以通过查看配置文件检查是否配置成功

步骤 5:配置飞书事件订阅

回到飞书开放平台"事件与回调"页面 ,

  • 事件配置:

选择订阅方式 为"长连接"

加事件 :搜索并添加 im.message.receive_v1(接收消息 v2.0),以允许机器人接收用户消息 。

  • 回调配置

选择订阅方式 为"长连接"

四、 实测与验收

在飞书客户端搜索您创建的机器人名称(如 Bot_Mars),直接发送消息(如"深圳天气如何")。如果配置正确,OpenClaw 将调用 Bedrock 模型处理请求并返回结果 。

五、 常见问题排查与注意事项

1、如果在连接过程中出现失败,请检查以下内容:

  • 进程冲突 :确保没有多个网关进程(如 clawdbot-gateway 和 openclaw-gateway)同时运行,这会导致端口占用和连接失败 。

  • 版本匹配:确保 OpenClaw 版本与插件版本兼容 。

以下是可能会用到的命令

bash 复制代码
# 查看到当前 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.log

2、确保 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)

相关推荐
Pniubi4 小时前
基于openclaw开发skill与自研agent中的skill开发区别
服务器·agent·skill·openclaw·龙虾
进击的雷神3 天前
把 Claude/GPT 接进飞书、Telegram、Discord:一条命令跑起来的 OpenClaw 部署工具
gpt·飞书·openclaw
鬼手点金4 天前
opencode-隐私优先配置
服务器·前端·javascript·bug·openclaw
AC赳赳老秦7 天前
OpenClaw 与 FineBI 联动方案:公开数据自动采集与实时业务分析看板实践
大数据·开发语言·python·php·finebi·deepseek·openclaw
dtsola8 天前
一个人怎么指挥一支 AI 队伍
人工智能·程序员·ai创业·独立开发者·openclaw·一人公司·小遥claw
七夜zippoe8 天前
Agent 自动化测试:怎么给“会自己决策“的程序写测试
ai·自动化·agent·测试·openclaw
AC赳赳老秦9 天前
采集行为合规自检:OpenClaw 自动校验 robots 协议与采集频率,规避违规采集风险
java·开发语言·c++·python·php·deepseek·openclaw
AC赳赳老秦9 天前
OpenClaw 数据引用规范自动生成:为公开数据构建可信来源标注与标准引用体系
大数据·开发语言·汇编·数据库·人工智能·deepseek·openclaw
AC赳赳老秦10 天前
数据采集全链路审计留痕:用 OpenClaw 实现合规审计与追溯
开发语言·汇编·python·php·swift·deepseek·openclaw
AC赳赳老秦13 天前
公开音频转写信息提取:OpenClaw 处理发布会与听证会文本并提取核心决策信息
大数据·开发语言·汇编·数据库·人工智能·deepseek·openclaw