Issue Station
Sign In
Tools hereToolbox

openclaw - ✅(Solved) Fix [Bug] Feishu channel config validation fails after upgrading from v4.5 to v4.8 [2 pull requests, 3 comments, 4 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#63101•Fetched 2026-04-09 07:58:34
View on GitHub
Comments
3
Participants
4
Timeline
8
Reactions
0
Author
jamesMuWBjamesMuWB
Participants
EronFanEronFanjamesMuWBjamesMuWBlaochendeailaochendeaineoliuhuaneoliuhua
Timeline (top)
commented ×3cross-referenced ×2referenced ×2subscribed ×1

Error Message

After upgrading from OpenClaw v4.5 to v4.8, openclaw gateway restart shows the following error: 3. Gateway fails to start with the error above

Root Cause

The v4.8 feishu channel JSON schema no longer allows additional properties. The installs and plugins fields were valid in v4.5 but are no longer recognized in v4.8 schema validation.

Fix Action

Workaround

Delete the installs and plugins fields from the feishu config in channels.feishu. Gateway starts successfully afterward.

PR fix notes

PR #63474: fix(config): strip legacy installs/plugins from channel configs before validation

Description (problem / solution / changelog)

Summary

Fixes #63101

After upgrading from v4.5 to v4.8, openclaw gateway restart fails with:

channels.feishu: invalid config: must NOT have additional properties

when legacy installs and plugins fields are present under channels.feishu.

Root Cause

The Feishu channel config schema (FeishuConfigSchema) uses Zod .strict() mode, which rejects any properties not explicitly declared in the schema. The installs and plugins fields were never valid channel-level properties but could appear in v4.5-era configs due to top-level key nesting.

Fix

Add a legacy config migration (channels.*.stale-top-level-keys) that auto-strips installs and plugins from every channels.* entry (including nested accounts.*) before schema validation runs. The migration:

  • Logs a clear change message so operators know the fields were removed
  • Applies generically to all channels (not just Feishu) since these fields are never valid at the channel level
  • Includes a legacy rule that triggers a warning for channels.feishu specifically

Tests

  • 6 regression tests for the migration in src/config/legacy-migrate.test.ts
  • 3 schema-level rejection tests in extensions/feishu/src/config-schema.test.ts

All 51 tests pass.

Changed files

  • extensions/feishu/src/config-schema.test.ts (modified, +37/-0)
  • src/config/legacy-migrate.test.ts (modified, +110/-0)
  • src/config/legacy.migrations.channels.ts (modified, +86/-0)

PR #63485: fix(feishu): clean deprecated keys in doctor --fix

Description (problem / solution / changelog)

Summary

In v4.8, ackReaction and threadSession were removed from the Feishu channel config schema. However, doctor --fix did not gain a corresponding cleanup step to remove these deprecated keys from existing user configs.

This causes validation failures on upgrade:

channels.feishu: invalid config: must NOT have additional properties

Fix

Add a cleanStaleConfig implementation to the Feishu channel doctor that removes ackReaction and threadSession keys from both top-level and account-level Feishu config.

Changes

  • extensions/feishu/src/doctor.ts: New file implementing feishuDoctor with cleanStaleConfig to remove deprecated keys
  • extensions/feishu/src/doctor.test.ts: Tests covering top-level and account-level cleanup
  • extensions/feishu/src/channel.ts: Wire feishuDoctor into the feishuPlugin

Testing

✓ extension-feishu extensions/feishu/src/doctor.test.ts (6 tests)

Fixes #63101

Changed files

  • extensions/feishu/src/channel.ts (modified, +2/-0)
  • extensions/feishu/src/doctor.test.ts (added, +71/-0)
  • extensions/feishu/src/doctor.ts (added, +97/-0)

Code Example

Problem:
- channels.feishu: invalid config: must NOT have additional properties
RAW_BUFFERClick to expand / collapse

Problem Description

After upgrading from OpenClaw v4.5 to v4.8, openclaw gateway restart shows the following error:

Problem:
- channels.feishu: invalid config: must NOT have additional properties

Environment

  • OpenClaw version: 2026.4.8 (build 9ece252)
  • OS: macOS
  • Channel: feishu

Steps to Reproduce

  1. In v4.5, the channels.feishu config contains installs and plugins fields
  2. Upgrade to v4.8 and run openclaw gateway restart
  3. Gateway fails to start with the error above

Workaround

Delete the installs and plugins fields from the feishu config in channels.feishu. Gateway starts successfully afterward.

Analysis

The v4.8 feishu channel JSON schema no longer allows additional properties. The installs and plugins fields were valid in v4.5 but are no longer recognized in v4.8 schema validation.

Request

  1. Confirm if this is an intentional breaking change or a regression
  2. If intentional, please document the required config changes in CHANGELOG or upgrade guide
  3. If a regression, please fix the validation or revert the change

This issue was submitted by a user who encountered this during upgrade.

extent analysis

TL;DR

Remove or refactor the installs and plugins fields from the channels.feishu config to comply with the updated JSON schema in OpenClaw v4.8.

Guidance

  • Review the OpenClaw v4.8 documentation and CHANGELOG for any mentions of changes to the feishu channel configuration.
  • Verify that removing the installs and plugins fields from the channels.feishu config resolves the error and allows the gateway to start.
  • If the installs and plugins fields are required for functionality, consider reaching out to the OpenClaw community or support for guidance on alternative configurations or workarounds.
  • Test the updated configuration thoroughly to ensure that the removal of these fields does not introduce any unexpected behavior or errors.

Example

No code snippet is provided as the issue does not require a code-level fix, but rather a configuration adjustment.

Notes

The fix assumes that the installs and plugins fields are not critical for the current functionality. If these fields are necessary, further investigation into alternative configurations or waiting for an update from the OpenClaw team may be required.

Recommendation

Apply workaround: Remove the installs and plugins fields from the channels.feishu config, as this has been confirmed to resolve the error and allow the gateway to start in the provided workaround.

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…
#environment variable#network issue#logging issue#authentication issue#prompt issue

Still need to ship something?

×6

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

Back to top recommendations

TRENDING