Skip to content

The agent that grows with you

2.2 KB
Raw Blame
name: onebot-platform
repo: https://github.com/mario841859784/hermes-plugin-onebot
sha: 086dd7e5c13004e41301f5cea1f352c46b0f3c50
version: "1.3.0"
title: QQ (OneBot)
maintainer: mario841859784
tier: community
category: platform
requires_hermes: ">=0.22.2"
docs_url: https://github.com/mario841859784/hermes-plugin-onebot/blob/086dd7e5c13004e41301f5cea1f352c46b0f3c50/README.md
platforms: []
description: "QQ bot via the OneBot 11 protocol: connects Hermes to your own self-hosted NapCat, Lagrange, LLOneBot or go-cqhttp deployment over WebSocket — the plugin hosts a reverse-WS server inside the Hermes gateway, or dials an existing forward-WS endpoint — and adds the qq toolset (qq_send_image, qq_send_voice, qq_send_video, qq_send_file, qq_send_forward, qq_napcat_api, qq_group_history) for DM and group chats with admin allowlists, group mention gating, per-member soft limits, and cron/notification delivery to a configured home channel. Inbound images are downloaded and (with Pillow) downscaled before the vision tool sees them; long replies are split at sentence boundaries or rendered locally into a text image with fonttools/Pillow. Disclosure — talks only to the user's own OneBot deployment; the plugin's listener (default port 8643) is a long-running background server inside the Hermes gateway process that accepts the bridge's reverse WebSocket and also serves the qq_* tools' local HTTP API, refuses a non-loopback bind without an access token, and limits tool sends from a QQ session to that chat or the configured home channel unless the session is an admin user's private chat; inbound message images are downloaded from that deployment into the plugin's data directory for the vision tool; text-to-image rendering runs locally (fonttools, Pillow, system CJK fonts) with no third-party calls; credentials (the OneBot access token, allowed-user lists, home channel) reach the plugin only through Hermes's secret scope and ONEBOT_* config and go nowhere but your own OneBot deployment; no telemetry or usage reporting."
capabilities:
  provides_tools:
    - qq_send_image
    - qq_send_voice
    - qq_send_video
    - qq_send_file
    - qq_send_forward
    - qq_napcat_api
    - qq_group_history
  provides_hooks: []
  provides_middleware: []
  requires_env: []