qqbot

环境要求

• Python 2.7 或 3.4+
• 可用的 pip 包管理工具
• 支持 Linux / Windows / Mac OSX
• Linux 下需系统含 gvfs-open 或 shotwell 才能自动弹出二维码
• Windows10 下需已设置 png 图片的默认打开程序

安装与启动步骤

1. 1安装 qqbot

   用 pip 直接安装。若已下载源码包，解压后进入目录执行 pip install . 效果相同。

   pip install qqbot

   复制

2. 2（可选）源码安装

   下载源码压缩包解压后，进入源码目录再执行本地安装，适合需要改动源码的情况。

   cd qqbot-master
   pip install .

   复制

3. 3启动 QQBot

   在命令行直接输入 qqbot 即可启动，启动过程中会自动弹出二维码图片。

   qqbot

   复制

4. 4扫码授权登录

   用手机 QQ 客户端扫描弹出的二维码并授权登录，成功后登录信息会保存到本地文件。

5. 5恢复登录免扫码

   下次启动可带上 QQ 号尝试从本地文件恢复登录信息，恢复失败或过期时才需要重新扫码。

   qqbot -q 3497303033

   复制

6. 6按用户配置启动

   配置文件中的每个 item 代表一个用户，用 -u 指定后加载该用户下的各项配置。

   qqbot -u somebody

   复制

7. 7用 qq 命令操作

   另开一个控制台窗口，用 qq 命令操作 QQBot，可先执行 qq help 查看全部命令。

   qq help

   复制

8. 8查看全部命令行参数

   配置文件的每个选项都有对应命令行参数，且命令行优先级更高，可用 -h 查看格式。

   qqbot -h

   复制

关键配置

如何确认成功

扫码授权后 QQBot 正常启动，并在另一控制台执行 qq help 能得到响应，说明启动成功。

常见问题

注意事项

• 重要：SmartQQ 已于 2019 年 1 月 3 日停止服务，本项目无法使用，不要再用于生产环境。
• Linux 下需存在 gvfs-open 或 shotwell 命令，Windows10 下需设置 png 默认打开程序，才能自动弹出二维码。
• 配置文件位于 ~/.qqbot-tmp/v2.x.conf，首次运行后自动创建；其中根配置固定不可修改。
• 插件需放在系统 import 目录或 ~/.qqbot-tmp/plugins 目录下，也可通过 pluginPath 指定其他目录。