message-injector消息注入器

OpenClaw plugin that prepends custom text to every user message before it reaches the agent. Use for: enforcing memory_search before replies, injecting system-level instructions, adding persistent reminders to every conversation turn. Install as a workspace extension — works on all channels including WebChat, Telegram, Slack, etc.

作者: admin | 来源: ClawHub

Message Injector

A lightweight OpenClaw workspace extension that uses the before_agent_start hook to inject custom text into every user message via prependContext.

Installation

1. Create the extension directory

CODEBLOCK0

2. Copy the plugin files

Copy scripts/index.ts and scripts/openclaw.plugin.json to the extension directory:

CODEBLOCK1

3. Add configuration

Add the following to ~/.openclaw/openclaw.json under plugins.entries:

CODEBLOCK2

4. Restart Gateway

CODEBLOCK3

Configuration

Field	Type	Default	Description
INLINECODE6	boolean	INLINECODE7	Enable or disable the injector
INLINECODE8

string | "" | Text to prepend before every user message |

Example Use Cases

Force memory search:
CODEBLOCK4

Add persistent context:
CODEBLOCK5

Inject safety rules:
CODEBLOCK6

How It Works

The plugin registers a before_agent_start hook. When triggered, it returns { prependContext: prependText } which OpenClaw prepends to the user's message before the agent processes it. This is a hard injection at the Gateway level — the agent cannot skip or ignore it.

Source Code

GitHub: https://github.com/Harukaon/openclaw-message-injector

消息注入器

一个轻量级的OpenClaw工作区扩展，利用beforeagentstart钩子通过prependContext将自定义文本注入到每条用户消息中。

安装

1. 创建扩展目录

bash
mkdir -p ~/.openclaw/workspace/.openclaw/extensions/message-injector

2. 复制插件文件

将scripts/index.ts和scripts/openclaw.plugin.json复制到扩展目录：

bash
cp scripts/index.ts ~/.openclaw/workspace/.openclaw/extensions/message-injector/
cp scripts/openclaw.plugin.json ~/.openclaw/workspace/.openclaw/extensions/message-injector/

3. 添加配置

在~/.openclaw/openclaw.json的plugins.entries下添加以下内容：

json
message-injector: {
enabled: true,
config: {
enabled: true,
prependText: 在此处输入您的自定义文本
}
}

4. 重启网关

bash
openclaw gateway restart

配置

字段	类型	默认值	描述
enabled	布尔值	true	启用或禁用注入器
prependText

字符串 | | 在每条用户消息前添加的文本 |

使用示例

强制记忆搜索：
json
prependText: [⚠️ 回答前必须先执行 memory_search 检索相关记忆，禁止凭印象回答]

添加持久上下文：
json
prependText: [当前项目：my-app | 技术栈：React + Node.js | 部署环境：AWS]

注入安全规则：
json
prependText: [规则：删除文件前务必验证路径。未经确认不得执行 rm -rf 命令。]

工作原理

该插件注册了一个beforeagentstart钩子。触发时，它会返回{ prependContext: prependText }，OpenClaw会在代理处理用户消息前将其添加到消息开头。这是在网关层面的硬性注入——代理无法跳过或忽略该内容。

源代码

GitHub：https://github.com/Harukaon/openclaw-message-injector

message-injector消息注入器