先厘清术语：目录叫 extensions/，但类型/清单/代码里都叫 plugin（OpenClawPlugin*、openclaw.plugin.json、src/plugins/）。本课"扩展"和"插件"是同一个东西。

每个 extensions/<名>/ 含三样：

• openclaw.plugin.json：清单（必需），含 id + configSchema。
• package.json：含 openclaw.extensions: ["./index.ts"] 声明入口。
• index.ts：默认导出注册逻辑。

真实例子 extensions/ollama/（provider 型）：

// openclaw.plugin.json
{ "id": "ollama", "providers": ["ollama"], "configSchema": { ... } }

入口 index.ts 的 register(api) 是扩展往宿主"插能力"的地方。四类真实例子：

// Provider 型（ollama）：注入新模型来源
register(api) { api.registerProvider({ id, label, auth, discovery, wizard, onModelSelected }); }

// Channel 型（telegram）：注入新聊天渠道
register(api) { api.registerChannel({ plugin: telegramPlugin }); }

// Tool 型（llm-task）：注入新工具
export default function register(api) { api.registerTool(createLlmTaskTool(api), { optional: true }); }

// Memory 型（memory-lancedb）：注入工具 + 钩子 + 服务
register(api) {
  api.registerTool({ name: "memory_recall", parameters, execute });
  api.on("before_agent_start", autoRecall);
  api.on("agent_end", autoCapture);
  api.registerService(...);
}

loadOpenClawPlugins()（loader.ts:517-897）五步：

1. 发现 discoverOpenClawPlugins：扫 4 类 root（bundled extensions/、global <configDir>/extensions、workspace <ws>/.openclaw/extensions、config loadPaths）。
2. 清单注册：只读 openclaw.plugin.json（不执行），按来源优先级 config > workspace > global > bundled（用户可覆盖内建）。
3. 逐个加载：去重、解析 enable、memory 槽位互斥（只允许一个 memory 扩展生效）、要求 configSchema。
4. import + register：用 jiti（loader.ts:753）import TS 入口，校验配置，createApi() 后调 register(api)。
5. 激活 activatePluginRegistry → initializeGlobalHookRunner 让钩子生效。

扩展可用 api.on(hookName, handler, {priority}) 挂钩到 Agent 生命周期各点（PluginHookName，types.ts:424-448）：

before_model_resolve   // 换模型（Day 06）
before_prompt_build    // 注入系统提示（Day 09，受策略门控）
before_agent_start / agent_end       // 运行前后（memory 扩展的自动召回/捕获）
llm_input / llm_output               // 模型输入输出
before_tool_call / after_tool_call   // 工具调用前后（before 可 {block:true} 否决！）
message_received / message_sending / message_sent
session_start / session_end / gateway_start / gateway_stop
before_compaction / after_compaction / subagent_*

扩展是"可信计算基"（装了就等于本地代码同权限，Day 17 会展开），但加载器仍有多道门控：

• 路径安全：isUnsafePluginCandidate 拒绝全局可写/越界目录（discovery.ts:250-272）。
• 注册冲突：拒绝重复 provider id、重叠 HTTP 路由。
• 提示注入门控：before_prompt_build 注入受 allowPromptInjection 策略约束（registry.ts:520-567）。
• memory 槽位互斥：多个 memory 扩展只放行一个。

✋ 动手

cd /Users/bitmart/work/codes/github/openclaw
ls extensions/ | head -40
cat extensions/ollama/openclaw.plugin.json
grep -n 'register(api)\|registerProvider\|registerChannel' extensions/ollama/index.ts extensions/telegram/index.ts
grep -n 'PluginHookName' src/plugins/types.ts