Moment

OpenClaw 微信接入完整教程：从零配置到上线

OpenClaw 微信接入完整教程：从零配置到上线

2026年最新版 | 涵盖官方 ClawBot 插件、企业微信、服务号、个人号四种接入方案

OpenClaw 作为强大的 AI 助手平台，国内用户最关心的功能之一就是如何接入微信生态。目前 OpenClaw 官方支持四种微信接入方式，从最简单的扫码即用到完整的服务号对接，满足不同场景需求。

本文为你提供一份保姆级教程，涵盖所有接入方式的详细步骤、配置参数和常见问题。

📊 接入方式对比

方式 难度 稳定性 成本 适用场景
微信 ClawBot 插件 ⭐ 简单 ✅ 高 免费 个人用户，扫码即用（官方推荐）
企业微信 ⭐⭐ 中等 ✅ 高 免费 企业团队，工作协作
微信服务号 ⭐⭐⭐ 复杂 ✅ 高 需认证费 企业对外服务
微信个人号 ⭐⭐ 较复杂 ⚠️ 风险高 免费 个人使用、测试

📌 推荐优先级：ClawBot > 企业微信 > 服务号 > 个人号

方式一：微信 ClawBot 插件（官方推荐 ⭐⭐⭐）

微信已正式上线「ClawBot」插件，这是最省心的接入方式。用户通过扫码或复制命令，即可将 OpenClaw 接入微信作为联系人直接对话，无需任何配置。

路径 1：腾讯云 Lighthouse 接入

如果你使用腾讯云轻量应用服务器（Lighthouse）部署 OpenClaw：

  1. 登录 腾讯云控制台
  2. 进入你的 Lighthouse 实例 → 应用管理
  3. 一键更新到最新版 OpenClaw
  4. 进入「微信通道」→ 扫码直连

路径 2：WorkBuddy 接入

使用 WorkBuddy 桌面端：

  1. 打开 WorkBuddy 桌面端
  2. 点击左下角个人头像 → Claw 设置
  3. 进入「微信通道」→ 扫码直连

路径 3：QClaw 本地接入

本地桌面客户端：

  1. 更新 QClaw 桌面端至 v0.1.15 及以上版本
  2. 左下角会自动弹出弹窗 → 扫码直连

✅ 优势：官方支持，无封号风险，3分钟搞定

方式二：企业微信接入（⭐⭐ 推荐）

企业微信是团队协作的最佳选择，OpenClaw 可作为企业内部 AI 助手，支持群聊 @ 和私聊。

1. 创建企业微信应用

  • 登录企业微信管理后台
  • 进入「应用管理」→「应用」→「创建应用」
  • 填写应用信息：
    • 应用名称：OpenClaw
    • 应用介绍：AI 智能助手
    • 上传应用 Logo（可选）
    • 可见范围：选择可使用该应用的成员
  • 点击「创建应用」

2. 获取应用凭证

在应用详情页面获取以下配置信息：

参数 位置 示例
corpId 「我的企业」→ 企业ID ww1234567890abcdef
agentId 应用详情页顶部 1000001
secret 应用详情页底部 mZi7Gxxxxxxxxxxxxxxxxxxxx

这三个参数是后续配置的关键，请妥善保存。

3. 配置接收消息

OpenClaw 需要通过 Webhook 接收企业微信消息：

  1. 在应用详情页找到「接收消息」配置区域
  2. 设置以下参数：
    • URL：https://your-domain.com/wechat/callback
    • Token：自定义一个字符串（如 OpenClawToken123）
    • EncodingAESKey：点击「随机生成」
    • 消息加解密方式：安全模式（推荐）

⚠️ 注意：如果 OpenClaw 部署在本地，需要使用内网穿透工具（如 ngrok、frp、Cpolar）将本地服务暴露到公网，获取一个可公网访问的 URL。

4. 配置 OpenClaw

打开终端，执行 OpenClaw 配置命令（或直接编辑配置文件）：

# 打开配置文件
openclaw config edit

在 channels 部分添加企业微信配置：

{
  "channels": {
    "wechat-work": {
      "enabled": true,
      "corpId": "YOUR_CORP_ID",
      "agentId": "YOUR_AGENT_ID",
      "secret": "YOUR_SECRET",
      "token": "YOUR_TOKEN",
      "encodingAESKey": "YOUR_AES_KEY"
    }
  }
}

保存配置后重启网关：

openclaw gateway restart

5. 验证配置

  1. 在企业微信工作台找到「OpenClaw」应用
  2. 发送一条测试消息，例如：“今天天气怎么样？”
  3. 查看 OpenClaw 日志：openclaw logs -f
  4. 确认 OpenClaw 正常回复

