Z-BlogPHP LaoLi QQ Robot Plugin

🚀 Overview

Z-BlogPHP Laoli QQ Robot Plugin is an intelligent robot plugin based on the OneBot 11 protocol, providing powerful QQ robot functionality for Z-Blog websites, supporting multiple AI services and rich group management features.

Features

🤖 Core Robot Functionality

• Multi-protocol Support: Based on the OneBot 11 protocol

• Bi-directional Communication: Supports message reception and active push

• Multi-scenario Application: Supports group chat and private chat scenarios

🧠 AI Intelligent Services

• Multi-model Text Generation: Supports 8 mainstream AI language models

• High-Quality Image Generation: Supports 5 image generation models

• Intelligent Dialogue: Customizable AI roles and reply styles

🎨 Content Features

• On-site Search: Intelligent search based on the Z-Blog article system

• Resource Sharing: Sharing of images, wallpapers, and other content

• Multimedia Support: Rich media content interaction

• Entertainment Features: Lucky Draw

⚙️ Management Functions

• Group Management Tools: Mute management, message recall

• Scheduled Tasks: Morning report push, automatic reminders

• Permission Control: Multi-person collaborative management

Installation and Configuration

Environment Requirements

• Z-Blog PHP 1.7.3+

• PHP 7.4+

• QQ robot framework supporting OneBot 11 protocol

Installation Steps

1. Configure QQ client

2. Download the plugin and upload it to the Z-Blog plugin directory

3. Enable the plugin in the backend

4. Configure basic robot parameters

5. Set up API keys and service options

Detailed Configuration Instructions

Basic Configuration

Feature Switch Configuration

• Group Image Robot: Enable group image sharing function

• Group Chinese Animation Robot: Enable intelligent search based on Z-Blog articles (not limited to Chinese animation)

• Group Wallpaper Search: Enable wallpaper search function

• Group AI Robot: Enable AI text conversation function

• Group AI Image Robot: Enable AI image generation function

• Group Mute Robot: Enable mute management function

• Morning Report Robot: Enable scheduled morning report push

Text Generation Service Configuration

Supports 8 advanced text generation models:

Image Generation Service Configuration

Supports 5 high-quality image generation models:

API Key Configuration

AI Role Definition

You are an assistant eager to answer all kinds of questions, named Laoli next door. Your task is to provide professional, accurate, and insightful advice to users. Please return pure text content of less than 600 words.

Advanced Feature Configuration

Usage Guide

Group Function Usage

AI Dialogue Function

1. Ask questions by @mentioning the robot in the group

2. The system will generate a response based on the selected text model

3. Supports continuous dialogue and context understanding

Image Generation Function

1. Use specific commands to describe the image you want to generate

2. The system calls the selected image model to generate the image

3. Supports multiple styles and sizes

@Robot generate a 3D realistic style beautiful woman image

Content Search Function (Chinese Animation Robot)

Essence: Intelligent search based on the Z-Blog article system

Application Scenarios:

• Search for technical articles within the blog

• Find product introduction content

• Retrieve tutorials and documentation

• Any query based on on-site content

Usage:

@Robot search [keyword]
@Robot find [article title]
@Robot command [keyword]

Management Functions

• Mute Management: Multiple people @mentioning the robot + @mentioning the target user to execute mute

• @Robot Grand Sealing Technique @user_to_be_muted

• Message Management: Supports message recall and management

• Scheduled Push: Automatically push morning reports and other scheduled content

Entertainment Features

Lucky Draw

@Robot lucky draw

Effect: Mutes the speaker according to the lucky draw time result

API Interface Description

External Message Push API

Used by external sites to use robot push services

Endpoint: http://***/zb_users/plugin/JzQrobot/msg.php

Supported Parameters:

• act: Action type (get)

• qq: Receive type (private chat/group chat)

• token: Verification Token (supports post and get)

• msg: Message content (supports post and get)

• qq: QQ number or group number (supports post and get)

Usage Example:

# Private message push
curl "http://***/zb_users/plugin/JzQrobot/msg.php?act=get&qq=private&token=***&msg=hello&qq=123456"

# Group message push  
curl "http://***/zb_users/plugin/JzQrobot/msg.php?act=get&qq=group&token=***&msg=group announcement&qq=123456789"

Model Selection Recommendations

Text Model Selection Guide

• Daily Conversation: GPT-4o-mini (high cost-effectiveness)

