dwgx

YuKiKo — AI skill for Claude Code

AI community

AI QQ bot with OneBot, NapCat, LLM routing, plugins, and WebUI.

How to install YuKiKo

This entry records only its repository, not the path inside it, so there is no exact command to give. Open dwgx/YuKiKo and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What YuKiKo does

AI QQ bot with OneBot, NapCat, LLM routing, plugins, and WebUI.

Alternatives in AI

  • Oh My Claudecode — 32 specialized agents and 7 execution modes for Claude Code, with smart model routing and automatic paralleliz 10.9k ★
  • Bot On Anything — A large model-based chatbot builder that can quickly integrate AI models (including ChatGPT, Claude, Gemini) i 4.2k ★
  • LiveAgent — A fully functional AI Agent desktop client that supports Webui access and can be creatively customized and exp 1.9k ★

README

YuKiKo Bot

**基于 NoneBot2 + OneBot V11 的智能 QQ 机器人**

[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-3776AB?logo=python&logoColor=white)](https://www.python.org/) [![NoneBot2](https://img.shields.io/badge/NoneBot2-FastAPI-EA5252)](https://nonebot.dev/) [![React](https://img.shields.io/badge/React-18-61DAFB?logo=react&logoColor=white)](https://react.dev/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![GitHub stars](https://img.shields.io/github/stars/dwgx/YuKiKo?style=social)](https://github.com/dwgx/YuKiKo)

一个功能丰富的 AI 驱动 QQ 群聊/私聊机器人,支持多模型接入、Agent 工具调用、 音乐点播、图片生成、视频解析、Web 管理面板等。

[快速开始](#-快速开始) · [功能特性](#-功能特性) · [配置说明](#-配置说明) · [文档](#-文档) · [English](docs/en/GUIDE.md)


✨ 功能特性

类别 功能
AI 对话 多模型(OpenAI / Claude / DeepSeek / Gemini / 通义千问 / Moonshot 等),上下文记忆,知识库自动学习
Agent 系统 50+ 内置工具,自动推理与多步工具调用,置信度路由
音乐点播 多平台搜索播放,VIP 歌曲解锁,歌手一致性保护,B站音频回退
搜索引擎 联网搜索,网页智能摘要,结构化信息提取
视频解析 B站 / 抖音 / 快手 / AcFun 视频下载与内容分析
图片生成 DALL-E 等多模型,自动 NSFW 过滤
Web 管理面板 React 前端,配置热更新,日志实时查看,数据库管理,在线聊天测试
插件系统 热插拔,独立配置文件,WebUI 可视化管理
安全机制 内容过滤,权限三级分层,密钥加密存储,Self-check 防误回复

📋 环境要求

依赖 版本 说明
Python 3.10+ 推荐 3.11 / 3.12
Node.js 18+ 构建 WebUI 用
ffmpeg 最新 音视频处理(Linux 安装脚本自动安装)
OneBot V11 服务 推荐 NapCat

Windows 用户如果没有 Python / Node.js,请先安装:

🚀 快速开始

方式一:Linux 一键部署(推荐)

无需手动 clone,一条命令搞定:

bash <(curl -fsSL https://raw.githubusercontent.com/dwgx/YuKiKo/main/bootstrap.sh)

脚本自动完成:系统依赖 → Python 虚拟环境 → WebUI 构建 → systemd 服务注册。

非交互模式(适合自动化 / CI)
bash <(curl -fsSL https:/