开始

欢迎来到 go-cqhttp 文档!

如果你在阅读完这篇向导之后还感到很迷惑, 那么我们建议你阅读: OneBot: 一个聊天机器人应用接口标准open in new window

基础教程

下载

releaseopen in new window 界面下载最新版本的 go-cqhttp

系统类型可执行文件压缩文件
Intel 版 MacosNot availablego-cqhttp_darwin_amd64.tar.gz
M1 版 MacosNot availablego-cqhttp_darwin_arm64.tar.gz
32 位 LinuxNot availablego-cqhttp_linux_386.tar.gz
64 位 LinuxNot availablego-cqhttp_linux_amd64.tar.gz
arm64 LinuxNot availablego-cqhttp_linux_arm64.tar.gz
armv7 LinuxNot availablego-cqhttp_linux_armv7.tar.gz
32 位 Windowsgo-cqhttp_windows_386.exego-cqhttp_windows_386.zip
64 位 Windowsgo-cqhttp_windows_amd64.exego-cqhttp_windows_amd64.zip
arm64 Windowsgo-cqhttp_windows_arm64.exego-cqhttp_windows_arm64.zip
armv7 Windowsgo-cqhttp_windows_armv7.exego-cqhttp_windows_armv7.zip
  • MD5信息在 go-cqhttp_checksums.txt , 可用于校验文件完整性
  • 如果没有你所使用的系统版本或者希望自己构建, 请移步 进阶指南-如何自己构建

解压

  • Windows下请使用自己熟悉的解压软件自行解压
  • Linux下在命令行中输入 tar -xzvf [文件名]

使用

Windows 标准方法

  1. 双击go-cqhttp_*.exe,根据提示生成运行脚本
  2. 双击运行脚本
[WARNING]: 尝试加载配置文件 config.yml 失败: 文件不存在
[INFO]: 默认配置文件已生成,请编辑 config.yml 后重启程序.
1
2
  1. 参照config.mdopen in new window和你所用到的插件的 README 填入参数
  2. 再次双击运行脚本
[INFO]: 登录成功 欢迎使用: balabala
1

如出现需要认证的信息, 请自行认证设备。

此时, 基础配置完成

Linux 标准方法

  1. 通过 SSH 连接到服务器
  2. cd到解压目录
  3. 输入 ./go-cqhttp, Enter运行 , 此时将提示
[WARNING]: 尝试加载配置文件 config.yml 失败: 文件不存在
[INFO]: 默认配置文件已生成,请编辑 config.yml 后重启程序.
1
2
  1. 参照 config.mdopen in new window 和你所用到的插件的 README 填入参数
  2. 再次输入 ./go-cqhttp, Enter运行
[INFO]: 登录成功 欢迎使用: balabala
1

如出现需要认证的信息, 请自行认证设备。

此时, 基础配置完成

注意

需要保持 go-cqhttp 在后台持续运行

请配合 screen 等服务来保证断开 SSH 连接后 go-cqhttp 的持续运行

跳过启动的五秒延时

使用命令行参数 faststart即可跳过启动的五秒钟延时,例如

# Windows
.\go-cqhttp.exe -faststart

# Linux
./go-cqhttp -faststart
1
2
3
4
5

进阶指南

如何自己构建

  1. 下载源码open in new window并解压 || 使用 git clone https://github.com/Mrs4s/go-cqhttp.git 来拉取

  2. 下载golang binary releaseopen in new window并安装或者自己构建golangopen in new window

  3. cmd 或Linux命令行中, cd 到目录中

  4. 输入 go build -ldflags "-s -w -extldflags '-static'", Enter 运行

注:可以使用 go env -w GOPROXY=https://goproxy.cn,direct 来加速国内依赖安装速度

更新

方法一

releaseopen in new window 界面下载最新版本的 go-cqhttp 并替换之前的版本

方法二

使用更新参数, 在命令行中打开 go-cqhttp 所在目录

windows

输入指令

go-cqhttp.exe update
1

如果在国内连接github下载速度可能很慢, 可以使用镜像源下载

go-cqhttp.exe update https://github.rc1844.workers.dev
1

几个可用的镜像源

  • https://hub.fastgit.org
  • https://github.com.cnpmjs.org
  • https://github.bajins.com
  • https://github.rc1844.workers.dev

linux

方法与windows基本一致, 将 go-cqhttp.exe 替换为 ./go-cqhttp 即可

./go-cqhttp update
1

安装 ffmpeg

为了支持任意格式的语音发送, 你需要安装 ffmpeg 。

Windows

这里open in new window 下载 并解压, 并为 bin 这个文件夹添加环境变量。

如果遇到下载速度缓慢的问题可以用 这个源open in new window

然后在 cmd 输入 (不能使用 powershell)

setx /M PATH "C:\Program Files\ffmpeg\bin;%PATH%"
1

自行将这个指令中的 C:\Program Files 替换成你的解压目录。

Linux

Ubuntu / Debian :

终端执行

apt install -y ffmpeg
1

Fedora / RHEL / CentOS :

根据 Rpmfusionopen in new window 的文档配置源

终端执行

# Centos7 及之前
yum install ffmpeg ffmpeg-devel 

# CentOS8 及之后
dnf install ffmpeg ffmpeg-devel
1
2
3
4
5