openclaw - 💡(How to fix) Fix [Bug] QQBot/Feishu channels fail: Cannot read properties of undefined (reading 'run') after startup with --allow-unconfigured

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…

After gateway startup, both QQBot and Feishu channels fail to dispatch messages with the same error:

Cannot read properties of undefined (reading 'run')

Webchat (dashboard) works fine — only external channels are affected.

Error Message

openclaw | 2026-05-31T16:17:56.659+00:00 [gateway] provider auth state pre-warmed in 4121ms eventLoopMax=960.0ms

openclaw | 2026-05-31T16:18:14.466+00:00 [qqbot] [default] Processing message from B80472BCA4A19DB34C6B4A4828B7999F: 恢复了吗
openclaw | 2026-05-31T16:18:14.666+00:00 [qqbot] [default] [qqbot:api] <<< Status: 200 OK | TraceId: 465e3af3dc96021499b4de39afbb446d
openclaw | 2026-05-31T16:18:14.685+00:00 [qqbot] [default] Message processing failed: Cannot read properties of undefined (reading 'run')

openclaw | 2026-05-31T16:18:31.782+00:00 [warn]: [ 'no im.chat.access_event.bot_p2p_chat_entered_v1 handle' ]

openclaw | 2026-05-31T16:18:37.820+00:00 [feishu] feishu[default]: received message from ou_xxx in oc_xxx (p2p)
openclaw | 2026-05-31T16:18:37.836+00:00 [feishu] feishu[default]: Feishu[default] DM from ou_xxx: 恢复了吗
openclaw | 2026-05-31T16:18:37.854+00:00 [feishu] feishu[default]: dispatching to agent (session=agent:shu-daily:feishu:direct:ou_xxx)
openclaw | 2026-05-31T16:18:37.859+00:00 [feishu] feishu[default]: failed to dispatch message: TypeError: Cannot read properties of undefined (reading 'run')

Root Cause

Traced the error to the channel dispatch code in the runtime:

Feishu (monitor.account-CJaXe8-T.js, line ~2870):

const core = getFeishuRuntime();  // runtime is initialized
await core.channel.inbound.run({...});  // core.channel.inbound is undefined

QQBot (monitor-DWJ7KlrE.js, line ~321):

runtime.error?.(`Message processing failed: ${String(err)}`);

The core.channel.inbound property is undefined when the channel adapter tries to dispatch messages. The runtime object itself is initialized (otherwise getFeishuRuntime() would throw "Feishu runtime not initialized"), but the channel.inbound sub-object was not mounted.

Fix Action

Fix / Workaround

After gateway startup, both QQBot and Feishu channels fail to dispatch messages with the same error:

Cannot read properties of undefined (reading 'run')

openclaw | 2026-05-31T16:18:37.820+00:00 [feishu] feishu[default]: received message from ou_xxx in oc_xxx (p2p) openclaw | 2026-05-31T16:18:37.836+00:00 [feishu] feishu[default]: Feishu[default] DM from ou_xxx: 恢复了吗 openclaw | 2026-05-31T16:18:37.854+00:00 [feishu] feishu[default]: dispatching to agent (session=agent:shu-daily:feishu:direct:ou_xxx) openclaw | 2026-05-31T16:18:37.859+00:00 [feishu] feishu[default]: failed to dispatch message: TypeError: Cannot read properties of undefined (reading 'run')


Traced the error to the channel dispatch code in the runtime:

Code Example

Cannot read properties of undefined (reading 'run')

---

openclaw | 2026-05-31T16:17:56.659+00:00 [gateway] provider auth state pre-warmed in 4121ms eventLoopMax=960.0ms

openclaw | 2026-05-31T16:18:14.466+00:00 [qqbot] [default] Processing message from B80472BCA4A19DB34C6B4A4828B7999F: 恢复了吗
openclaw | 2026-05-31T16:18:14.666+00:00 [qqbot] [default] [qqbot:api] <<< Status: 200 OK | TraceId: 465e3af3dc96021499b4de39afbb446d
openclaw | 2026-05-31T16:18:14.685+00:00 [qqbot] [default] Message processing failed: Cannot read properties of undefined (reading 'run')

openclaw | 2026-05-31T16:18:31.782+00:00 [warn]: [ 'no im.chat.access_event.bot_p2p_chat_entered_v1 handle' ]

openclaw | 2026-05-31T16:18:37.820+00:00 [feishu] feishu[default]: received message from ou_xxx in oc_xxx (p2p)
openclaw | 2026-05-31T16:18:37.836+00:00 [feishu] feishu[default]: Feishu[default] DM from ou_xxx: 恢复了吗
openclaw | 2026-05-31T16:18:37.854+00:00 [feishu] feishu[default]: dispatching to agent (session=agent:shu-daily:feishu:direct:ou_xxx)
openclaw | 2026-05-31T16:18:37.859+00:00 [feishu] feishu[default]: failed to dispatch message: TypeError: Cannot read properties of undefined (reading 'run')

