diff --git a/deploy/platform/gewechat.md b/deploy/platform/gewechat.md new file mode 100644 index 0000000..09c7bc1 --- /dev/null +++ b/deploy/platform/gewechat.md @@ -0,0 +1,47 @@ + + +# 通过 Gewechat 接入微信 + + +> [!WARNING] +> 1. 仅支持微信个人号 +> 2. 微信限制,需要手动扫码登录 +> 3. 微信限制一个微信号必须**有一台手机在线**才能登录其他端。而 Gewechat 是一个 IPAD 微信客户端。因此,你需要有一台手机登录该微信,才能使用 Gewechat。 + +## 部署 Gewechat + +Gewechat 需要使用 Docker 部署。请参考 [启动 Gewechat](https://github.com/Devo919/Gewechat?tab=readme-ov-file#%E5%90%AF%E5%8A%A8%E6%9C%8D%E5%8A%A1) 部署 Gewechat。 + +## 在 AstrBot 中配置 Gewechat 适配器 + +在 AstrBot 的管理面板中,选择左边栏的 `配置`,然后在右边的界面中,点击 `消息平台` 选项卡。点击 `+` 号,选择 `vchat`,会出现 `vchat` 的相关配置项,如下图所示: + +![](../../source/images/gewechat/image.png) + +- `nickname` 请随便填一个具有辨识度的英文名。 +- `base_url` 是连接到 Gewechat 后端的 API 地址。如果你将 Gewechat 部署到了其他服务器或设备,请自行修改 `localhost` 为服务器地址。 +- `host` 为回调地址主机,即 gewechat 下发事件到 AstrBot 的地址。 +- `port` 为回调地址端口,可不修改。 + +勾选 `启用`,然后点击 `保存`。 + +## 扫码登录 + +接下来需要查看日志。请在管理面板的控制台查看或者切终端查看。 + +查看 AstrBot 的终端日志输出,会出现相关引导提示。打开提示的二维码链接扫码登录即可。 + + +## 设置白名单 + +由于微信的 ID 是一段非常长的随机字符串,因此没办法通过默认设置 AstrBot 管理员的方式来设置初始会话。操作步骤如下: + +1. 给机器人号随便发一条消息,在终端中会出现 `会话 xxx 不在会话白名单中,已终止事件传播。` 的日志(日志等级为 `INFO`)。 +2. 复制 `xxx` 的值。 +3. 在管理面板 `配置->消息平台->消息平台通用配置` 中找到 `ID 白名单`,粘贴 `xxx` 的值,回车填入。 +4. 点击 `保存`,等待 AstrBot 重启。 +5. 尝试发送 `/help` 命令,看是否有响应。 + +## 注意事项 + +一旦登录成功,请牢记在配置时配置的 username,如果更换,则相当于使用新设备登录。频繁新设备登录容易触发风控。 \ No newline at end of file diff --git a/deploy/platform/vchat.md b/deploy/platform/vchat.md index 2c5b3f7..08e6655 100644 --- a/deploy/platform/vchat.md +++ b/deploy/platform/vchat.md @@ -2,6 +2,12 @@ # 通过 VChat 接入微信 +> [!WARNING] +> 由于各种原因不再推荐通过 VChat 接入。请使用 [Gewechat](/deploy/platform/gewechat)。 +> 由于各种原因不再推荐通过 VChat 接入。请使用 [Gewechat](/deploy/platform/gewechat)。 +> 由于各种原因不再推荐通过 VChat 接入。请使用 [Gewechat](/deploy/platform/gewechat)。 + + > [!WARNING] > 1. 仅支持微信个人号 > 2. 微信限制,需要手动扫码登录 diff --git a/source/images/gewechat/image.png b/source/images/gewechat/image.png new file mode 100644 index 0000000..5517943 Binary files /dev/null and b/source/images/gewechat/image.png differ