From 1548728a28b1d1aceec3fe2c96345bdf42faed63 Mon Sep 17 00:00:00 2001 From: Gustavo Madeira Santana Date: Sun, 15 Mar 2026 18:12:31 +0000 Subject: [PATCH] Docs: clarify extension and adapter terms --- .../openclaw-extension-contribution-schema-spec.md | 6 ++++++ .../openclaw-kernel-extension-host-transition-plan.md | 7 +++++++ 2 files changed, 13 insertions(+) diff --git a/docs/.internal/extension-host-migration/openclaw-extension-contribution-schema-spec.md b/docs/.internal/extension-host-migration/openclaw-extension-contribution-schema-spec.md index 240ac0c94e1..62c31a2fe34 100644 --- a/docs/.internal/extension-host-migration/openclaw-extension-contribution-schema-spec.md +++ b/docs/.internal/extension-host-migration/openclaw-extension-contribution-schema-spec.md @@ -641,6 +641,12 @@ Ownership rule: - extensions may own interaction logic and channel-specific rendering details - the host owns namespace registration, dedupe, callback routing, approval persistence, and binding policy +Terminology clarification: + +- plugin-specific behavior lives in the extension package +- transport-specific runtime behavior lives in that extension's `adapter.runtime` contribution +- the kernel only consumes generic contracts and must not learn Telegram-, Discord-, or plugin-specific behavior directly + ### `capability.rpc` Represents internal callable methods that are not agent tools. diff --git a/docs/.internal/extension-host-migration/openclaw-kernel-extension-host-transition-plan.md b/docs/.internal/extension-host-migration/openclaw-kernel-extension-host-transition-plan.md index e167f3405e4..964569d480d 100644 --- a/docs/.internal/extension-host-migration/openclaw-kernel-extension-host-transition-plan.md +++ b/docs/.internal/extension-host-migration/openclaw-kernel-extension-host-transition-plan.md @@ -1004,6 +1004,13 @@ Decision: In this model, a channel is not a special plugin subtype. It is an adapter contribution plus related optional descriptors. +Terminology clarification: + +- the extension package is the installable unit +- a contribution is a normalized runtime or host surface emitted by that package +- transport-specific runtime behavior belongs in the package's `adapter.runtime` contribution +- the kernel remains generic and should not own product-specific behavior for any one extension or channel + An adapter runtime contribution should include only transport behavior: - normalize ingress events