Skip to content

zh usage platforms wecom wecombot

langbot-wiki-sync[bot] edited this page Jul 29, 2026 · 1 revision

企业微信智能机器人

一键配置(推荐)

LangBot 支持一键创建企业微信智能机器人并自动填写 BotId 和 Secret,无需手动复制粘贴。

  1. 打开 LangBot WebUI,进入机器人 > 创建机器人
  2. 填写机器人名称,平台/适配器选择 企业微信智能机器人
  3. 在下方出现的一键创建机器人区域,点击右侧的 开始 按钮

一键创建机器人

  1. 使用企业微信扫描弹出的二维码,手机端会提示「请先创建智能机器人」,点击 一键创建智能机器人

手机端一键创建

  1. 授权成功后,BotId 和 Secret 会自动填入配置表单
  2. 手动填写机器人名称,名称需与企业微信中创建的机器人名称一致

手动填写机器人名称

  1. 点击提交,完成创建

Warning

企业微信智能机器人不能选择已有的机器人进行一键配置,只能新建。如果需要使用已有机器人,请参考下方手动配置。


手动配置

创建机器人

首先登录企业微信管理后台

主页

点击左边栏的安全与管理,点击管理工具里面的智能机器人

如图:

智能机器人

点击创建机器人并选择手动创建,拉至页面最底部,点击API模式创建,进入页面:

API模式创建

长连接配置说明

开启长连接 API 模式

在企业微信管理后台,进入智能机器人的配置页面,开启「API 模式」并选择「长连接」方式:

长连接方式创建

获取凭证

开启长连接 API 模式后,需要获取以下凭证用于建立连接:

凭证 说明
BotID 智能机器人的唯一标识,用于标识机器人身份
Secret 长连接专用密钥,用于身份校验

Warning

注意:

  • Secret 是长连接专用的密钥,与设置接收消息回调地址模式的 Token/EncodingAESKey 不同
  • 请妥善保管 Secret,避免泄露
  • 模式切换影响:API 模式只能选择一种方式(长连接或设置接收消息回调地址),切换到「设置接收消息回调地址」模式会导致现有长连接失效;反之,从「设置接收消息回调地址」切换到「长连接」模式后,原有的回调地址将不再生效

配置机器人

启动 LangBot 主程序,适配器选择 企业微信智能机器人,填写配置项, 将长连接中的botid和secret以及机器人名称填入,点击保存并使用

其中机器人名称要与新建的机器人名称一样,不然群聊会不回复

长连接配置

使用url回调配置说明

点击随机获取 Token 和 EncodingAESKey,然后填写上方的机器人基本信息,注意设置可见范围

参数获取

点击左边栏的我的企业,保存最下方的企业ID。

配置回调地址

启动 LangBot 主程序,适配器选择 企业微信智能机器人,填写配置项, 其中,令牌为 Token,消息加解密密钥为 EncodingAESKey,机器人ID填写入xxx(或者随便填写,后续会改),填写之后点击 保存,并启用机器人。

企业微信智能机器人适配器

在 LangBot 主页中,启用并选择对应的机器人,点击进入配置页面,复制其中的 Webhook 回调地址

Note

推荐您先参照配置 HTTP 反向代理来配置 LangBot 回调地址。

Webhook 回调地址

返回企业微信机器人配置页面将复制的webhook地址填写到URL回调中。若创建成功,则会跳转至详情页面,若出现请求URL失败字样,请再三检查上述操作是否一一完成。

创建成功之后的详情页: 创建成功

复制企业微信机器人详情页的Bot ID和机器人的名称,回到LangBot管理页面,将部署的智能机器人的机器人Id改为复制的ID,并填入机器人名称,重新启动机器人。

开启流式

针对部分本地搭建或者不支持流式的模型新增流式开关

流式开关

开始使用

进入企业微信,点击 ,如图:

添加机器人

点击企业创建的,选择创建的机器人,进入聊天界面。

同理,若想邀请机器人进入群聊,那么点击群聊的添加人员,在其中添加机器人。

效果图

效果图1

LangBot Documentation

Home

简体中文
指南
开发者
API 参考
Other pages
English
Guides
Developers
API Reference
Other pages
日本語
ガイド
開発者
API リファレンス
Other pages

Clone this wiki locally