前置条件

平台注册

注意事项

进行开发之前，请先准备平台账户。

注册教程

使用机器人需要拿到开放平台的账号与密钥，以便与消息平台进行通信进而收发消息。

以下是一些常用的机器人开放平台的使用说明或教程，请根据自己的需求选择。

机器人名称	链接
QQ/QQ-Guild官方机器人	官方文档
微信机器人	官方文档
Telegram Bot	官方文档，其他教程
Discord Bot	官方文档
kook Bot	官方文档

环境准备

MacOS
Ubuntu/Debian
Centos
Windows

系统版本至少为 MacOS12

非最新的系统不保证其成功性

校验git版本，未安装会提示下载常用工具包

git --version

Brew 官网

下载Brew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

添加环境变量

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.bash_profile

添加环境变量

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc

重载环境变量

source ~/.bash_profile && source ~/.zshrc

使用nvm对Node.js进行安装和版本管理，方便切换版本进行开发

安装nvm

brew install nvm

为bash添加环境
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bash_profile
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.bash_profile
echo '[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.bash_profile

为zshrc添加环境
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
# This loads nvm
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc
# This loads nvm bash_completion
echo '[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.zshrc

刷新环境

source ~/.bash_profile && source ~/.zshrc

安装NodeJS@18.20.3
nvm install 18.20.3
nvm use 18.20.3
node -v
npm -v

示例系统 Ubuntu 24.04 LTS / Debian 12.0 X86 2H2G

sudo apt update
sudo apt install wget -y
sudo apt install curl -y

安装nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

添加NVM到环境变量
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
source ~/.bashrc
nvm -v

安装NodeJS@18.20.3
nvm install 18.20.3
nvm use 18.20.3
node -v
npm -v

安装git

apt install git

安装chromium

sudo apt install chromium-browser

示例系统 Centos 8.2 X86 2H2G

确保yum包是最新的
sudo yum update -y
sudo yum install wget -y
sudo yum install curl -y

安装NVM

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

添加NVM到环境变量
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
source ~/.bashrc # 刷新环境
nvm -v # 版本

Centos8以下无法使用官方源的Node V18

请改用 16.14.0

安装NodeJS@18.20.3
nvm install 18.20.3
nvm use 18.20.3
node -v
npm -v

安装git

yum install git

安装 Chromium

yum  install chromium -y

推荐系统 Windows10 | Windows11

安装浏览器：非推荐系统请自行安装 Google Chrome / Edge
安装 Node.js： Node.js@18.20.3

推荐使用nvm-setup.exe对Node.js进行版本管理，方便切换版本进行开发

Node.js 版本必须大于16.14.0且双数版本

安装 Git： Git Download for Windows

git必须全部点击默认next，其他地址可能会造成git损坏

出现意外？阅读常见问题

平台注册​

环境准备​

平台注册

环境准备