官方教程:OpenClaw 接入企业微信

通过企业微信管理后台创建 API 模式智能机器人,将 OpenClaw 接入企业微信平台,实现 AI 助手与企业微信的深度整合。

前置准备

在开始配置前,请确认以下事项已准备完成:

  • 您已拥有企业微信管理员账号(仅管理员可登录企业微信网页端)
  • 已完成 OpenClaw 的部署,服务器具有公网 IP 或域名
  • 已准备好 AI 模型的 API Key(如 DeepSeek 等)

接入企业微信

第一步:获取 AI 模型 API Key

以 DeepSeek 为例,登录 DeepSeek API 开放平台,创建 API Key 并妥善保存。

DeepSeek API 开放平台

创建 API Key

注意

API Key 只会在创建后显示一次,关闭窗口后不再出现,请务必立即保存。

API Key 弹窗(只出现一次,务必保存)

第二步:创建企业微信智能机器人

在浏览器打开企业微信管理后台,扫码登录。

企业微信管理后台扫码登录

点击「安全与管理」→「管理工具」,找到智能机器人并点击进入。

安全与管理 → 管理工具 → 智能机器人

在页面下方找到「API 模式」并点击创建。

选择 API 模式创建机器人

填写机器人基本信息

在 URL 字段中填入你的服务器地址:

http://你的域名:18789/wecom
# 或者
http://公网IP地址:18789/wecom

复制

将页面随机生成的 TokenEncoding-AESKey 保存好,后续配置时需要使用。

第三步:登录服务器并初始化配置

登录部署了 OpenClaw 的服务器,执行初始化配置向导:

服务器登录入口

openclaw onboard

复制

执行 openclaw onboard 命令

按照向导提示选择 yes 继续,然后选择 Use existing values

选择 yes 继续

选择 Use existing values

第四步:配置 AI 模型

在 Model/auth provider 列表中选择对应的模型提供商。以 DeepSeek 为例:

  • 选择 OpenAI(DeepSeek 使用 OpenAI 兼容的 API 格式)
  • 选择 (Codex OAuth + API key)
  • 选择 OpenAI API key

选择 OpenAI (Codex OAuth + API key)

输入 DeepSeek API Key,然后选择 Enter model manually,输入模型名称:

  • deepseek-chat(通用对话模型)
  • deepseek-reasoner(强化推理模型)

输入 API Key

手动输入模型名称

第五步:接入企业微信通道

在通道选择列表中,选择 WeCom (plugin)

选择 WeCom (plugin)

选择 Modify settings 开始配置企业微信连接信息。

WeCom 配置界面

选择 Modify settings

填入第二步中保存的 TokenEncoding-AESKey

填入 Token 和 Encoding-AESKey

第六步:选择 AI 技能

从列表中选择需要的 AI 技能(方向键选择,空格键勾选,回车确认)。

选择技能列表

选择 AI 技能

两个重要技能说明:

  • command-logger:记录 AI 执行的每一个命令,是重要的安全监控工具
  • session-memory:让 AI 记住同一对话中的历史内容,使对话更连续自然

其他技能配置选项(按需选择)

第七步:启动网关并设置守护进程

配置完成后,启动 OpenClaw 网关:

openclaw gateway --port 18789 --verbose

复制

OpenClaw 网关启动成功

Ctrl+C 暂停,然后将 OpenClaw 设置为后台守护进程(开机自启):

loginctl enable-linger $(whoami) && "hljs-keyword">export XDG_RUNTIME_DIR=/run/user/$(id -u)
openclaw daemon install
openclaw daemon start
openclaw daemon status

复制

验证企业微信机器人

回到企业微信,打开通讯录,点击智能机器人

企业微信通讯录

企业微信 - 智能机器人列表

点击创建的机器人,发起对话。机器人能以 AI 方式响应则说明接入成功。

与接入 OpenClaw 的企业微信机器人成功对话

常用命令速查

命令 说明
openclaw onboard 初始化配置向导
openclaw gateway --port 18789 --verbose 前台启动网关(调试用)
openclaw daemon install 安装系统守护进程
openclaw daemon start 启动守护进程
openclaw daemon stop 停止守护进程
openclaw daemon status 查看守护进程状态

Webhook 地址格式

类型 地址格式
使用域名 http://你的域名:18789/wecom
使用公网 IP http://公网IP地址:18789/wecom

企业微信对接需要

企业微信接入官方终于出教程了,之前社区的方案各种不靠谱

官方教程质量不错,但企业微信的审核流程太慢了,等了三天才通过

按照教程操作了但企业微信一直提示应用未验证,是不是要企业管理员审批?

运维补充:企业微信的消息推送有频率限制,高并发场景要做削峰处理

@flcam 应用未验证是因为企业微信要求企业管理员在管理后台审批 你自己创建的应用默认是测试状态 找管理员点一下’上线’就好了

@bxbio 削峰处理可以用消息队列 简单方案就是在OpenClaw侧加个rate limiter 每秒最多处理N条消息 超过的排队等待

企业微信对接比钉钉简单