rlm-controller

🧠 安全可控的超长文本智能分析引擎

OpenClaw官方RLM框架,通过白名单脚本与安全策略实现超长文本的智能分片处理,专为大规模文档分析提供可控的递归子调用能力。

收藏
6k
安装
2.2k
版本
v1.2.0
CLS 安全性认证2026-05-13
点击查看完整报告 >

使用说明

核心用法

RLM Controller 是 OpenClaw 生态系统中专门处理超长输入(50k+字符)的 RLM(Recursive Language Model)风格控制器。其核心工作流程分为五个阶段:首先通过 rlm_ctx.py 将超大输入存储为外部上下文文件,随后利用 rlm_auto.py 生成智能分析计划,接着由 rlm_async_plan.py 创建异步批处理任务,再通过 sessions_spawn 发起受控子调用,最后在根会话中聚合结构化结果。该技能内置七种专用脚本,覆盖上下文管理、计划生成、批量调度、工具调用格式化及日志追踪等全链路功能。

显著优点

该技能的最大优势在于其安全优先的架构设计。所有辅助脚本均预置在 scripts// 目录中,运行时仅允许调用白名单内的脚本,彻底杜绝任意代码执行风险。硬编码的递归深度限制(最大为1)和多重资源上限(子调用≤32、切片≤16k字符、批次≤8、分块≤5000)有效防止资源耗尽攻击。路径遍历防护采用 .. 检测与 os.path.realpath 双重验证,输入内容始终作为数据处理而非指令执行。此外,完整的 JSONL 操作日志、详尽的策略文档(docs/policy.md)以及自动化清理机制(cleanup.sh)共同构成了企业级的可审计性与可维护性。

潜在缺点与局限性

尽管安全设计出色,该技能仍存在一定使用门槛。首先,配置复杂度较高:用户需深入理解 docs/policy.md 中的阈值设定才能优化性能,默认参数可能不适用于所有场景。其次,异步调试困难:非阻塞的 sessions_spawn 机制虽提升效率,但子调用失败时的错误追踪依赖 rlm_trace_summary.py,对新手不够友好。第三,功能边界受限:最大递归深度为1意味着无法处理需要深层嵌套分析的任务,复杂推理链需人工拆解。最后,生态依赖性强:作为 OpenClaw 专属技能,其工具调用格式(如 sessions_spawn)与其他 Agent 框架不兼容,迁移成本较高。

适合的目标群体

该技能主要面向三类用户:企业级数据分析师(需处理海量日志、多文件代码库审计)、科研文献处理人员(长论文综述、大规模数据集摘要)以及AI 系统架构师(构建安全可控的长文本处理流水线)。特别适合对数据安全有严格合规要求的金融、医疗、法律行业,因其完整的安全文档与审计日志可满足监管审查需求。不建议个人轻量级用户直接使用,除非其明确需要处理超出常规上下文窗口的极端场景。

使用风险

常规风险主要集中在性能与依赖层面。大规模并行子调用可能触发 OpenClaw 平台的速率限制,导致任务队列积压;临时文件若未正确配置 CLEAN_RETENTION 策略,可能引发磁盘空间泄漏。此外,该技能默认允许模型自主调用(未设置 disableModelInvocation: true),虽受策略约束,但在高敏感环境中建议显式关闭自动调用以获取人工确认。最后,所有子调用均为只读设计,无法修改原始数据,这在提升安全性的同时也限制了实时反馈类应用场景。

安全解读

核心用法

rlm-controller 是 OpenClaw 生态中的长上下文处理中枢,专为超出常规上下文窗口的大规模输入设计。其核心工作流分为五步:首先通过 rlm_ctx.py 将输入存储为外部上下文文件;随后 rlm_auto.py 生成智能切片计划;rlm_async_plan.py 将任务拆分为可并行处理的批次;通过 sessions_spawn 触发子代理执行;最终在根会话聚合结构化结果。

该 skill 捆绑 7 个可执行脚本与完整安全文档,零第三方依赖,仅使用 Python 标准库。关键脚本功能明确:rlm_ctx.py 负责存储、预览、搜索与分块;rlm_async_spawn.py 管理子调用清单;rlm_emit_toolcalls.py 生成经过 safelist 验证的工具调用 JSON。

显著优点

安全架构行业领先:硬编码边界限制(最大 32 个子调用、16k 字符/切片、递归深度 1),所有约束在代码层强制执行,非提示工程层面的软性建议。通过 CLS-Certify v2.1.0 完整扫描,六项安全维度均达 90+ 分,总评 S+ 级。

零依赖纯净运行:完全基于 Python 标准库,无 CVE 风险、无供应链攻击面、无外部 API 调用,依赖审计维度满分通过。

策略透明可控:所有限制参数集中定义于 docs/policy.md,支持运营人员审计调整;docs/security_checklist.md 提供运行前中后的完整检查清单。

潜在局限

学习曲线较陡:七脚本协同工作流对新手不够直观,需理解 OpenClaw 子代理模型与会话管理机制。

自主调用默认开启disableModelInvocation 默认为 false,模型可能在无显式确认下调用 skill。虽然操作边界已硬化,但高安全环境需手动启用确认模式。

子代理能力受限:受 OpenClaw 架构约束,子代理无法进一步 spawn 子代理,某些深度嵌套分析场景需额外编排。

适合人群

  • DevOps/SRE 处理 GB 级日志分析
  • 安全研究员审计大规模代码库
  • 数据工程师处理密集数据集
  • 企业合规团队需要完整审计追踪

常规风险

已识别的两项低风险(RISK-001/002)均通过技术机制与文档透明化缓解:subprocess.check_output 仅限同目录 safelisted 脚本调用;自主调用行为在 SKILL.md 与安全文档中明确披露。建议高安全环境启用 disableModelInvocation: true,并遵循运营检查清单。

rlm-controller 内容

.github文件夹
docs文件夹
scripts文件夹
手动下载zip · 28.1 kB
FUNDING.ymltext/plain
请选择文件