mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-11-01 05:15:22 +08:00
93 lines
3.4 KiB
Markdown
93 lines
3.4 KiB
Markdown
# 通过 Gewechat 接入个人微信
|
||
|
||
**本教程要求 LangBot 以 Docker 容器部署**，请根据 LangBot 部署文档将 LangBot 部署到 Docker 中。
|
||
|
||
:::info
|
||
- 推荐使用 Ubuntu Linux 系统部署。
|
||
- 推荐使用[阿里云，服务器价格低至 38 元一年，更可以享受8折优惠](https://www.aliyun.com/minisite/goods?userCode=ys4ad8gs)，系统选择 Ubuntu 22.04 或 24.04。
|
||
:::
|
||
|
||
## 创建 Docker 网络
|
||
|
||
我们需要将 Gewechat 和 LangBot 部署到同一个 Docker 网络中，方便它们互相通信。
|
||
|
||
```bash
|
||
docker network create langbot-network
|
||
```
|
||
|
||
在 LangBot 目录的 `docker-compose.yaml` 文件中添加网络配置(添加到 `services.langbot` 字段下，并在 `networks` 字段下添加 `langbot-network` 网络配置)：
|
||
|
||
```yaml
|
||
services:
|
||
langbot:
|
||
...
|
||
networks:
|
||
- langbot-network
|
||
...
|
||
|
||
networks:
|
||
langbot-network:
|
||
external: true
|
||
```
|
||
|
||
在下一步部署 Gewechat 时，请在启动命令（docker run 命令）中的`-itd`后添加额外的网络配置`--network langbot-network`。
|
||
|
||
```bash
|
||
# 例如原命令为
|
||
docker run -itd -v /root/temp:/root/temp -p 2531:2531 -p 2532:2532 --privileged=true --name=gewe gewe /usr/sbin/init
|
||
|
||
# 添加网络配置后，命令变为
|
||
docker run -itd --network langbot-network -v /root/temp:/root/temp -p 2531:2531 -p 2532:2532 --privileged=true --name=gewe gewe /usr/sbin/init
|
||
```
|
||
|
||
## 部署 Gewechat
|
||
|
||
请查看 [Gewechat 文档](https://github.com/Devo919/Gewechat) 执行到 `启动服务` 步骤。
|
||
|
||
## 在 LangBot 中填写信息并启动
|
||
|
||
根据[填写配置信息](/deploy/quick-config/config)中的个人微信适配器配置，填写 LangBot 相关配置信息。
|
||
|
||
```json
|
||
{
|
||
"adapter": "gewechat",
|
||
"enable": true,
|
||
"gewechat_url": "http://gewe:2531",
|
||
"port": 2286,
|
||
"callback_url": "http://langbot:2286/gewechat/callback",
|
||
"app_id": "",
|
||
"token": ""
|
||
}
|
||
```
|
||
|
||
- `enable` 是否启用个人微信适配器，请修改为 `true`
|
||
- `gewechat_url` 上一步部署的 Gewechat 容器地址，端口默认为 2531，不需要填写路径
|
||
- `port` LangBot 监听 Gewechat 消息的端口，默认 2286，非必要勿修改
|
||
- `callback_url` 回调地址，是 Gewechat 容器推送消息给 LangBot 容器的地址，需要填写完整路径，例如 `http://langbot:2286/gewechat/callback`，端口与 `port` 一致，路径必须为 `/gewechat/callback`
|
||
- `app_id` 和 `token` **请勿填写**，这是用于存储登录信息的，在首次启动扫码登录后会自动保存
|
||
|
||
:::info
|
||
在这里我们将`gewechat_url`的主机名设置为`gewe`，即为上一步部署的 Gewechat 容器名称。
|
||
将`callback_url`的主机名设置为`langbot`，即为上一步部署的 LangBot 容器名称。
|
||
|
||
- 如果你按照本教程要求部署，使用上述默认的即可。
|
||
- 如果你使用了其他的容器名称，或者其他情况，请自行更改。
|
||
:::
|
||
|
||
## 启动 LangBot
|
||
|
||
按照部署 LangBot 文档中的启动命令启动 LangBot。
|
||
|
||
LangBot 启动后，会显示一个二维码，请使用个人微信扫描该二维码进行登录。
|
||
|
||
|
||
|
||
成功登录后，会显示登录信息，并开始监听个人微信消息。
|
||
|
||
|
||
|
||
:::info
|
||
登录后会将`app_id`和`token`保存到配置文件中，下次启动时不需要再次扫码登录。
|
||
:::
|
||
|
||
现在即可私聊或在群聊中与 LangBot 对话。 |