Description

n8n-nodes-onebot

n8n 社区节点：通过 OneBot v11 标准 API 与 QQ 机器人集成，实现自动化工作流与聊天机器人的交互。

📖 目录

• 安装
• 功能概览
• 功能分类表
• 凭证配置
• 项目结构
• 使用示例
• 兼容性
• 参考资源

🚀 安装

在 n8n 中安装

1. 打开 n8n
2. 前往 Community Nodes
3. 搜索并安装 n8n-nodes-onebot-api

📑 参考文档：n8n 社区节点安装指南

✨ 功能概览

机器人操作

• get_login_info：获取当前登录状态信息

好友操作

• get_friend_list：获取好友列表
• get_stranger_info：获取陌生人信息
• send_like：发送好友赞
• send_friend_poke：私聊戳一戳

群组操作

• get_group_list：获取群列表
• get_group_info：获取群详细信息
• get_group_member_list：获取群成员列表
• get_group_member_info：获取群成员信息
• set_group_kick：踢出群成员
• set_group_ban：禁言群成员
• set_group_whole_ban：全员禁言
• set_group_name：设置群名称
• set_group_admin：设置或取消管理员权限
• group_poke：群内戳一戳
• set_group_sign：设置群签到

成员关系操作

• set_group_leave：退出群聊
• delete_friend：删除好友
• batch_operation：批量退群和删除好友（支持白名单）
• random_delete_friends：随机删除好友（支持白名单）

消息操作

• send_private_msg：发送私聊消息
• send_group_msg：发送群消息

功能亮点：

• ✅ 支持发送图片（网络图片、本地图片、Base64 编码）
• ✅ 支持 @全体成员 或 @特定成员

其他操作

• get_status：获取节点状态
• get_version_info：获取版本信息

📊 功能分类表

🔐 凭证配置

使用前请在 n8n 中配置以下凭证：

• Access Token：访问令牌
• API Base URL：例如 http://localhost:5678

⚠️ 请确保机器人服务已启动，并确保 Token 与 URL 设置正确，否则 API 无法调用。

📁 项目结构

n8n-nodes-onebot/
├── credentials/                  # 凭证定义
│   └── OneBotApi.credentials.ts  # OneBot API 凭证配置
├── nodes/                        # 节点定义
│   └── OneBot/                   # OneBot 节点
│       ├── BotActions.ts         # 机器人操作实现
│       ├── FriendActions.ts      # 好友操作实现
│       ├── ForwardActions.ts     # 转发消息操作实现
│       ├── GenericFunctions.ts   # 通用函数
│       ├── GroupActions.ts       # 群组操作实现
│       ├── Interfaces.ts         # 接口定义
│       ├── MemberActions.ts      # 成员关系操作实现
│       ├── MessageActions.ts     # 消息操作实现
│       ├── MiscActions.ts        # 其他操作实现
│       ├── OneBot.node.json      # 节点元数据
│       ├── OneBot.node.ts        # 节点主类
│       ├── SearchFunctions.ts    # 搜索功能实现
│       └── onebot.svg            # 节点图标
├── dist/                         # 编译后的文件
├── .github/                      # GitHub 配置
├── package.json                  # 项目依赖和配置
├── tsconfig.json                 # TypeScript 配置
├── gulpfile.js                   # Gulp 构建配置
└── README.md                     # 项目文档

🎯 使用示例

示例 1：发送群消息

1. 添加 OneBot 节点
2. 设置资源为 消息
3. 操作选择 发送群消息
4. 填写目标群号与消息内容
5. 可选：添加图片或 @成员
6. 运行工作流

示例 2：群组管理

1. 添加 OneBot 节点
2. 设置资源为 群组
3. 选择操作（如 全员禁言）
4. 填写群号与相关参数
5. 执行工作流

示例 3：批量操作

1. 添加 OneBot 节点
2. 设置资源为 成员关系
3. 选择操作 批量操作
4. 选择操作模式（退群、删好友或两者都执行）
5. 启用白名单并选择要保留的群聊/好友
6. 执行工作流

示例 4：随机删除好友

1. 添加 OneBot 节点
2. 设置资源为 成员关系
3. 选择操作 随机删除好友
4. 设置最大删除数量（如5）
5. 启用白名单并选择要保留的好友
6. 执行工作流

💡 提示：执行群管理操作前，机器人需具备群管理员权限。

🔄 兼容性

本节点已在以下 OneBot 实现中测试通过：

• NapCatQQ

📚 参考资源

• n8n 社区节点文档
• OneBot v11 标准文档
• go-cqhttp 使用手册
• NapCatQQ 文档