ai-robot

provenance:github:badhope/ai-robot

WHAT THIS AGENT DOES

AI Robot is an assistant that can automatically respond in group chats on platforms like QQ and WeChat. It helps manage the flow of conversations and provides quick answers, saving time and effort for group members. Businesses, community managers, or anyone who frequently uses group chats to communicate could find it helpful. The agent can be set up quickly and easily, and it supports various AI services to provide intelligent responses. A key feature is its ability to understand commands and respond appropriately, even in private messages.

View Source ↗First seen 1mo agoNot yet hireable

README

# 🌟 AI Robot

<p align="center">
  <a href="#english-documentation"><img src="https://img.shields.io/badge/Language-English-blue?style=flat-square" alt="English"></a>
  <a href="#中文文档"><img src="https://img.shields.io/badge/语言-中文-red?style=flat-square" alt="中文"></a>
</p>

<div align="center">

```
╔══════════════════════════════════════════════════════════════════╗
║                                                                  ║
║        🌟 AI Robot - Intelligent Group Chat Assistant 🤖         ║
║                                                                  ║
║        智能群聊助手 - Smart QQ/WeChat Group Chat AI Bot          ║
║                                                                  ║
╚══════════════════════════════════════════════════════════════════╝
```

**🚀 Plug-and-Play QQ Group AI Bot | Multi-Platform API Support | One-Click Launch | Ready to Use**