---

const core = getFeishuRuntime();  // runtime is initialized
await core.channel.inbound.run({...});  // core.channel.inbound is undefined

---

runtime.error?.(`Message processing failed: ${String(err)}`);

---

[
  {"agentId": "main", "match": {"channel": "qqbot", "accountId": "default"}},
  {"agentId": "shu-daily", "match": {"channel": "feishu", "accountId": "default"}}
]
RAW_BUFFERClick to expand / collapse

[Bug] QQBot and Feishu channels fail with "Cannot read properties of undefined (reading 'run')" after startup

Environment

  • OpenClaw version: 2026.5.28
  • Node.js: v24.14.0
  • OS: Linux 6.12.30+ (x64)
  • Deployment: Docker (tini entrypoint)
  • Gateway startup command: openclaw gateway run --allow-unconfigured

Description

After gateway startup, both QQBot and Feishu channels fail to dispatch messages with the same error:

Cannot read properties of undefined (reading 'run')

Webchat (dashboard) works fine — only external channels are affected.

Logs

openclaw | 2026-05-31T16:17:56.659+00:00 [gateway] provider auth state pre-warmed in 4121ms eventLoopMax=960.0ms

openclaw | 2026-05-31T16:18:14.466+00:00 [qqbot] [default] Processing message from B80472BCA4A19DB34C6B4A4828B7999F: 恢复了吗
openclaw | 2026-05-31T16:18:14.666+00:00 [qqbot] [default] [qqbot:api] <<< Status: 200 OK | TraceId: 465e3af3dc96021499b4de39afbb446d
openclaw | 2026-05-31T16:18:14.685+00:00 [qqbot] [default] Message processing failed: Cannot read properties of undefined (reading 'run')

openclaw | 2026-05-31T16:18:31.782+00:00 [warn]: [ 'no im.chat.access_event.bot_p2p_chat_entered_v1 handle' ]

openclaw | 2026-05-31T16:18:37.820+00:00 [feishu] feishu[default]: received message from ou_xxx in oc_xxx (p2p)
openclaw | 2026-05-31T16:18:37.836+00:00 [feishu] feishu[default]: Feishu[default] DM from ou_xxx: 恢复了吗
openclaw | 2026-05-31T16:18:37.854+00:00 [feishu] feishu[default]: dispatching to agent (session=agent:shu-daily:feishu:direct:ou_xxx)
openclaw | 2026-05-31T16:18:37.859+00:00 [feishu] feishu[default]: failed to dispatch message: TypeError: Cannot read properties of undefined (reading 'run')

Root Cause Analysis

Traced the error to the channel dispatch code in the runtime:

Feishu (monitor.account-CJaXe8-T.js, line ~2870):

const core = getFeishuRuntime();  // runtime is initialized
await core.channel.inbound.run({...});  // core.channel.inbound is undefined

QQBot (monitor-DWJ7KlrE.js, line ~321):

runtime.error?.(`Message processing failed: ${String(err)}`);

The core.channel.inbound property is undefined when the channel adapter tries to dispatch messages. The runtime object itself is initialized (otherwise getFeishuRuntime() would throw "Feishu runtime not initialized"), but the channel.inbound sub-object was not mounted.

Reproduction Steps

  1. Configure QQBot + Feishu channels with agent bindings
  2. Start gateway with --allow-unconfigured flag
  3. Send message to QQBot or Feishu bot
  4. Observe "Message processing failed: Cannot read properties of undefined (reading 'run')"

Configuration

Bindings

[
  {"agentId": "main", "match": {"channel": "qqbot", "accountId": "default"}},
  {"agentId": "shu-daily", "match": {"channel": "feishu", "accountId": "default"}}
]

Agents

  • main: model=xiaomi-coding/mimo-v2.5 (with 6 fallbacks)
  • shu-daily: model=xiaomi-coding/mimo-v2.5 (with 2 fallbacks)

Both agents have valid workspace directories and model configurations.

Observations

  1. Timing: First message arrived 18 seconds after gateway startup — possibly a race condition where channels connect before agent runtimes are fully initialized
  2. Consistency: Both channels (qqbot→main, feishu→shu-daily) fail identically — suggests the issue is in the shared runtime initialization, not channel-specific
  3. Webchat unaffected: Dashboard/webchat sessions work fine, suggesting the core agent runtime IS initialized, but the channel.inbound property is not registered for external channels
  4. --allow-unconfigured flag: Gateway was started with this flag; may affect channel runtime initialization order

Workaround Attempted

Gateway restart without --allow-unconfigured may resolve the issue (not yet tested).

Expected Behavior

External channels (QQBot, Feishu) should successfully dispatch messages to their bound agents after gateway startup.

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 [Bug] QQBot/Feishu channels fail: Cannot read properties of undefined (reading 'run') after startup with --allow-unconfigured