搭建开源的 Telegram 人形自走机器人 PagerMaid

Pagermaid 简介

PagerMaid 是一个开源的 Telegram 人形自走 Bot 方案，基于 Python 开发，功能强大而丰富，它通过响应账号通过其他客户端发出的命令来自动执行一系列任务，可以帮助你打造专属的便利功能。

Pagermaid-Pyro 和 Pagermaid-Modify 双版本

注：Pagermaid-Pyro 由于命令与旧版 Pagermaid-Modify 不同，故可以同时安装两个版本。

按照本教程的步骤会将 Pagermaid-Pyro 安装至 /var/lib/pagermaid-pyro 目录下。

这样可以实现双版本同时运行，同时也可以在不同目录同时搭建以实现一机多账号，例如：/var/lib/pagermaid-pyro1, /var/lib/pagermaid-pyro2, …

Pagermaid-Modify 脚本安装

搭建 Pagermaid-Modify 可以使用下面的一键脚本，这里不展开讲。

1

wget https://gitlab.com/Xtao-Labs/pagermaid-modify/-/raw/master/install.sh -O install.sh && chmod +x install.sh && bash install.sh

使用该脚本会将 Pagermaid-Modify 安装至 /var/lib/pagermaid 目录下。

本文以 Pagermaid-Pyro 为主，Pagermaid-Modify 安装方法不在本文考虑范围内。都一键脚本了还要啥教程(

Pagermaid-Pyro 脚本安装

一键脚本：

1

wget https://raw.githubusercontent.com/TeamPGM/PagerMaid-Pyro/development/utils/install.sh -O install.sh && chmod +x install.sh && bash install.sh

使用该脚本会将 Pagermaid-Pyro 安装至 /var/lib/pagermaid 目录下。

Docker 版一键脚本：

1

wget https://raw.githubusercontent.com/TeamPGM/PagerMaid-Pyro/development/utils/docker.sh -O docker.sh && chmod +x docker.sh && bash docker.sh

Docker 版手动部署可以看这篇文章：人形自走 BOT PagerMaid 在 ARM 平台的搭建

使用 Docker 版同样可以实现一机多账号，新建多个容器即可，这里不展开讲。

环境要求

Ubuntu>=16.04 / Debian>=9 (AMD64/ARM64)（已在该环境下通过测试，系统低于此版本不代表无法安装）

Python>=3.8 （查询 Python 版本： Python3 -V）

如版本低于 3.8 请自行搜索教程更新 Python 版本。

搭建

开放端口

由于需要与 Telegram 服务器通信，首先开放服务器端口。

1
2
3
4

sudo iptables -P INPUT ACCEPT
sudo iptables -P FORWARD ACCEPT
sudo iptables -P OUTPUT ACCEPT
sudo iptables -F

如果使用了云服务，请去控制台再次开放端口。 (这里使用的是 Microsoft Azure ，其他 IDC 请自行解决)

拉取项目

在拉取项目之前，首先更新 git ，避免之后因版本过低出现无法更新的情况。

1

sudo apt install --upgrade git -y

拉取项目至 /var/lib/pagermaid-pyro 目录。

1
2

sudo -i
cd /var/lib && git clone https://github.com/TeamPGM/PagerMaid-Pyro.git pagermaid-pyro && cd pagermaid-pyro

出现以下提示即可进入下一步。

安装软件包

首先更新 apt 包：

1
2

sudo apt update && sudo apt upgrade -y
sudo apt install python3-pip python3-venv imagemagick libwebp-dev neofetch libzbar-dev libxml2-dev libxslt-dev tesseract-ocr tesseract-ocr-all -y

安装软件包过程中，请等待一段时间，安装完成后，继续进行以下操作。

首先启用虚拟环境：

1
2

python3 -m venv venv
source venv/bin/activate

可以看到命令行前面多了一个 (venv) ，即表示启用成功。

更新一下 pip：

1

python3 -m pip install --upgrade pip

接下来安装 Python 依赖包：

1

pip3 install -r requirements.txt

请确保以上命令输入时均处于虚拟环境中，即有 (venv) 标志。

若退出了虚拟环境，可以使用以下命令重新进入虚拟环境：

1

source venv/bin/activate

如果出现 ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt' 报错，请先检查当前目录是否为 /var/lib/pagermaid-pyro ，如果位于该目录仍然报错，请重新执行 拉取项目 步骤。

出现以下提示代表安装成功。

修改配置文件

执行以下命令，将配置文件 config.gen.yml 复制一份并且命名为 config.yml

1

cp config.gen.yml config.yml

修改 config.yml

1

vim config.yml

不会使用 vim 的请自行查找教程，这里不提供。

1. API配置 (可选)

   在最新版本的 Pagermaid-Pyro 中添加了默认的 api_id 和 api_hash ，故下方生成 API Key与填写相关配置项为可选操作，但仍然建议自行生成 API。

   

   配置文件中 api_id 和 api_hash 缺省则默认使用下方的 API Key。

   1 2	api_id = 21724 api_hash = "3e0cb5efcd52300aec5994fdfc5bdc16"

   在 Telegram 官网 ，登录后点击 API development tools ，按提示填写信息，生成 API Key。

   

   申请 API 与搭建 UserBot 属于高危操作，特别是新注册的 Telegram 账号和使用 VoIP 语音号码注册的账号会加大封号概率，如被封号，请尽快向客服申诉申请解封。同时请勿将 API 泄露给他人。

   生成后，只需要复制 api_id 和 api_hash 值并分别填入，编辑时请注意不要删掉引号。

   当然也可以使用部分程序的 API Key (不建议，公开的 API Key 可能会受到限制，导致无法登录，此时仍需自行申请 API 。)

   公开的API

   Telegram Android

   1 2	api_id = "4" api_hash = "014b35b6184100b085b0d0572f9b5103"

   Telegram Desktop

   1 2	api_id = "2040" api_hash = "b18441a1ff607e10a989891a5462e627"

   Telegram Messenger CLI

   1 2	api_id = "2899" api_hash = "36722c72256a24c1225de00eb6a1ca74"

   Telegram Swift

   1 2	api_id = "10840" api_hash = "33c45224029d59cb3ad0c16134215aeb"

   Telegram Messenger Plus

   1 2	api_id = "16623" api_hash = "8c9dbfe58437d1739540f5d53c72ae4b"

   Telegram X

   1 2	api_id = "21724" api_hash = "3e0cb5efcd52300aec5994fdfc5bdc16"

   Telegram Web K

   1 2	api_id = "1025907" api_hash = "452b0359b988148995f22ff0f4229750"

   

   按以上图片中格式填写即可。

2. 日志及报错信息记录 (可选) ：

   

   1 2	log: "False" # False 代表禁用，True 代表启用 log_chatid: "503691334" # 这里填写记录用的群组或频道ID

3. 代理 (可选) ：

   

   代理配置按需填写即可。

   1 2 3 4 5 6 7

   proxy_addr: "" # socks5 代理地址 proxy_port: "" # socks5 代理端口 http_addr: "" # http 代理地址 http_port: "" # http 代理端口 mtp_addr: "" # mtp 代理地址 mtp_port: "" # mtp 代理端口 mtp_secret: "" # mtp 代理密钥

4. 二维码登录与网页登录 (可选) ：

   1 2	qrcode_login: "False" # False 代表禁用，True 代表启用 web_login: "False"

5. 网页版控制台 (可选) ：

   1 2 3 4 5 6

   web_interface: enable: "False" # False 代表禁用，True 代表启用 secret_key: "RANDOM_STRING_HERE" # 任意值，作为密码 host: "127.0.0.1" port: "3333" origins: ["*"]

6. Speedtest CLI 路径 (可选) ：

   1	speed_test_path: ""

config.yml 中其他字段暂不做说明，参考对应注释即可。

登录账号

请确保仍在虚拟环境中，即有 (venv) 标志，然后运行以下命令：

1

python3 -m pagermaid

此步需要填入完整的电话号码 (eg：+18888888888，需要带上国际区号) 然后 Telegram 会向你的其他客户端发送验证码，少数用户会向手机号发送验证码，填入验证码后，回车，如有两步验证密码，则再输入两步验证密码即可。

1
2
3
4
5
6
7
8

Enter phone number or bot token:    #此处填入手机号
Is "+18888888888" correct? (y/N):    # 号码显示正确输入 y ,错误输入 n
The confirmation code has been sent via Telegram app
Enter confirmation code:    # 此处输入 Telegram APP 中收到的验证码

The two-step verification is enabled and a password is required   # 如果设置了两步验证，则会出现以下提示
Password hint: None
Enter password (empty to recover):    # 此处输入两步验证密码

出现已启动提示，代表登录成功，此时可以去 Telegram 任意聊天发送 ,help 进行测试。

如果在配置文件中启用了二维码登录，即配置了 qrcode_login: "True" ，可以进入手机版 菜单栏-Settings-Devices ，点击 Link Desktop Device ，扫描终端中显示的二维码即可登录。

受部分终端显示限制，二维码可能无法正常显示，可以下载运行目录下的 qrcode.png 文件扫码登录，或复制二维码下方以 tg://login?token= 开头的链接至任意聊天，点击后根据提示登录。

进程守护及后台运行

首先按下 Ctrl 键和 C 键停止运行

然后输入以下命令：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

cat <<'TEXT' > /etc/systemd/system/pagermaid-pyro.service
[Unit]
Description=PagerMaid-Pyro telegram utility daemon
After=network.target

[Install]
WantedBy=multi-user.target

[Service]
Type=simple
WorkingDirectory=/var/lib/pagermaid-pyro
ExecStart=/var/lib/pagermaid-pyro/venv/bin/python3 -m pagermaid
Restart=always
TEXT

设置完成后启动程序：

1

systemctl start pagermaid-pyro

设置为开机自启：

1

systemctl enable pagermaid-pyro

如果遇到问题，请使用下方命令查看输出以排除问题：

1

systemctl status pagermaid-pyro

如需停止程序，使用以下命令即可：

1

systemctl stop pagermaid-pyro

插件安装

安装后只能使用自带功能，但 Pagermaid 支持通过插件扩充功能。

如上图，插件名即为文件夹名称，在任意聊天中发送 ,apt install <插件名> 即可安装。

如需安装第三方/自制插件，发送插件 Python 文件至任意聊天，然后回复该文件并发送 ,apt install 即可安装。

常见问题

插件相关

1. 如安装插件时提示错误但无任何错误日志，可能是网络问题，请按以下步骤解决：

   1.将 config.yml 中 git_source 修改为以下内容：

   1	git_source: "https://gitlab.com/Xtao-Labs/PagerMaid_Plugins_Pyro/-/raw/v2/"

   2.修改后使用 ,restart 命令或在终端中输入 systemctl restart pagermaid-pyro 使程序重启。

2. 如安装插件后遇到插件加载失败的情况 (如图所示) ，请按照以下步骤排除解决：

   

   1.如您是直接在聊天中回复了一个插件文件并安装，可能安装的是旧版插件，新旧插件无法兼容。

   2.重新安装插件。

   3.使用 ,restart 命令或在终端中输入 systemctl restart pagermaid-pyro 使程序重启。

   4.在终端中使用 systemctl status pagermaid-pyro 通过查看日志来排除故障。

   5.检查 Python 版本是否为 Python 3.8 或更高版本。

   6.在任意对话中发送 ,sh rm -rf ./plugins/* 删除全部插件，然后重新安装插件。

   7.重新搭建 PagerMaid-Pyro 。

使用相关

1. 使用过程中进行了插件安装/升级等需要重启的操作后停止运行：

   请重新执行上文 进程守护及后台运行 操作。

2. 运行一段时间后莫名其妙掉线 / 出现 timeout 错误：

   请使用 cron 等工具配置定时重启任务，如每4小时重启一次

   1 2	sudo crontab -e 0 */4 * * * systemctl restart pagermaid-pyro