oicq 快速入门:从零搭建你的第一个 QQ 机器人
想要快速搭建一个功能强大的 QQ 机器人吗?oicq 是一个基于 Node.js 的腾讯 QQ 机器人开发库,让你能够轻松实现自动化消息处理、群管理、好友互动等功能。本指南将带你从零开始,完成你的第一个 QQ 机器人的配置和部署。
前置准备与环境搭建
在开始之前,你需要确保系统已安装 Node.js v14 或更高版本。这是运行 oicq 的基本要求。可以通过 node -v 命令检查当前版本。
项目初始化
创建项目目录并初始化依赖管理:
mkdir my-qq-bot
cd my-qq-bot
npm init -y
接下来安装 oicq 包:
npm install oicq
或者使用 yarn:
yarn add oicq
查看 package.json 文件,确认 oicq 已正确添加到依赖项中。oicq 当前版本支持最新的 QQ 协议实现。
创建你的第一个 QQ 机器人
基础配置方法
创建一个名为 bot.js 的文件,添加以下代码。这段代码实现了扫码登录以及收到消息后的自动回复逻辑。
const { createClient } = require("oicq")
// 替换为你的 QQ 号
const account = 147258369
const client = createClient(account)
// 登录成功事件
client.on("system.online", () => {
console.log("机器人登录成功!")
})
// 消息处理事件
client.on("message", e => {
console.log("收到消息:", e)
// true 表示引用对方消息
e.reply("你好,我是 QQ 机器人!", true)
})
// 扫码登录处理
client.on("system.login.qrcode", () {
.()
process..(, {
.()
})
})
client.()

