2026年AstrBot 微信接入全面指南

科技前沿 • 2026-04-13 23:15 • 阅读 0

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

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

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

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

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

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

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

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

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

具体步骤：

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

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

安装 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

首先，从 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..com”

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

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

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

{ “token”: “ 
    
    
      <你的wxclaw_token>
        ”, “baseUrl”: “ 
       https://ilinkai.weixin..com”, “userId”: “ 
       <你的微信用户id>
         @im.wechat” }

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

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

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

测试：创建定时任务

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

“5分钟后提醒我喝水”

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

2026年AstrBot 微信接入全面指南

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

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

相关推荐