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 可以使用下面的一键脚本，这里不展开讲。

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

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

Pagermaid-Pyro 脚本安装

一键脚本：

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

Docker 版一键脚本：

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

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

环境要求

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

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

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

搭建

开放端口

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

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

拉取项目

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

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

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

安装软件包

1. 首先更新 apt 包：

软件包说明

• python3-pip 必须 用于安装 Python 依赖。
• python3-venv 必须 用于生成 Python 虚拟环境。
• imagemagick 非必须 用于处理图片。
• libwebp-dev 非必须 用于处理图片。
• neofetch 非必须 用于显示系统信息， sysinfo 命令需要用到。
• libxslt-dev 非必须 用于处理二维码信息。
• libxml2-dev 非必须 用于解析 XML 文件。
• libxslt-dev 非必须 用于解析 XML 文件。
• tesseract 非必须 图片光学字符识别。

以上软件包建议全部安装，不安装会影响部分功能的使用。

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

2. 启用虚拟环境：

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

3. 更新一下 pip：

4. 接下来安装 Python 依赖包：

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

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

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

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

修改配置文件

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

修改 config.yml

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

1. API配置 (可选)

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

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

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

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

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

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

3. 代理 (可选) ：

代理配置按需填写即可。

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

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

6. Speedtest CLI 路径 (可选) ：

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

登录账号

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

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

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

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

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

进程守护及后台运行

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

然后输入以下命令：

设置完成后启动程序：

设置为开机自启：

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

至此 Pagermaid-Pyro 搭建完成，enjoy ~

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

插件安装

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

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

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

常见问题

插件相关

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

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

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小时重启一次