middware-forward-control

按节点配置 源 → 目标 的转发控制台（Next.js）。

• 源：http（POST /api/ingest/<路径> + Bearer）、redis（列表 BRPOP）
• 目标：redis（LPUSH）、dingding（机器人 webhook）

节点日志在 home/logs/channel/node/；进程日志在 home/logs/middware-forward-*.log。

启动（生产）

全局安装后：

npm install -g middware-forward-control
middware-forward-control --console-user admin --console-password '你的密码' -p 3847

• 默认后台运行，打印 PID；标准输出写入 ~/.middware-forward/server.log。
• 运行时与业务数据默认在 ~/.middware-forward（ .middware-forward.runtime.json + data/ + logs/），不写在 npm 全局包目录，升级包不丢配置。
• 停止：middware-forward-control stop（与启动相同的 MIDDWARE_FORWARD_STATE_DIR / --state-dir）。
• 前台调试：加 -f / --foreground。
• 自定义状态目录：--state-dir /path 或环境变量 MIDDWARE_FORWARD_STATE_DIR。

浏览器打开控制台 http://127.0.0.1:3847/console → 配置中心 配节点。详见 middware-forward-control --help。

何时才要配 Redis 相关字段？

仅当该节点启用且源或目标里有一端是 redis 时，该节点必须填 redisUrl（及按需 redisPassword）。HTTP → 钉钉 这类不涉及 Redis 的节点可以不配 Redis。

Redis 列表键为完整 key（如 openclaw:inbound / openclaw:reply）；源、目标里不写 listKey 时会用内置默认，与 OpenClaw Redis 通道约定一致。

HTTP 入站

POST /api/ingest/<接入路径>，头 Authorization: Bearer <该节点密钥>。请求体全文即转发载荷，无嵌套 envelope。校验通过后返回 200（accepted: true），Redis/钉钉转发在进程内异步执行；Redis 列表里存的也是整段 UTF-8 字符串。

本地开发

包目录：npm install、npm run dev -- --console-user admin --console-password devtest → http://127.0.0.1:3847/console。开发模式下状态目录默认为包目录（与 npm run dev 一致）。

注意

--config 里若出现顶层 redisUrl / listKeyPrefix 等，仅用于兼容旧节点迁移，新环境一般不用配。若曾在包目录下有旧 .middware-forward.runtime.json，生产首次启动会自动复制到用户状态目录。