Skip to content

Document why channelEnvVars is retained despite the deprecation warning - #5

Merged
Haakam21 merged 1 commit into
mainfrom
document-channel-env-vars
Jul 23, 2026
Merged

Document why channelEnvVars is retained despite the deprecation warning#5
Haakam21 merged 1 commit into
mainfrom
document-channel-env-vars

Conversation

@Haakam21

Copy link
Copy Markdown
Contributor

Summary

Adds a comment (no functional change) in scripts/build-manifest.mjs explaining why the generated manifest keeps channelEnvVars, even though ClawHub's Plugin Inspector flags it with a channel-env-vars deprecation warning at publish time.

Why

Investigated the actual inspector (@openclaw/plugin-inspector@0.3.18) and host (openclaw@2026.7.2-beta.3):

  • The channel-env-vars finding fires unconditionally whenever channelEnvVars is non-empty — there is no "covered by setup metadata" check, and an openclaw.setupEntry does not suppress it. The only way to clear it is to remove the field.
  • But on our supported range (peer floor >=2026.7.2-beta.3, which is currently the newest published OpenClaw), channelEnvVars is the only source resolveChannelEnvVars reads. It powers isStaticallyChannelConfigured (detecting the channel as configured from AGENTMAIL_API_KEY in the env) and the env-shell expected-keys surface.
  • No setup-metadata replacement path has shipped in any release yet, so removing the field would regress env-driven setup with no upside.

The warning is therefore an expected, forward-looking deprecation notice — not a defect. The comment records this and the exact condition under which the field can be removed (once the minimum supported OpenClaw reads channel env names from the newer setup model, at which point the floor is raised to match).

Verification

  • node scripts/build-manifest.mjs --checkopenclaw.plugin.json is up to date (comment does not change generated output).

🤖 Generated with Claude Code

The Plugin Inspector's channel-env-vars finding fires unconditionally on the
presence of this field. On our supported OpenClaw range it is still the only
source for env-driven channel-configured detection, so removing it would
regress setup with no upside. Comment records why it stays and the exact
condition under which it can be removed. No change to the generated manifest.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Haakam21
Haakam21 merged commit 649b8db into main Jul 23, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant