Skip to content

fix(openclaw): repackage plugin for the 2026.6 loader dialect#339

Merged
plind-junior merged 2 commits into
testfrom
fix/openclaw-plugin-manifest
Jul 2, 2026
Merged

fix(openclaw): repackage plugin for the 2026.6 loader dialect#339
plind-junior merged 2 commits into
testfrom
fix/openclaw-plugin-manifest

Conversation

@plind-junior

Copy link
Copy Markdown
Collaborator

the old openclaw.plugin.json spoke a manifest dialect current openclaw no longer parses: installs of the linked repo failed before load (the loader hard-requires id + configSchema, routes any dir containing an openclaw.plugin.json away from the bundle path, and needs a package.json openclaw.extensions pointer to find the entry module). every old-dialect field the manifest relied on — mcpServers, contracts, family, shared_deps, openclaw.* — is silently ignored by the current parser.

rewrite the packaging for the current contract, verified against a real openclaw 2026.6.11 install:

  • openclaw.plugin.json: id + json-schema configSchema + kind: context-engine + version (synced with pyproject) + skills as SKILL.md directories under adapters/openclaw/skills/ (mirrored from the claude-code commands; a sync test keeps them identical). the kb.* mcp server moves to deployment config (openclaw mcp add).
  • package.json (new, loader-facing only): openclaw.extensions entry pointer + openclaw.compat.pluginApi floor.
  • engine id renamed vouch-context -> vouch to equal the plugin id: the installer auto-binds plugins.slots.contextEngine to the plugin id while resolveContextEngine looks the slot value up by engine id, so distinct ids quarantined the engine and silently fell back to openclaw's legacy engine.
  • vouch openclaw-rpc: json-serialize datetimes in wire payloads. contextPack.generated_at crashed json.dumps on every assemble that found a kb — found by running a live agent turn against the linked plugin, where openclaw quarantined the engine for the process.
  • tests: manifest sync tests rewritten for the new dialect (id alignment, three-way version sync, publishable skill dirs, dead dialect fields rejected); new tier-2 e2e (tests/test_openclaw_plugin_load_real.py, skipped without the openclaw cli) links the repo into an isolated profile and asserts import, engine registration, slot auto-bind, skill publication, and a clean plugins doctor; new stdio round-trip regression test for the datetime fix.

verified live: plugins install --link of this repo, inspect --runtime (imported, loaded, contextEngineIds ["vouch"]), four skills ready, plugins doctor clean, and a full embedded agent turn where assemble() ran against a real kb with zero context-engine quarantines.

What changed

Why

What might break

VEP

Tests

  • make check passes locally (lint + mypy + pytest)
  • New / changed behaviour has a test
  • CHANGELOG.md updated under ## [Unreleased]

the old openclaw.plugin.json spoke a manifest dialect current openclaw
no longer parses: installs of the linked repo failed before load (the
loader hard-requires id + configSchema, routes any dir containing an
openclaw.plugin.json away from the bundle path, and needs a
package.json openclaw.extensions pointer to find the entry module).
every old-dialect field the manifest relied on — mcpServers, contracts,
family, shared_deps, openclaw.* — is silently ignored by the current
parser.

rewrite the packaging for the current contract, verified against a real
openclaw 2026.6.11 install:

* openclaw.plugin.json: id + json-schema configSchema + kind:
  context-engine + version (synced with pyproject) + skills as
  SKILL.md directories under adapters/openclaw/skills/ (mirrored from
  the claude-code commands; a sync test keeps them identical). the
  kb.* mcp server moves to deployment config (openclaw mcp add).
* package.json (new, loader-facing only): openclaw.extensions entry
  pointer + openclaw.compat.pluginApi floor.
* engine id renamed vouch-context -> vouch to equal the plugin id:
  the installer auto-binds plugins.slots.contextEngine to the plugin
  id while resolveContextEngine looks the slot value up by engine id,
  so distinct ids quarantined the engine and silently fell back to
  openclaw's legacy engine.
* vouch openclaw-rpc: json-serialize datetimes in wire payloads.
  contextPack.generated_at crashed json.dumps on every assemble that
  found a kb — found by running a live agent turn against the linked
  plugin, where openclaw quarantined the engine for the process.
* tests: manifest sync tests rewritten for the new dialect (id
  alignment, three-way version sync, publishable skill dirs, dead
  dialect fields rejected); new tier-2 e2e
  (tests/test_openclaw_plugin_load_real.py, skipped without the
  openclaw cli) links the repo into an isolated profile and asserts
  import, engine registration, slot auto-bind, skill publication, and
  a clean plugins doctor; new stdio round-trip regression test for the
  datetime fix.

verified live: plugins install --link of this repo, inspect --runtime
(imported, loaded, contextEngineIds ["vouch"]), four skills ready,
plugins doctor clean, and a full embedded agent turn where assemble()
ran against a real kb with zero context-engine quarantines.
@coderabbitai

coderabbitai Bot commented Jul 2, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: bdbefb5e-d6b0-4d6a-ae63-6b83e0cba155

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/openclaw-plugin-manifest

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added docs documentation, specs, examples, and repo guidance adapters agent host adapters and install manifests openclaw openclaw integration tests tests and fixtures size: L 500-999 changed non-doc lines labels Jul 2, 2026
# Conflicts:
#	CHANGELOG.md
#	openclaw.plugin.json
@plind-junior plind-junior merged commit 258947a into test Jul 2, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adapters agent host adapters and install manifests docs documentation, specs, examples, and repo guidance openclaw openclaw integration size: L 500-999 changed non-doc lines tests tests and fixtures

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant