openclaw - 💡(How to fix) Fix [Feature Request] Add HTTP/SOCKS5 Proxy Support for QQBot Connection [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#69656Fetched 2026-04-22 07:49:40
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Participants

QQBot plugin currently lacks proxy configuration, making it impossible to use in network environments that require proxy or where the source IP is not whitelisted.

Error Message

When running OpenClaw QQBot in an environment with dynamic IP, the QQ Open Platform rejects connections with error:

Root Cause

This is because QQ Open Platform requires whitelisted source IPs, but dynamic IPs (home broadband, mobile networks) change frequently.

Fix Action

Workaround

Currently, users must either:

  1. Deploy entire OpenClaw to a fixed-IP server
  2. Use system-level transparent proxy (complex setup)
  3. Use a forked QQBot plugin with proxy support (e.g., corrinehu/qqbot-openclaw)

None of these are ideal for users who want to run OpenClaw locally with minimal configuration.

Code Example

????????P????????n

---

{
  "plugins": {
    "entries": {
      "qqbot": {
        "enabled": true,
        "appId": "...",
        "clientSecret": "...",
        "proxy": {
          "type": "socks5",
          "host": "47.99.243.108",
          "port": 11080,
          "username": "optional",
          "password": "optional"
        }
      }
    }
  }
}

---

"proxy": "socks5://user:pass@host:port"
RAW_BUFFERClick to expand / collapse

Summary

QQBot plugin currently lacks proxy configuration, making it impossible to use in network environments that require proxy or where the source IP is not whitelisted.

Problem

When running OpenClaw QQBot in an environment with dynamic IP, the QQ Open Platform rejects connections with error:

????????P????????n```

This is because QQ Open Platform requires whitelisted source IPs, but dynamic IPs (home broadband, mobile networks) change frequently.

Setting standard environment variables `HTTP_PROXY` / `HTTPS_PROXY` does not work for QQBot connections.

## Proposed Solution

Add proxy configuration option to QQBot plugin config, similar to what was requested for WhatsApp in #2153.

### Suggested Config Schema

```json
{
  "plugins": {
    "entries": {
      "qqbot": {
        "enabled": true,
        "appId": "...",
        "clientSecret": "...",
        "proxy": {
          "type": "socks5",
          "host": "47.99.243.108",
          "port": 11080,
          "username": "optional",
          "password": "optional"
        }
      }
    }
  }
}

Or simpler string format:

"proxy": "socks5://user:pass@host:port"

Use Case

Users running OpenClaw on home servers or dynamic IP environments can route QQBot traffic through a fixed-IP proxy server (e.g., Alibaba Cloud ECS) to satisfy QQ Open Platform's IP whitelist requirement.

Related

  • #2153 (WhatsApp proxy support request)
  • #8079 (Browser tool proxy support)

Workaround

Currently, users must either:

  1. Deploy entire OpenClaw to a fixed-IP server
  2. Use system-level transparent proxy (complex setup)
  3. Use a forked QQBot plugin with proxy support (e.g., corrinehu/qqbot-openclaw)

None of these are ideal for users who want to run OpenClaw locally with minimal configuration.

extent analysis

TL;DR

Add a proxy configuration option to the QQBot plugin config to enable connections through a fixed-IP proxy server.

Guidance

  • Consider implementing the proposed config schema to allow users to specify proxy settings, such as type, host, port, username, and password.
  • Evaluate the simpler string format "proxy": "socks5://user:pass@host:port" as an alternative to the more detailed config schema.
  • Review related issues (#2153 and #8079) to ensure consistency in proxy support across different plugins and tools.
  • Assess the feasibility of using a system-level transparent proxy as a temporary workaround, despite its complexity.

Example

{
  "plugins": {
    "entries": {
      "qqbot": {
        "enabled": true,
        "appId": "...",
        "clientSecret": "...",
        "proxy": {
          "type": "socks5",
          "host": "47.99.243.108",
          "port": 11080,
          "username": "optional",
          "password": "optional"
        }
      }
    }
  }
}

Notes

The proposed solution requires changes to the QQBot plugin config, which may involve updates to the plugin's code and documentation. Additionally, users may need to set up a fixed-IP proxy server to route QQBot traffic.

Recommendation

Apply workaround: Use a forked QQBot plugin with proxy support (e.g., corrinehu/qqbot-openclaw) until the official plugin is updated with proxy configuration options. This allows users to run OpenClaw locally with minimal configuration while still satisfying QQ Open Platform's IP whitelist requirement.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix [Feature Request] Add HTTP/SOCKS5 Proxy Support for QQBot Connection [1 participants]