romtuck/openclaw

Fork 0

mattAtomsenses cefb185d38 added wecom setup instruction

2026-01-29 23:41:50 +08:00

6.9 KiB

Raw Blame History

企业微信回调URL配置完整指南

企业微信凭证信息配置

配置项说明

在使用企业微信集成之前,您需要从企业微信管理后台获取以下凭证:

配置项	说明	获取位置
Corp ID	企业ID	企业微信管理后台 > 我的企业
Agent ID	应用ID	应用管理 > 自建应用 > 凭证与基础信息
Secret	应用密钥	应用管理 > 自建应用 > 凭证与基础信息

示例配置

{
  "corpId": "ww7d9accf2f62cf60f",
  "agentId": "1000018",
  "secret": "VCKoO_FXf7E6hGn1bLjRuac5_p0ewiFxinAcDTbFDUE"
}

前提条件

⚠️ 重要: 公网IP要求

企业微信回调URL需要能够被企业微信服务器访问,因此您需要:

具有公网IP的服务器 - 家用电脑通常没有公网IP
开放端口18789 - 在防火墙/安全组中开放此端口

检查您的公网IP

# 方法1
curl ifconfig.me

# 方法2
curl ipinfo.io/ip

如果没有公网IP怎么办?

选项 A: 购买云服务器

阿里云、腾讯云、UCloud等
UCloud提供Moltbot一键部署镜像
价格约 ¥30-100/月

选项 B: 使用内网穿透工具

ngrok (免费版有限制)
frp (需要有自己的服务器)
Tailscale (点对点连接,需要两端都安装)

步骤 1: 在企业微信管理后台创建机器人

1.1 登录企业微信管理后台

访问: https://work.weixin.qq.com/

使用具有企业管理员权限的账号登录。

1.2 创建机器人

导航至: 安全与管理 > 管理工具
点击 "创建机器人" 按钮
滑到页面底部,点击 "API模式创建" 按钮

1.3 填写机器人信息

配置项	值	说明
名称	Moltbot助手	自定义名称
简介	AI企业助手	自定义简介
可见范围	选择部门/成员	谁可以使用此机器人
URL	`http://12.12.12.12:18789/wecom`	⚠️ 替换为您的实际公网IP
Token	点击"随机获取"按钮	自动生成
EncodingAESKey	点击"随机获取"按钮	自动生成(43位字符串)

URL格式说明

http://公网IP地址:18789/wecom

示例: 假设您的公网IP地址是 12.12.12.12,那么URL应该是:

http://12.12.12.12:18789/wecom

1.4 重要提示

⚠️ 暂时不要点击"创建"按钮

先保存生成的 Token 和 EncodingAESKey,后续配置Moltbot时会用到。

步骤 2: 配置Moltbot

2.1 打开Moltbot Web UI

访问: http://127.0.0.1:18789/

2.2 修改配置文件

点击 Settings → Config → Authentication
在页面底部选择 Raw 查看方式
找到或添加以下配置:

{
  "channels": {
    "wecom": {
      "enabled": true,
      "webhookPath": "/wecom",
      "token": "从企业微信页面复制的Token",
      "encodingAESKey": "从企业微信页面复制的EncodingAESKey",
      "receiveId": "",
      "dm": {
        "policy": "pairing"
      }
    }
  }
}

2.3 配置示例

{
  "channels": {
    "wecom": {
      "enabled": true,
      "webhookPath": "/wecom",
      "token": "moltbot_wecom_2026_randomstring",
      "encodingAESKey": "abcdefghijklmnopqrstuvwxyzABCDE1234567",
      "receiveId": "",
      "dm": {
        "policy": "pairing"
      }
    }
  }
}

2.4 保存并应用配置

点击 Save 保存配置
点击 Update 更新配置
重启网关:

# 方法1: 使用命令行
moltbot gateway restart

# 方法2: 使用pnpm
pnpm moltbot gateway restart

步骤 3: 完成企业微信机器人创建

3.1 回到企业微信管理后台

返回之前的机器人创建页面。

3.2 创建机器人

点击 "创建" 按钮
创建成功后,会显示二维码

3.3 添加机器人

用企业微信手机APP扫码添加机器人
或者在企业微信PC端搜索机器人名称添加
添加完成后,即可在聊天窗口中与机器人对话

步骤 4: 验证配置

4.1 检查Moltbot状态

moltbot channels status

预期输出:

Gateway reachable.
- WeCom default: enabled, configured, running

4.2 测试机器人

在企业微信中发送测试消息:

你好

如果配置正确,机器人应该会回复。

常见问题

1. 配置验证失败

检查清单:

✅ 公网IP是否正确
✅ 端口18789是否开放 (防火墙/安全组)
✅ Moltbot网关是否正在运行
✅ Token和EncodingAESKey是否完全一致

2. 查看日志

# 查看网关日志
tail -f /tmp/moltbot/moltbot-*.log

# 查看企业微信相关日志
tail -f /tmp/moltbot/moltbot-*.log | grep -i wecom

3. 机器人无响应

可能原因:

网关未启动 - 检查 moltbot gateway status
端口未开放 - 检查防火墙配置
回调URL错误 - 确认格式为 http://公网IP:18789/wecom
凭证不匹配 - 重新检查Token和EncodingAESKey

高级配置

DM策略配置

dm.policy 支持以下选项:

策略	说明
`open`	任何人都可以直接与机器人对话
`pairing`	需要配对后才能对话 (推荐)
`allowlist`	仅允许列表中的用户对话

允许列表配置

{
  "channels": {
    "wecom": {
      "enabled": true,
      "webhookPath": "/wecom",
      "token": "your_token",
      "encodingAESKey": "your_encoding_aes_key",
      "receiveId": "",
      "dm": {
        "policy": "allowlist",
        "allowFrom": ["user1", "user2"]
      }
    }
  }
}

安全建议

使用HTTPS - 生产环境建议使用HTTPS回调URL
保护密钥 - 不要将Token和EncodingAESKey提交到版本控制
限制访问 - 使用allowlist策略限制机器人访问
定期轮换 - 定期更换Token和EncodingAESKey

参考资料

官方文档

社区资源

附录: 完整配置示例

{
  "channels": {
    "wecom": {
      "enabled": true,
      "webhookPath": "/wecom",
      "token": "随机生成的Token",
      "encodingAESKey": "随机生成的43位EncodingAESKey",
      "receiveId": "",
      "dm": {
        "policy": "pairing"
      },
      "allowFrom": []
    }
  },
  "gateway": {
    "bind": "0.0.0.0",
    "port": 18789
  }
}

最后更新: 2026-01-29 文档版本: 1.0.0

6.9 KiB Raw Blame History