方式三：微信服务号接入（⭐⭐⭐ 复杂）

如果你的组织需要对外提供 AI 服务（如客服、查询），可以使用微信服务号接入。

前置准备

  • 已认证的微信服务号（需支付 300 元/年认证费）
  • 公众号管理员权限
  • 拥有开发者权限

1. 配置服务器

  1. 登录微信公众平台
  2. 进入「开发」→「基本配置」
  3. 填写服务器配置：
    • URL：https://your-domain.com/wechat/callback
    • Token：自定义令牌（如 OpenClawServiceToken）
    • EncodingAESKey：点击「随机生成」
    • 消息加解密方式：安全模式
  4. 点击「提交」

2. 获取凭证

在「开发」→「基本配置」页面获取：

参数 说明
appId 公众号 AppID
appSecret 公众号 AppSecret

3. 配置 OpenClaw

在 openclaw.json 中添加：

{
  "channels": {
    "wechat-mp": {
      "enabled": true,
      "appId": "YOUR_APP_ID",
      "appSecret": "YOUR_APP_SECRET",
      "token": "YOUR_TOKEN",
      "encodingAESKey": "YOUR_AES_KEY"
    }
  }
}

重启网关生效。

4. 配置菜单和自动回复

在公众平台后台配置：

  • 自定义菜单：设置菜单项，引导用户使用
  • 关键词自动回复：设置常见问题自动回复
  • 关注自动回复：新用户关注时的欢迎语

方式四：微信个人号接入（社区方案 ⚠️ 有风险）

⚠️ 重要警告：个人微信接入基于第三方桥接工具，存在封号风险。

安全使用原则：

  • ✅ 建议使用小号测试，不要使用主号
  • ✅ 定位为「私人助理」，非「群发机器」
  • ✅ 杜绝短时间内批量发送营销内容
  • ✅ AI 输出必须经过内容过滤

**安全场景：**日程提醒、文档整理、知识问答
**高风险场景：**无差别骚扰、营销轰炸、频繁外链

方案 A：腾讯云轻量服务器部署（最稳定）

这是目前社区公认最稳定的个人微信接入方案。

1. 创建服务器实例

  1. 登录 腾讯云轻量应用服务器
  2. 创建实例：
    • 镜像：Ubuntu 22.04 LTS（推荐）或 Docker CE
    • 规格：2核 2GB
    • 月流量：建议 ≥ 200GB
    • 地域：优先选择华南（广州）或华东（上海）

2. 环境初始化

SSH 连接到服务器：

# 安装 Docker
curl -fsSL https://get.docker.com | bash -s docker
sudo systemctl enable docker
sudo systemctl start docker

3. 部署 OpenClaw 容器

docker run -d \
  --name openclaw-wechat \
  --restart always \
  -p 8080:8080 \
  -e WECHAT_API_KEY="your_api_key_here" \
  -e AI_MODEL="gpt-4o-mini" \
  openclaw/wechat-ai:latest

参数说明：

  • WECHAT_API_KEY：在 OpenClaw 官网申请的个人微信 API Key
  • AI_MODEL：支持 gpt-4o-mini、claude-3.5-sonnet 等主流模型

4. 配置 Webhook

在 OpenClaw 管理后台（或配置文件）设置回调地址：

{
  "channels": {
    "wechat": {
      "webhookHost": "你的服务器公网IP",
      "webhookPort": 8080,
      "webhookPath": "/webhook"
    }
  }
}

5. 扫码绑定

  1. 浏览器访问 http://你的服务器IP:8080/qrcode
  2. 页面显示登录二维码
  3. 使用个人微信扫码，点击「登录网页版微信」
  4. 控制台输出 [INFO] WeChat login success 表示绑定成功

6. 功能验证

发送测试消息：

今天深圳天气怎么样？

或拉入群聊 @机器人：

总结以上 10 条消息

正常情况下 3 秒内会得到回复。

方案 B：使用 Wechaty 桥接（开源方案）

Wechaty 是一个开源的微信个人号接口框架。

1. 安装 Wechaty

npm install wechaty wechaty-puppet-wechat

2. 编写桥接脚本 wechaty-bot.js

const { WechatyBuilder } = require('wechaty')

const bot = WechatyBuilder.build({
  puppet: 'wechaty-puppet-wechat',
})

bot
  .on('scan', (qrcode) => {
    console.log('扫码登录：' + qrcode)
    // 这里可以将二维码发送给用户
  })
  .on('message', async (msg) => {
    if (msg.self()) return // 忽略自己发的消息

    const text = msg.text()
    // 调用 OpenClaw API 处理
    const reply = await fetch('http://localhost:8080/api/chat', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ message: text })
    }).then(r => r.json()).then(d => d.reply)

    await msg.say(reply)
  })

