小由和小迪
加入会员

访问受限

正在验证访问权限

激活授权码返回工具页

基本介绍 ​

能力说明 ​

本方案默认对接扣子智能体，支持以下能力：

  • 支持私聊自动回复
  • 支持群聊自动回复，但需要在群内 @ 机器人
  • 支持多轮对话
  • 只处理文字消息

会话说明

多轮对话默认可连续保持 7 天；如果脚本重启，当前对话上下文会被清空，需要重新开始。

配置步骤 ​

第 1 步：下载并启动千寻微信框架 Pro ​

下载地址：千寻微信框架 Pro 下载

只需要下载名为 千寻微信框架Pro x.x.x.x.zip 的压缩包即可。

下载完成后按下面步骤操作：

  1. 解压压缩包。
  2. 将解压后的文件夹放到一个固定位置，不要后续频繁移动。
  3. 找到 千寻微信框架Pro.exe。
  4. 右键选择“管理员身份运行”。

第 2 步：安装微信 PC 客户端 ​

下载地址：WeChatSetup_x86_3.9.12.56.zipZIP下载

安装要求：

  1. 下载后正常安装微信 PC 客户端。
  2. 安装完成后先不要登录微信。
  3. 直接关闭微信程序，后续由框架拉起。

第 3 步：配置千寻微信框架 ​

打开千寻微信框架 Pro 后，进入“框架设置”页面，完成以下配置：

  1. 设置“微信安装目录”。
  2. 设置“数据缓存目录”。
  3. 如果不确定路径，可以直接点击后面的“点我自动获取”。
  4. 点击“保存修改”。

第 4 步：添加微信并登录 ​

进入“微信管理”页面后，按以下顺序操作：

  1. 右键点击“添加微信”。
  2. 选择“随机端口”。
  3. 等待程序自动启动一个新的微信实例。
  4. 使用手机扫码登录。

登录完成后，你可以在框架里看到当前微信的 wxid。

第 5 步：为当前微信购买授权 ​

拿到 wxid 后，需要为这个微信实例购买授权。

操作方式：

  1. 返回软件首页。
  2. 点击“购买、续费授权”。
  3. 按页面指引完成授权购买。

第 6 步：下载并放置桥接脚本 ​

脚本下载地址：千寻框架监听脚本.zipZIP下载

处理步骤：

  1. 下载并解压脚本压缩包。
  2. 找到其中的 bridge 文件夹。
  3. 将整个 bridge 文件夹复制到千寻微信框架 Pro 的安装目录下。

第 7 步：安装 Python 和 uv ​

安装 Python ​

下载地址：python-3.10.11-amd64.zipZIP下载

安装 uv ​

在 PowerShell 中执行：

powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

如果网络原因无法访问，可以改用下面任一方式。

方式一：手动下载安装脚本 ​

  1. 用浏览器打开 https://astral.sh/uv/install.ps1，下载 install.ps1 文件
  2. 在 PowerShell 中执行：
powershell
powershell -ExecutionPolicy Bypass -File install.ps1

方式二：使用 pip 安装 ​

powershell
pip install uv

安装完成后，请重新打开一个 PowerShell 窗口，执行下面命令确认是否安装成功：

powershell
uv --version

第 8 步：初始化 bridge 运行环境 ​

进入 bridge 文件夹后，依次执行：

powershell
uv venv
uv sync

第 9 步：配置扣子智能体参数 ​

打开 bridge/config.py，按提示修改配置项。

填写以下内容：

  • 扣子智能体 ID
  • 扣子令牌
  • 是否回复群里 @所有人 的消息

默认行为

默认情况下，脚本不会回复群里的 @所有人 消息。

第 10 步：启动机器人脚本 ​

在 bridge 目录下执行以下命令，即可后台启动脚本：

powershell
$p = Start-Process -FilePath ".\.venv\Scripts\python.exe" -ArgumentList "-m","uvicorn","app:app","--host","0.0.0.0","--port","989" -WorkingDirectory (Get-Location) -WindowStyle Hidden -PassThru
$p.Id | Set-Content ".bridge.pid"

执行完成后可以直接关闭当前终端窗口，脚本会继续在后台运行。

第 11 步：在千寻框架里配置 HTTP 回调 ​

回到千寻微信框架 Pro，进入“框架设置”页面，完成下面配置：

  1. 选择 HTTP API服务端
  2. 将 HTTP 事件回调地址设置为：
text
http://127.0.0.1:989/wechat/callback
  1. 勾选“启用HTTPAPI”
  2. 保存配置

第 12 步：验证是否配置成功 ​

完成上面所有配置后，你可以直接使用另一个微信号给当前机器人微信发送文字消息进行测试。

如果配置正确，机器人会自动回复。

群聊测试时，请注意：

  1. 需要在群里 @ 机器人
  2. 当前只支持文字消息自动回复

停止脚本 ​

如果后续需要停止机器人，在 bridge 目录下执行：

powershell
Stop-Process -Id (Get-Content ".bridge.pid") -Force
Remove-Item ".bridge.pid" -ErrorAction SilentlyContinue