AstrBot 微信接入全面指南

一、背景介绍

2025 年，微信终于正式开放了个人 Bot API。腾讯通过 OpenClaw 框架对外开放了微信个人账号的 Bot API，官方产品名为「微信 ClawBot 插件功能」，底层协议称为 iLink（智联），接入域名是 ilinkai.weixin.qq.com——这是腾讯的官方服务器，有《微信 ClawBot 功能使用条款》法律文件背书，是一个里程碑式的变化。

我选择微信作为 AI 助手的接入渠道，一方面是因为微信是日常使用最频繁的应用，触达最方便；另一方面是微信 ClawBot 的产品体验做得不错：支持干净的 Markdown 渲染，有「正在输入中...」的状态显示，用起来很流畅。

当然，目前微信 ClawBot 也存在一些局限：不能主动发起对话，导致定时提醒等功能无法正常使用。

针对这些问题，我使用 AstrBot 框架进行接入和扩展。本文将基于 AstrBot 的接入经验，分享微信客户端的配置与主动消息发送的实现方法。

---

二、客户端配置

手机端配置

1. 版本检查：确保微信已升级到最新版本（iOS ≥ 8.0.70，Android ≥ 8.0.69），这是安装插件的前提
2. 扫码接入：在 AstrBot WebUI 的机器人配置页面创建「个人微信」类型的机器人，保存配置后点击「查看二维码」，用手机微信扫码并在微信内确认登录
3. 启动插件：扫码成功后，微信会自动弹出 ClawBot 插件启动提示，点击确认即可

登录成功后，只要登录态有效，通常不需要再次扫码。

PC 端配置

PC 端微信同样支持 ClawBot 插件，版本要求为 4.1.8.67 及以上。

重要：必须手动从微信官网下载最新版本进行更新，系统自动检查更新的版本往往不够新，无法正常使用插件。

具体步骤：

1. 前往微信官网下载 PC 端最新版本（≥ 4.1.8.67）并安装
2. 打开 PC 端微信，进入「设置 → 插件」，找到「微信 ClawBot」并点击下载安装
3. 在手机端启动插件后，PC 端插件会自动出现，并与手机端自动同步

---

三、主动消息发送

微信 ClawBot 存在一个痛点：无法主动发送消息，这导致定时提醒、告警通知等功能无法正常使用。通过 wxclawbot-cli 工具可以解决这一问题。

1 环境准备

安装 Node.js 和 npm

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs# 验证
node -v
npm -v

安装 wxclawbot-cli

npm install -g @claw-lab/wxclawbot-cli

下载 Skill 配置

从 GitHub 下载 SKILL.md：https://github.com/lroolle/wxclawbot-cli

2 配置凭证

首先，从 AstrBot 的配置中提取 iLink 凭证。在 data/cmd_config.json 中找到 type: "weixin_oc" 的配置，提取：

• weixin_oc_token → WXCLAW_TOKEN
• weixin_oc_base_url → WXCLAW_BASE_URL
• weixin_oc_account_id → botId

方式一：环境变量（临时）

export WXCLAW_TOKEN="<你的WXCLAW_TOKEN>"
export WXCLAW_BASE_URL="https://ilinkai.weixin.qq.com"

方式二：配置文件（推荐，持久化）

mkdir -p ~/.openclaw/openclaw-weixin/accounts

创建 ~/.openclaw/openclaw-weixin/accounts/<你的botId>.json：

{"token": "<你的WXCLAW_TOKEN>","baseUrl": "https://ilinkai.weixin.qq.com","userId": "<你的微信用户ID>@im.wechat"
}

如何获取微信用户 ID？ 在 AstrBot 的 log 中，消息收发时会显示带有 @im.wechat 后缀的字符串，即为你的微信用户 ID。

3 验证测试

# 检查账号
wxclawbot accounts --json# 测试发送
wxclawbot send --text "测试消息" --json

4 集成 AstrBot

1. 进入 AstrBot WebUI → 插件 → Skills
2. 上传包含 SKILL.md 的 Skill 压缩包
3. 配置完成后，AstrBot 会自动调用 wxclawbot-cli 发送消息

测试：创建定时任务

例如，让 AstrBot 创建一个 5 分钟后的定时提醒：

"5分钟后提醒我喝水"

AstrBot 会自动通过 wxclawbot-cli 发送微信消息到你的账号，验证集成是否成功。