bot.start()

3. 启动服务

node wechaty-bot.js

扫码后即可使用。

方案 C：使用 openclaw-wechat 插件（社区推荐）

这是社区开发者基于微信协议开发的 OpenClaw 插件，功能更完善。

  1. 安装插件：
openclaw plugins install @canghe/openclaw-wechat
  1. 配置 OpenClaw：
# 设置 API Key（在 OpenClaw 官网获取）
openclaw config set channels.wechat.apiKey "wc_live_xxxxxxxxxxxxxxxx"

# 设置代理服务地址（可选）
openclaw config set channels.wechat.proxyUrl "http://你的代理服务器:3000"

# 设置 webhook 公网地址（云服务器必填）
openclaw config set channels.wechat.webhookHost "你的服务器IP"

# 启用通道
openclaw config set channels.wechat.enabled true
  1. 完整配置示例 ~/.openclaw/openclaw.json：
{
  "channels": {
    "wechat": {
      "enabled": true,
      "apiKey": "wc_live_xxxxxxxxxxxxxxxx",
      "proxyUrl": "http://你的代理:3000",
      "webhookHost": "1.2.3.4",
      "webhookPort": 18790,
      "webhookPath": "/webhook/wechat",
      "deviceType": "ipad"  // 可选: "ipad" 或 "mac"
    }
  }
}
  1. 首次启动会显示二维码，扫码登录即可。

🔧 完整配置参数速查

企业微信（wechat-work）

参数 必填 说明 示例
corpId ✅ 企业 ID ww1234567890abcdef
agentId ✅ 应用 ID 1000001
secret ✅ 应用密钥 mZi7Gxxxxxxxxxxx
token ✅ 验证令牌 自定义字符串
encodingAESKey ✅ AES 加解密密钥 随机生成 43 位

微信服务号（wechat-mp）

参数 必填 说明
appId ✅ 公众号 AppID
appSecret ✅ 公众号 AppSecret
token ✅ 验证令牌
encodingAESKey ✅ AES 加解密密钥

个人微信（wechat - 插件）

参数 必填 说明
apiKey ✅ 微信 API Key（官网申请）
proxyUrl ✅ 代理服务地址
webhookHost ✅ 服务器公网 IP 或域名
webhookPort ❌ 默认 18790
webhookPath ❌ 默认 /webhook/wechat
deviceType ❌ "ipad" 或 "mac"，默认 ipad

❓ 常见问题排查

Q1: 机器人收不到消息

排查步骤：

  1. 检查 webhookHost 是否配置为公网 IP（内网 IP 无法访问）
  2. 确认端口可从外网访问：
    curl http://your-server-ip:port/webhook
  3. 检查网关状态：openclaw gateway status
  4. 查看日志：openclaw logs -f

Q2: 消息发送失败

  • 确认应用凭证（corpId、agentId、secret）是否正确
  • 检查服务器 URL 是否可公网访问
  • 查看 OpenClaw 日志错误信息
  • 确认企业微信用户是否在应用可见范围内

Q3: 登录失败（个人微信）

  • 等待 24 小时后重试（微信限制）
  • 换一个微信号测试（设备封禁影响小号）
  • 检查 API Key 是否有效

Q4: 企业微信 vs 个人微信的区别

  • 企业微信：官方支持，API 稳定，无封号风险，适合企业
  • 个人微信：基于协议桥接，稳定性依赖第三方，存在封号风险，适合个人测试

Q5: 支持图片和文件吗？

支持。用户发送图片或文件时，OpenClaw 会自动下载并处理：

  • 图片：使用多模态模型识别内容
  • 文件：读取文本内容（PDF、Word、Excel 等）

Q6: 支持语音消息吗？

支持。OpenClaw 会自动将语音转为文字再处理（使用微信内置语音识别或 FunASR）。

Q7: 消息频率限制

  • 企业微信：最多 200 条/分钟
  • 服务号：主动消息需用户 48 小时内互动
  • 个人号：无官方限制，但需避免频繁发送防封号

📚 相关资源

🎯 总结

OpenClaw 微信接入已非常成熟，推荐所有用户优先使用官方 ClawBot 插件，扫码即用零配置。企业用户选择企业微信方案，对外服务选择服务号，个人测试可尝试插件方案（注意风险）。

配置完成后，你的 OpenClaw 将 7×24 小时在线，自动处理消息、执行任务，成为你工作生活的好帮手。

有任何问题欢迎在 GitHub Issues 或社区交流群反馈。

site logo

Moment

© 2026 Moment