OpenClaw 企业微信配置完全指南OpenClaw

什么是 OpenClaw 企业微信集成？

OpenClaw 支持通过企业微信应用与用户交互，让你可以在企业微信中直接使用 AI 助手。通过企业微信集成，你可以：

• 在企业微信中与 AI 助手私聊
• 在群组中使用机器人
• 发送和接收文本、图片、文件等多种消息类型
• 实现企业内部的智能助手服务

本文将详细介绍如何从零开始配置 OpenClaw 企业微信应用。

---

前置准备

1. 安装 OpenClaw

pnpm add -g openclaw
openclaw --version

2. 企业微信账号

• 需要企业微信管理员权限
• 企业需要已完成认证（部分功能需要）

---

第一步：创建企业微信应用

1. 访问企业微信管理后台

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

2. 创建自建应用

1. 点击 应用管理 → 自建 → 创建应用
2. 填写应用名称、介绍、Logo
3. 设置可见范围

3. 获取应用凭证

• AgentId：应用的唯一标识
• Secret：应用密钥

4. 获取企业 ID

在 我的企业 页面找到 企业 ID（CorpId）

---

第二步：配置接收消息

配置回调 URL

在应用详情页 接收消息 部分：

1. URL：https://your-domain.com/wecom/callback
2. Token：随机字符串
3. EncodingAESKey：点击随机获取

⚠️ 配置前需要先启动 OpenClaw 网关！

---

第三步：配置 OpenClaw

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "wecom": {
      "enabled": true,
      "agent": {
        "corpId": "你的企业ID",
        "corpSecret": "你的Secret",
        "agentId": "1000002",
        "token": "你的Token",
        "encodingAESKey": "你的AESKey",
        "welcomeText": "你好！我是 AI 助手",
        "dm": {
          "policy": "open"
        }
      }
    }
  }
}

---

第四步：启动并测试

# 启动网关
openclaw gateway

# 查看状态
openclaw gateway status

在企业微信中找到应用，发送消息测试。

---

访问控制配置

开放模式

{
  "dm": { "policy": "open" }
}

白名单模式

{
  "dm": {
    "policy": "allowlist",
    "allowFrom": ["user1", "user2"]
  }
}

配对模式

{
  "dm": { "policy": "pairing" }
}

---

常用命令

# 网关管理
openclaw gateway status
openclaw gateway restart
openclaw logs --follow

# 配对管理
openclaw pairing list wecom
openclaw pairing approve wecom <配对码>

---

故障排除

回调验证失败

1. 确认网关正在运行
2. 测试 URL 是否可访问
3. 检查 Token 和 EncodingAESKey

收不到消息

1. 确认回调配置已保存
2. 检查应用可见范围
3. 查看日志：openclaw logs --follow

---

配置速查表

配置项	说明
corpId	企业 ID
corpSecret	应用密钥
agentId	应用 ID
token	回调验证 Token
encodingAESKey	消息加密密钥
dm.policy	私聊策略

---

总结

配置步骤：

1. ✅ 创建企业微信应用并获取凭证
2. ✅ 配置回调 URL
3. ✅ 在 OpenClaw 中添加配置
4. ✅ 启动网关并测试

官方文档：https://docs.openclaw.ai

祝你使用愉快！🎉