• Complex Reasoning: OpenAI o3-mini or DeepSeek R1

• Chinese Optimization: Zhipu Model or DeepSeek-V3

• Creative Writing: Gemini 2.0 Flash series

Image Model Selection Guide

• Fast Generation: FLUX.1-schnell

• High-Quality Demand: FLUX.1-dev (paid)

• Balanced Choice: Stable Diffusion 3.5 Large

Important Notes

Cost Control

1. Paid Models Note: FLUX.1-dev and SD 3.5 Turbo are paid models (free credit can be used)

2. API Usage Monitoring: Regularly check API usage for each service provider

3. Backup Plan: Configure multiple service providers in case of quota exhaustion

Performance Optimization

1. Model Matching: Select appropriate models based on usage scenarios

2. Caching Strategy: Cache frequently queried results

3. Rate Limiting: Set request frequency reasonably to avoid exceeding limits

Troubleshooting

Common Problem Solutions

Robot Unresponsive

1. Check if the robot server address and port are reachable

2. Verify that the Token configuration is correct

3. Confirm the running status of the QQ robot framework

AI Service Abnormalities

1. Check if the API key is valid and not expired

2. Confirm the quota and balance status of the service provider

3. Check network connection and firewall settings

Inaccurate Search Results

1. Ensure Z-Blog article content is complete

2. Check the search keyword matching logic

3. Verify article publication status and permissions

Log Viewing Paths

• Z-Blog System Logs: zb_users/logs/

• Plugin Running Logs: View in the plugin settings interface

• API Call Records: Service provider consoles

Compatible QQ Robot Clients

🎯 Recommended Clients

1. NapCatQQ (Highly Recommended)

• Type: Node.js-based OneBot 11 implementation

• Features:

• High performance, low resource usage

• Supports the latest QQ protocol

• Rich plugin ecosystem

• Active community support

• Applicable Scenarios: Production environment, high concurrency scenarios

2. llonebot

• Type: Lightweight OneBot 11 implementation

• Features:

• Simple configuration, easy to deploy

• Small memory footprint

• Supports basic message sending and receiving

• Applicable Scenarios: Small projects, testing environments

🔄 Other Compatible Clients

3. go-cqhttp (Classic Choice)

• Type: OneBot 11 implementation written in Go

• Features:

• Comprehensive functionality, high stability

• Supports advanced features like file transfer, voice, etc.

• Rich configuration options

• Cross-platform support

• Status: Development stopped, but still usable

4. OneBot Mirai

• Type: OneBot implementation based on the Mirai framework

• Features:

• Based on the mature Mirai ecosystem

• Supports Android protocol

• Rich plugin system

• Applicable Scenarios: Users requiring advanced features

5. SignBot

• Type: OneBot implementation for signature services

• Features:

• Solves signature issues

• Supports the latest QQ protocol

• Commercial-grade stability

• Applicable Scenarios: Commercial projects, environments requiring high stability

6. KomoriBot

• Type: Novel OneBot 11 implementation

• Features:

• Supports multiple protocols

• Modular design

• Continuously updated and maintained

7. Chronocat

• Type: OneBot implementation based on the Red protocol

• Features:

• Supports the latest QQ

• Rich functionality

• Active development

8. OICQ-OneBot

• Type: OneBot implementation based on oicq

• Features:

• Comprehensive protocol support

• Flexible configuration

• Good community support

Client Selection Guide

By Demand

Performance Comparison

Installation and Deployment

General Deployment Steps

1. Download Client

   # NapCatQQ Example
   git clone https://github.com/NapNeko/NapCatQQ.git
   cd NapCatQQ
   npm install

2. Configure Client

• Modify QQ number, port, and Token in the configuration file

• Ensure consistency with Z-Blog plugin configuration

3. Start Client

   # NapCatQQ
   npm start
   
   # llonebot
   ./llonebot

4. Verify Connection

• Check client logs for errors

• Test robot status in Z-Blog backend

Version Update Log

• v1.0: Basic robot functionality

• v1.1: Added multi-model AI services

• v1.2: Optimized search functions and API interfaces

• v1.3: Supports more image generation models

Technical Support and Feedback

• Document Updates: Please follow the plugin release page

• Issue Feedback: Contact the developer through the Z-Blog Application Center

• Feature Suggestions: Welcome to provide valuable suggestions