[![Version](https://img.shields.io/badge/version-2.0.0-blue?style=flat-square)](https://github.com/badhope/ai-robot)
[![License](https://img.shields.io/badge/license-Proprietary-green?style=flat-square)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey?style=flat-square)](https://github.com/badhope/ai-robot/releases)
[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square)](https://nodejs.org)
[![Stars](https://img.shields.io/github/stars/badhope/ai-robot?style=flat-square)](https://github.com/badhope/ai-robot/stargazers)

</div>

---

<a name="english-documentation"></a>
## 📚 English Documentation

### Table of Contents

- [Project Overview](#project-overview)
- [Architecture](#architecture)
- [Features](#features)
- [System Requirements](#system-requirements)
- [Installation](#installation)
- [Quick Start Guide](#quick-start-guide)
- [Configuration](#configuration)
- [Protocol Documentation](#protocol-documentation)
- [Advanced Usage](#advanced-usage)
- [Troubleshooting](#troubleshooting)
- [Contributing](#contributing)
- [License](#license)
- [Changelog](#changelog)

---

### Project Overview

AI Robot is a sophisticated, production-ready intelligent group chat assistant designed for QQ and WeChat platforms. Built with modern technologies (Electron, Vue 3, TypeScript), it provides seamless AI-powered conversations with support for multiple LLM providers.

#### Key Highlights

| Feature | Description |
|---------|-------------|
| 🎯 **Zero-Configuration** | Download → Install → API Key → Launch |
| 🌐 **Multi-Platform AI** | Alibaba Cloud, DeepSeek, Zhipu, Moonshot, OpenAI, Google, Ollama |
| 💬 **Smart Conversations** | @ mentions, command triggers, auto-reply in private chats |
| 🖼️ **Vision Support** | Image recognition with multimodal AI (Pro version) |
| 🎤 **Voice Reply** | Text-to-speech responses (Pro version) |
| 🔌 **Plugin System** | Extensible plugin architecture |
| 💾 **Session Persistence** | SQLite storage, survives restarts |
| 🎨 **Modern UI** | Electron + Vue 3, smooth and beautiful |
| 🌙 **Dark Theme** | Eye-friendly dark interface |

---

### Architecture

AI Robot follows a modular, adapter-based architecture that separates concerns and enables easy extensibility.

```
┌─────────────────────────────────────────────────────────────────┐
│                          AI Robot                               │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   ┌─────────────┐     ┌─────────────┐     ┌─────────────┐      │
│   │  QQ Adapter │     │ IM Adapters │     │ WeChat      │      │
│   │  (NapCatQQ) │     │  (Platform) │     │ (Future)    │      │
│   └──────┬──────┘     └──────┬──────┘     └──────┬──────┘      │
│          │                  │                  │              │
│          └──────────────────┼──────────────────┘              │
│                             ▼                                   │
│                    ┌─────────────────┐                          │
│                    │   Core Layer    │                          │
│                    │  - IM Handler   │                          │
│                    │  - LLM Selector │                          │
│                    │  - Storage      │                          │
│                    │  - Plugin       │                          │
│                    └────────┬────────┘                          │
│                             │                                   │
│          ┌──────────────────┼──────────────────┐                │
│          ▼                  ▼                  ▼                │
│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐       │
│   │ Alibaba     │    │ Ollama      │    │ Future      │       │
│   │ Adapter     │    │ Adapter     │    │ Providers   │       │
│   └─────────────┘    └─────────────┘    └─────────────┘       │
│                                                                 │
│   ┌─────────────┐    ┌─────────────┐                           │
│   │   Setup UI  │    │  SQLite     │                           │
│   │  (Console)  │    │  Storage    │                           │
│   └─────────────┘    └─────────────┘                           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

#### Core Components

| Component | Location | Responsibility |
|-----------|----------|----------------|
| **apps/server** | `apps/server/` | Main service entry, HTTP/WebSocket server, component initialization |
| **apps/setup-ui** | `apps/setup-ui/` | Visual console, environment detection, configuration wizard |
| **packages/core** | `packages/core/` | Core logic: IM handling, LLM routing, storage, plugins |
| **packages/qq-adapter** | `packages/qq-adapter/` | NapCatQQ WebSocket integration |
| **packages/wechat-adapter** | `packages/wechat-adapter/` | WeChat HTTP adapter (reserved) |
| **packages/alibaba-adapter** | `packages/alibaba-adapter/` | Alibaba Cloud/DashScope API |
| **packages/ollama-adapter** | `packages/ollama-adapter/` | Local Ollama model integration |
| **packages/sqlite-storage** | `packages/sqlite-storage/` | SQLite session persistence |
| **packages/doctor** | `packages/doctor/` | Environment diagnostics |

---

### Features

#### 🤖 AI Capabilities

| Capability | Description | Status |
|------------|-------------|--------|
| Multi-turn Conversation | Context-aware dialogue with session memory | ✅ |
| System Prompts | Customizable AI personality and behavior | ✅ |
| Temperature Control | Adjust response creativity | ✅ |
| Token Limits | Configure max response length | ✅ |
| Vision (Multimodal) | Image understanding and description | 👑 Pro |
| Voice Synthesis | Text-to-speech responses | 👑 Pro |

#### 💬 Messaging Features

| Feature | Description |
|---------|-------------|
| @ Mention Trigger | Bot responds when mentioned in groups |
| Command Prefix | Use `/ai` or custom prefix to trigger |
| Private Auto-Reply | Automatic responses in private chats |
| Group Smart Reply | Intelligent group conversation handling |
| Message Quoting | Reply to specific messages |

#### 🎛️ Configuration Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `LLM_PROVIDER` | string | `alibaba` | AI provider selection |
| `ALIBABA_API_KEY` | string | - | Alibaba Cloud API key |
| `ALIBABA_MODEL` | string | `qwen-plus` | Model selection |
| `OLLAMA_BASE_URL` | string | `http://localhost:11434` | Ollama server URL |
| `SESSION_STORAGE` | string | `sqlite` | Storage backend |
| `SESSION_MAX_MESSAGES` | number | `100` | Max messages per session |
| `CHAT_PREFIX` | string | `/ai` | Command trigger prefix |
| `PRIVATE_AUTO_REPLY` | boolean | `true` | Auto-reply in private chats |
| `GROUP_AI_TRIGGER` | string | `both` | Group trigger mode: `at`, `prefix`, `both` |

---

### System Requirements

#### Minimum Requirements

| Platform | Requirement |

[truncated…]

PUBLIC HISTORY

First discoveredMar 21, 2026

IDENTITY

inferred

Identity inferred from code signals. No PROVENANCE.yml found.

Is this yours? Claim it →

METADATA

platformgithub

first seenFeb 20, 2026

last updatedMar 21, 2026

last crawled14 days ago

version—

README BADGE

Add to your README:

![Provenance](https://getprovenance.dev/api/badge?id=provenance:github:badhope/ai-robot)