Introduction

When using agents in DeepSeek Harness (DSH), common requirements go beyond simply chatting within the Web UI; instead, the same set of agent capabilities needs to be integrated into QQ single chats, group chats, and channels: receiving messages, replying to messages, preserving context per session, handling images and attachments, and performing access control and approvals.

dsh-qqbot-community provides DSH with the capability to connect to QQ official robots.

What is this

dsh-qqbot-community is maintained by DLive under the MIT license. Documentation states that its core connection, gateway, and session management logic originate from openclaw-qqbot and follow the original project’s MIT license.

Verified documentation also warns: Overall functionality is not strictly tested, and some features may be unstable.

Core Capabilities

Messages and Sessions

  • QQ official robot access
  • Message sending and receiving
  • Session management
  • Agent preset mounting
  • Sandbox support

Gateway and Context

  • Gateway reliability: WebSocket heartbeat, reconnection backoff, session RESUME
  • @mention cleaning
  • Quoted message context

Media and Outbound Replies

  • Image understanding
  • Speech-to-text (STT)
  • Attachment persistence
  • Rich media sending
  • Streaming replies (C2C)
  • Outbound merging and segmentation
  • Passive reply limits
  • Typing indicator

Control and Extensions

  • Access control
  • Approval bridge (inline keyboard)
  • ask_user_question forwarding
  • QQ API proxy tool qq_api
  • Slash commands
  • Scheduled reminders
  • HTTP push API (httpApi, disabled by default)

Installation and Enablement

When integrating into a DSH profile, documentation provides the following command:

dsh plugin --profile web add dsh-qqbot-community

When installing as an npm package, documentation also provides:

npm install dsh-qqbot-community

Regarding runtime dependencies, verified documentation shows package.json declares Node >=20, and peerDependencies requires @deepseek-ai/cordis ^4.0.1.

Before enabling, you need to append QQ bot-related configuration to the profile’s patch file. The location given by the documentation is:

~/.dsh/profiles/web/cordis.patch.yml

Append the qqbot-community configuration layer at the end of the existing content, for example, configuring id, secret, sandbox, etc.:

- id: qqbot-community
  name: dsh-qqbot-community
  config:
    id: 'Your AppID'
    secret: 'Your AppSecret'
    sandbox: true

Here, id and secret correspond to QQ official robot credentials, and sandbox is used to declare the sandbox scenario.

Typical Usage

After completing the plugin installation and configuration, start DSH:

dsh web

After starting, it executes: obtaining the token, establishing the WS gateway, and creating or restoring agents per session.

In QQ sessions, documentation provides an example of opening a new session with a specified preset:

/new code

This usage is used to open a new session with a specified preset.

Applicable Scenarios and Notes

This plugin is suitable for developers who are already using DSH and wish to integrate DSH agent capabilities into QQ official bots.

Before using, please note:

  • The plugin runs with the current dsh process; it can read profile configuration, call DSH agent capabilities, and process QQ messages. You should check the source code and license before installing.
  • Overall functionality is not strictly tested, and some features may be unstable.
  • `markdown, message button permissions, and QQ-specificGROUP_MESSAGE_CREATE` capabilities are optional, unmigrated, or potentially restricted capabilities; do not assume they are always available by default.
  • Documentation explicitly does not migrate Webhook transport, hot upgrades, pairing stream, credential-backup, group self-governing mode, group history buffer injection, etc.
  • The HTTP Push API (httpApi) is disabled by default; verified documentation only states that it is used by external systems to push text to a specified QQ channel, and the complete endpoints and parameters are not fully confirmed in the provided documentation.

Getting the Plugin

Directory page:

https://www.skillhub.cn/plugins/DLive/dsh-qqbot-community

GitHub repository:

https://github.com/DLive/dsh-qqbot-community

This is a community plugin page and does not belong to the official app store.