OpenClaw 系统架构详解

第5部分：Plugins (插件)

🔌 Plugins (插件) - 系统扩展

职责

• 扩展 OpenClaw 核心功能
• 添加新的聊天频道支持
• 提供额外的模型提供商
• 实现自定义钩子和拦截器

插件类型

• Channel Plugins - 添加新的聊天频道（Mattermost、Matrix 等）
• Provider Plugins - 添加新的 AI 模型提供商
• Runtime Plugins - 在代理循环中注入自定义逻辑

钩子系统

插件通过钩子系统与 OpenClaw 核心交互：

内部钩子（Gateway 钩子）

• agent:bootstrap - 构建引导文件前
• 命令钩子 - /new, /reset, /stop 等

插件钩子（代理 + 网关生命周期）

• before_model_resolve - 模型解析前
• before_prompt_build - 提示构建前
• before_agent_start - 代理启动前
• before_agent_reply - 代理回复前
• agent_end - 代理结束后
• before_compaction - 压缩前
• after_compaction - 压缩后
• before_tool_call - 工具调用前
• after_tool_call - 工具调用后
• message_received - 消息接收
• message_sending - 消息发送中
• message_sent - 消息发送后
• session_start - 会话开始
• session_end - 会话结束
• gateway_start - 网关启动
• gateway_stop - 网关停止

钩子决策规则

• before_tool_call: { block: true } 终止并阻止低优先级处理器
• before_tool_call: { block: false } 无操作，不清除先前的阻止
• before_install: { block: true } 终止并阻止低优先级处理器
• message_sending: { cancel: true } 终止并阻止低优先级处理器

插件开发

插件开发需要：

• 定义插件清单（manifest）
• 实现入口点（entrypoints）
• 注册钩子处理器
• 提供必要的配置

插件安装

openclaw plugins install 
openclaw plugins list
openclaw plugins remove