WeCom 企业微信机器人接入 OpenClaw,长连接模式部署分步教学(含安装包)
OpenClaw v2.7.9 接入企业微信完整图文教程搭建企业智能协作机器人前置准备openclaw Windows 客户端安装包https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80CmacOS 客户端安装包https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C整合包大小 45.8MB内置全部运行依赖可视化方式完成部署。本地完成 OpenClaw v2.7.9 Windows 客户端部署程序能够正常启动运行。保证 OpenClaw 顶部 Gateway 服务处于在线状态。电脑安装并登录企业微信客户端。当前企业微信账号拥有智能机器人创建、管理相关权限。准备可供测试的企业微信账号或者群聊空间用于发送消息验证连通效果。参考链接 企业微信官网https://work.weixin.qq.com/图文操作步骤步骤 1进入企业微信工作台打开智能机器人页面启动企业微信客户端点击左侧【工作台】在应用列表找到【智能机器人】并点击进入。步骤 2新建智能机器人进入智能机器人页面左侧菜单栏选择【创建】点击页面中的【创建机器人】按钮。步骤 3完善场景描述并完成创建弹出创建窗口场景描述可以自定义填写也可以选择留空设置完成点击右下角【创建】。步骤 4进入资料编辑页面机器人创建完成后自动跳转详情页面点击机器人名称右侧编辑按钮准备修改机器人基础信息。步骤 5配置机器人头像、名称、简介在弹出编辑窗口中完成设置自定义机器人头像、填写机器人名称与简介全部设置完成点击【确定】保存。步骤 6选择 API 模式创建机器人回到机器人详情页面向下滚动页面点击【API 模式创建】。后续将使用 Bot ID 以及 Secret完成企业微信机器人与 OpenClaw 的对接。步骤 7选择长连接方式获取 Secret 密钥进入 API 配置界面 连接方式勾选【使用长连接】 在 Secret 栏目点击【点击获取】 记录页面展示的 Bot ID 与 Secret两组参数会填写至 OpenClaw 配置面板。步骤 8展开权限配置列表页面向下滑动找到【可使用权限】区域点击右上角展开按钮进入完整权限配置弹窗。步骤 9一键完成全部权限授权在权限弹窗滚动至页面底部点击【全部授权】一次性开通机器人运行所需各类权限。步骤 10确认授权生效授权操作结束页面顶部弹出【全部授权成功】提示出现提示即代表权限配置完成返回上一级页面继续操作。步骤 11核对权限状态并保存配置回到 API 配置页面逐项确认权限标识均显示【已授权】核对无误后点击页面底部【保存】。步骤 12打开 API 配置页面复制参数保存设置后跳转机器人详情页面点击【API 配置】准备复制对接所需参数。步骤 13复制 Bot ID 与 Secret在 API 配置页面复制两组关键参数Bot ID、Secret。妥善保存内容后续填写至 OpenClaw 企业微信渠道配置栏。步骤 14OpenClaw 打开聊天配置安装企业微信插件切换至 OpenClaw 客户端 点击右上角【设置】 左侧菜单栏选择【聊天配置】 找到【企业微信WeCom】配置卡片 如果页面出现【安装插件】按钮代表尚未部署对应连接器点击按钮完成插件安装等待进程结束再继续配置参数。步骤 15粘贴参数并保存渠道配置将企业微信后台复制得到的参数依次填入对应输入框Bot ID、Secret。 信息填写完毕点击右上角【保存渠道配置】。步骤 16进入机器人对话页面配置保存成功后返回企业微信机器人详情页面点击右上角【去使用】。步骤 17发送测试消息验证连通性进入机器人对话页面点击【发消息】向机器人发送测试文本。步骤 18检验机器人回复效果在对话窗口发送消息例如 “你好”机器人正常输出回复内容代表企业微信渠道成功接入 OpenClaw v2.7.9。接入完成自检清单已在企业微信客户端成功创建智能机器人机器人采用 API 模式创建API 连接方式选择【使用长连接】Bot ID 和 Secret 已经完整获取并妥善保存机器人全部可用权限完成授权OpenClaw v2.7.9 企业微信插件安装完毕Bot ID、Secret 准确填写至对应输入框执行【保存渠道配置】操作在企业微信向机器人发送测试消息能够正常收到回复。常见问题1. OpenClaw 企业微信板块出现 “安装插件” 按钮是什么原因企业微信消息互通功能依赖配套插件 wecom/wecom-openclaw-plugin。若 OpenClaw 内未检测到此插件页面会展示安装按钮直接点击安装等待部署完成即可。2. OpenClaw 中需要录入哪些参数录入企业微信机器人 API 配置页面获取的两组内容Bot ID、Secret分别填入 OpenClaw 企业微信渠道对应的输入框。3. 为什么需要执行全部授权操作权限缺失会造成机器人无法读取消息、执行指令、返回应答内容。按照教程选择全部授权可以规避接入成功但是机器人无法正常回复的各类问题。4. 保存配置之后机器人依旧无法回复消息如何排查按照顺序逐项检查OpenClaw 顶部 Gateway 服务是否处于在线状态企业微信插件是否完整安装Bot ID、Secret 复制内容完整前后不存在多余空格企业微信 API 设置中连接方式选定【使用长连接】机器人权限是否全部授权完成是否点击右上角【保存渠道配置】 排查完成后依旧异常可以重启 OpenClaw 客户端再次测试。参考链接企业微信官网https://work.weixin.qq.com/