Issue Station
Sign In
Tools hereToolbox

openclaw - ✅(Solved) Fix [Bug]: channels.openclaw-weixin only enabled:true causes invalid channels.start channel error [1 pull requests, 1 comments, 2 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#81323•Fetched 2026-05-14 03:33:21
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
2
Author
yuwenxueyuwenxue
Participants
clawsweeper[bot]clawsweeper[bot]yuwenxueyuwenxue
Timeline (top)
cross-referenced ×2labeled ×2commented ×1

OpenClaw version: 2026.5.7 Plugin: @tencent-weixin/openclaw-weixin 2.4.3 OS: macOS 26.1 (arm64)

Bug description: When channels.openclaw-weixin is configured with only enabled: true, the gateway fails to load the plugin with error: invalid channels.start channel

Root cause: The channel config requires at least one additional field besides enabled (e.g. accounts: {}) to pass validation and load correctly.

Workaround: Add accounts: {} to the channel config:

"channels": {
  "openclaw-weixin": {
    "enabled": true,
    "accounts": {}
  }
}

Expected behavior: enabled: true alone should be sufficient to load the channel, or the error message should clearly indicate missing required fields.

Error Message

the gateway fails to load the plugin with error: or the error message should clearly indicate missing required fields.

Root Cause

Root cause: The channel config requires at least one additional field besides enabled (e.g. accounts: {}) to pass validation and load correctly.

Fix Action

Fix / Workaround

Workaround: Add accounts: {} to the channel config:

"channels": {
  "openclaw-weixin": {
    "enabled": true,
    "accounts": {}
  }
}

PR fix notes

PR #81331: fix: treat enabled:true as meaningful channel config

Description (problem / solution / changelog)

Summary

When channels.openclaw-weixin is configured with only enabled: true, the gateway fails to load the channel with error: invalid channels.start channel.

Root Cause

hasMeaningfulChannelConfigShallow() in src/config/channel-configured-shared.ts only checked for keys other than enabled. When the config was { enabled: true }, it returned false, causing the channel to not be recognized as configured. This prevented the channel plugin from being auto-enabled on gateway startup.

Fix

enabled: true alone is now treated as a meaningful config signal. This matches the documented workaround of adding accounts: {} — both paths now result in the channel being recognized as configured.

Changes

  • src/config/channel-configured-shared.ts: Updated hasMeaningfulChannelConfigShallow() to treat { enabled: true } as meaningful config
  • src/config/channel-configured.test.ts: Added test case for enabled: true alone

Fixes #81323

Changed files

  • src/config/channel-configured-shared.ts (modified, +9/-1)
  • src/config/channel-configured.test.ts (modified, +16/-0)

Code Example

"channels": {
  "openclaw-weixin": {
    "enabled": true,
    "accounts": {}
  }
}

---
RAW_BUFFERClick to expand / collapse

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

OpenClaw version: 2026.5.7 Plugin: @tencent-weixin/openclaw-weixin 2.4.3 OS: macOS 26.1 (arm64)

Bug description: When channels.openclaw-weixin is configured with only enabled: true, the gateway fails to load the plugin with error: invalid channels.start channel

Root cause: The channel config requires at least one additional field besides enabled (e.g. accounts: {}) to pass validation and load correctly.

Workaround: Add accounts: {} to the channel config:

"channels": {
  "openclaw-weixin": {
    "enabled": true,
    "accounts": {}
  }
}

Expected behavior: enabled: true alone should be sufficient to load the channel, or the error message should clearly indicate missing required fields.

Steps to reproduce

  1. Install OpenClaw 2026.5.7
  2. Install @tencent-weixin/openclaw-weixin plugin: openclaw plugins install @tencent-weixin/openclaw-weixin
  3. Run: openclaw config set channels.openclaw-weixin.enabled true
  4. Restart gateway: openclaw gateway restart
  5. Check status: openclaw status

Expected behavior

openclaw-weixin channel appears in status with state OK and starts receiving WeChat messages normally.

Actual behavior

Gateway loads only 2 plugins (memory-core, telegram), openclaw-weixin is not loaded. Log shows: invalid channels.start channel Gateway then auto-restarts, still without openclaw-weixin loaded. Status shows channel as OK but WeChat app displays "暂时无法连接".

OpenClaw version

2026.5.7 (eeef486)

Operating system

macOS 26.1 (arm64)

Install method

npm global

Model

deepseek/deepseek-chat

Provider / routing chain

openclaw -> deepseek

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

No response

Additional information

No response

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…

FAQ

Expected behavior

openclaw-weixin channel appears in status with state OK and starts receiving WeChat messages normally.

#ssr#cache issue#memory leak#API versioning#request timeout

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 - ✅(Solved) Fix [Bug]: channels.openclaw-weixin only enabled:true causes invalid channels.start channel error [1 pull requests, 1 comments, 2 participants]