• 2026-03-20
  • 官方公告

OpenClaw怎么可能没痛点

一、为什么你需要关注插件

大多数 OpenClaw 用户在实现自定义功能时，第一反应是编写 Skill 或注册自定义 Tool。这两种方式简单直接，但在面对需要深度介入 Agent 生命周期的场景时，往往力不从心。

1.1 三种扩展机制对比

维度

Skill

Tool

Plugin

本质

Markdown 文本，注入到系统提示词

一个可被 AI 调用的函数

完整的扩展程序，可访问 Agent 全生命周期

执行时机

系统提示词构建阶段被注入

AI 主动决策调用

可以借助“钩子”在任意生命周期中执行

能否主动介入

否，只能被动提供指令

否，依赖 AI 判断是否调用

是，依赖钩子机制主动介入

适用场景

行为指导、回答风格、领域知识补充

搜索、计算、文件操作等工具性任务

记忆管理、知识注入、数据持久化、多 Agent 协作

1.2 关键差异：被动 vs 主动

当你的需求是「在生命周期中某个阶段总应该自动发生某件事」（而非等 AI 判断后才执行），插件是唯一选择。

1.3 应用插件的常见场景

• 需要在每次对话开始前自动检索和注入外部知识（RAG）

• 需要在每次对话结束后自动提取和持久化记忆

• 需要替换 OpenClaw 的默认行为（如替换内置记忆系统）

• 需要在多个 Agent 之间共享数据管道

二、深入理解 OpenClaw 插件

2.1 核心概念

OpenClaw 插件是一个 npm 包（或本地目录），包含以下核心文件：

my-plugin/

├── package.json            # npm 包元数据 + openclaw.extensions 入口声明

├── openclaw.plugin.json    # 插件清单（id、描述、配置模式）

├── index.ts                # 插件入口，导出 { id, register } 对象

└── ...                     # 其他源码文件

插件清单 (openclaw.plugin.json) 定义了插件的身份和配置模式：

{

  "id": "my-plugin",

  "name": "My Plugin",

  "description": "Does something useful",

  "configSchema": {

    "type": "object",

    "required": ["apiKey"],

    "properties": {

      "apiKey": { "type": "string" }

    }

  }

}

包声明 (package.json) 中的 openclaw.extensions 字段告诉 OpenClaw 从哪个文件加载插件逻辑：

{

  "openclaw": {

    "extensions": ["./index.ts"]

  }

}

2.2 插件在 Agent 生命周期中的作用点

OpenClaw 的 Agent 生命周期是一条从消息接收到回复发送的管线。插件可以通过“钩子（Hooks）”在管线的关键节点介入。OpenClaw 共提供 24 个钩子，覆盖 Agent 运行、消息处理、工具调用、会话管理等全部阶段。

核心生命周期流程