7418andClaude Opus 4.6
d360b53bde
- Rewrite index.mdx as proper getting started guide - New: chat.mdx (modes, permissions, context management) - New: skills.mdx (categories, marketplace, local skills) - New: design-agent.mdx (single/batch image generation) - New: gallery.mdx (browsing, filtering, detail view) - Rewrite providers.mdx — CLI env auth, cc switch caveat, API Key vs Auth Token, Chinese provider presets, model mapping, priority chain - Rewrite mcp.mdx — three transport types, dual view modes - Rewrite assistant-workspace.mdx — align with Settings > Assistant tab - Rewrite faq.mdx — comprehensive Q&A - Bridge split into 5 pages: overview + Telegram + Discord + Feishu + QQ - Flatten single-page folders to remove sidebar expand arrows - Update meta.json with new pages Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
77 lines
2.8 KiB
Plaintext
77 lines
2.8 KiB
Plaintext
---
|
|
title: QQ
|
|
description: Configure the QQ Bot bridge.
|
|
---
|
|
|
|
# QQ Bridge
|
|
|
|
Chat with Claude through a QQ Bot. Supports image sending and DM bridging.
|
|
|
|
## Create a QQ Bot
|
|
|
|
1. Go to the [QQ Open Platform](https://q.qq.com) and register a developer account
|
|
2. Create a new Bot application
|
|
3. Complete identity verification (individual or enterprise)
|
|
4. On the application management page, obtain:
|
|
- **AppID** (numeric format)
|
|
- **App Secret**
|
|
5. Under **Feature Configuration**, enable the required message permissions
|
|
6. Submit for review and wait for approval
|
|
|
|
> The QQ Bot platform has a strict review process. It is recommended to read the platform documentation and integration guidelines carefully.
|
|
|
|
## Configure in CodePilot
|
|
|
|
1. Click **Bridge** in the sidebar, then switch to the **QQ** tab
|
|
2. Enter the **App ID** and **App Secret**
|
|
3. Click **Test Connection** to verify the credentials
|
|
4. (Optional) Configure **Allowed Users** — Enter QQ user_openid values, separated by commas
|
|
5. (Optional) Configure image settings:
|
|
- **Enable image sending** — Allow the Bot to send images (enabled by default)
|
|
- **Maximum image size** — Size limit per image (default 20 MB)
|
|
6. Click **Save**
|
|
|
|
## Enable the Bridge
|
|
|
|
1. Go back to the Bridge overview page
|
|
2. Make sure the **QQ** channel toggle is on
|
|
3. Make sure the Bridge master switch is on
|
|
4. Click **Start**
|
|
5. Add the Bot as a friend in QQ, then send a message to start chatting with Claude
|
|
|
|
## Message Format
|
|
|
|
The QQ bridge sends messages in plain text format:
|
|
|
|
- Markdown rendering is not supported
|
|
- Overly long messages are automatically split into chunks (max 2000 characters each)
|
|
- Each reply can contain at most 3 chunks (platform limitation)
|
|
- Image sending is supported (must be enabled in image settings)
|
|
|
|
## Permission Handling
|
|
|
|
The QQ Bot platform does not support inline buttons, so permission confirmations are handled via text commands:
|
|
|
|
- The Bot sends a permission confirmation message including the operation description and a permission ID
|
|
- Reply `/perm allow <ID>` to allow the operation
|
|
- Reply `/perm deny <ID>` to deny the operation
|
|
- Reply `/perm allow_session <ID>` to allow similar operations for the rest of this session
|
|
|
|
## Troubleshooting
|
|
|
|
### Test connection failed
|
|
|
|
1. Confirm the App ID and App Secret are correct
|
|
2. Confirm the Bot application has passed review
|
|
3. Confirm developer identity verification is complete
|
|
|
|
### Bot not responding
|
|
|
|
1. Confirm you have added the Bot as a QQ friend
|
|
2. Confirm the CodePilot bridge is running
|
|
3. If you configured an allowed users list, confirm your user_openid is in the list
|
|
|
|
### Messages are truncated
|
|
|
|
The QQ platform limits each reply to a maximum of 3 chunks. For particularly long replies, the end may be lost. Consider asking Claude to reply concisely in your prompts.
|