🔌 OpenClaw 插件技能

使用 before_prompt_build hook 创建和管理插件

1. 目的和范围

目标

使用 OpenClaw hook 系统创建和管理插件。

使用时机

2. Hook 系统

可用 Hooks

Hook 位置

~/.openclaw/plugins/<plugin-name>/
├── plugin.json       # 插件配置
├── hooks/
│   └── before_prompt_build.js
└── README.md

3. 创建插件

步骤 1：创建目录

mkdir -p ~/.openclaw/plugins/<plugin-name>/hooks

步骤 2：创建 plugin.json

{
  "name": "plugin-name",
  "version": "1.0.0",
  "hooks": [
    {
      "name": "before_prompt_build",
      "file": "hooks/before_prompt_build.js"
    }
  ],
  "description": "插件描述"
}

步骤 3：创建 Hook 文件

// hooks/before_prompt_build.js
module.exports = async function(context) {
  // 添加上下文
  context.systemMessage = "你的系统消息";
  
  // 或修改用户消息
  // context.messages[0].content = "修改后的内容";
  
  return context;
};

4. 注册插件

# 启用插件
openclaw plugin enable <plugin-name>

# 禁用插件
openclaw plugin disable <plugin-name>

# 列出所有插件
openclaw plugin list

5. 插件示例

上下文注入插件

// hooks/before_prompt_build.js
module.exports = async function(context) {
  // 添加时间上下文
  const now = new Date();
  context.systemMessage += `\n当前时间：${now.toISOString()}`;
  
  return context;
};

消息修改插件

module.exports = async function(context) {
  // 检查用户消息
  if (context.messages[0].content.includes("密码")) {
    // 添加安全警告
    context.messages[0].content += "\n\n⚠️ 安全提示：请勿分享敏感信息";
  }
  
  return context;
};

6. 边缘情况

In Altum Per Plugin. 🔌 OpenClaw 插件 v1.0