chatgpt-on-wechat + NoneBot 腾讯云部署：QQ 机器人指南

1# 安装依赖
2apt-get update
3apt-get install -y ca-certificates curl gnupg lsb-release
4
5# 添加腾讯云内网 Docker GPG key
6curl -fsSL https://mirrors.cloud.tencent.com/docker-ce/linux/ubuntu/gpg -o docker-keyring.gpg
7gpg --dearmor -o /etc/apt/keyrings/docker.gpg docker-keyring.gpg
8
9# 添加腾讯云内网 Docker 软件源
10echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.cloud.tencent.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
11
12# 安装 Docker Engine 与 compose 插件
13apt-get update
14apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
15
16# 配置 Docker Hub 镜像加速器（关键！否则拉镜像会慢到超时）
17mkdir -p /etc/docker
18tee /etc/docker/daemon.json <<-'EOF'
19{
20  "registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
21}
22EOF
23systemctl daemon-reload
24systemctl restart docker
25
26# 把当前用户加入 docker 组，免去每次 sudo
27usermod -aG docker $USER

1fallocate -l 2G /swapfile
2chmod 600 /swapfile
3mkswap /swapfile
4swapon /swapfile
5echo "/swapfile none swap sw 0 0" | tee -a /etc/fstab
6free -h

1mkdir -p /opt/wechat-bot
2cd /opt/wechat-bot
3
4cat > docker-compose.yml <<-'EOF'
5version: "2.0"
6services:
7  chatgpt-on-wechat:
8    image: zhayujie/chatgpt-on-wechat
9    container_name: chatgpt-on-wechat
10    security_opt:
11      - seccomp:unconfined
12    environment:
13      OPEN_AI_API_KEY: "sk-fastgpt-wechat-token"
14      OPEN_AI_API_BASE: "http://one-api:3000/v1"
15      MODEL: "deepseek-v4.1-flash"
16      SINGLE_CHAT_PREFIX: '[""]'
17      GROUP_CHAT_PREFIX: '["@bot"]'
18      GROUP_NAME_WHITE_LIST: '["腾讯云测试群", "AI 助手群"]'
19      GROUP_CHAT_IN_ONE_CONTEXT: '["all"]'
20      IMAGE_CREATE_PREFIX: '["画"]'
21      CONVERSATION_MAX_TOKENS: 3000
22      SPEECH_RECOGNITION: "False"
23      CHARACTER_DESC: "你是 DeepSeek 驱动的群助手，请用简体中文、简洁准确地回答。"
24      EXPIRES_IN_SECONDS: 3600
25      USE_GLOBAL_PLUGIN_CONFIG: "True"
26      TZ: "Asia/Shanghai"
27    volumes:
28      - ./plugins:/app/plugins
29      - ./config.json:/app/config.json
30EOF

1cd /opt/wechat-bot
2docker compose pull
3docker compose up -d
4
5# 关键：第一次要在这里看二维码
6docker logs chatgpt-on-wechat

1mkdir -p /opt/nonebot
2cd /opt/nonebot
3
4python3 -m venv .venv
5source .venv/bin/activate
6
7# 使用腾讯云内网 PyPI 源加速
8pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple
9pip install nb-cli
10nb create

1cd botqq
2pip install nonebot-adapter-onebot nonebot-plugin-apscheduler

1cat > .env <<-'EOF'
2HOST=0.0.0.0
3PORT=8080
4SUPERUSERS=["你的QQ号"]
5NICKNAME=["bot", "助手"]
6 COMMAND_START=["/", ""]
7
8ONEBOT_ACCESS_TOKEN=your-token-here
9ONEBOT_WS_URLS=["ws://lagrange:3001"]
10
11# OneAPI 网关 + 国产模型
12OPENAI_BASE_URL=http://one-api:3000/v1
13OPENAI_API_KEY=sk-fastgpt-wechat-token
14OPENAI_MODEL=deepseek-v4.1-flash
15EOF

1nb run

1from nonebot import on_message
2from nonebot.adapters.onebot.v11 import GroupMessageEvent, MessageSegment
3import httpx
4
5deepseek_chat = on_message(priority=10, block=False)
6
7@deepseek_chat.handle()
8async def handle(event: GroupMessageEvent, ):
9    # 只处理 @ 机器人的群消息
10    if not event.is_tome():
11        return
12
13    payload = {
14        "model": "deepseek-v4.1-flash",
15        "messages": [{"role": "user", "content": event.get_plaintext()}],
16        "stream": False,
17    }
18    headers = {"Authorization": "Bearer sk-fastgpt-wechat-token"}
19    base = "http://one-api:3000/v1/chat/completions"
20
21    async with httpx.AsyncClient(timeout=60) as client:
22        r = await client.post(base, json=payload, headers=headers)
23        reply = r.json()["choices"][0]["message"]["content"]
24
25    await deepseek_chat.finish(MessageSegment.text(reply))

1docker compose ps
2# 或 NoneBot
3ps aux | grep nb

1# 在机器人容器里直接打 OneAPI，排除网络问题
2curl -s http://one-api:3000/v1/chat/completions \
3  -H "Authorization: Bearer sk-fastgpt-wechat-token" \
4  -H "Content-Type: application/json" \
5  -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"ping"}]}' | head -c 300

1docker compose logs --tail 50 chatgpt-on-wechat

1from nonebot import require
2require("nonebot_plugin_apscheduler")
3from nonebot_plugin_apscheduler import scheduler
4
5@scheduler.scheduled_job("cron", hour=9, minute=0, id="daily_report")
6async def daily_report():
7    # 拉取昨日数据 -> 调 DeepSeek 总结 -> 推送到指定群 / 用户
8    pass

1# 备份配置与插件（机器人的全部状态就在这里）
2tar czf /backup/bot-$(date +%F).tar.gz /opt/wechat-bot /opt/nonebot
3
4# 定时同步到腾讯云 COS（内网免流量）
5# coscli sync /backup cos://your-bucket/

1docker compose down
2# compose 里加一行：restart: unless-stopped
3docker compose up -d