前置基础OpenClaw 基于 AgentScope 封装企业生产层全部 MD 提示词文件遵循配置分离设计分为全局强制规则类、身份人格基线类、工具/技能类、记忆类、租户/用户私有类、定时调度类六大类所有文件在会话初始化一次性扫描解析按固定顺序拼接 System Prompt优先级高的文件放在 Prompt 最头部模型优先遵守前置约束同时在 Agent 全生命周期各钩子节点动态校验、动态注入。一、完整MD文件清单 全局优先级从最高刚性约束到最低业务柔性提示优先级越高越先写入系统提示词拥有阻断、拦截、覆盖能力低优先级仅做业务引导不能突破高优先级规则。1最高优先级刚性拦截规则不可绕过运行时实时校验rules.md全局硬规则企业安全/合规/预算宪法子代理目录rules.md实例私有规则覆盖全局同维度约束2第二优先级身份基线Agent基础身份全会话常驻IDENTITY.md代理名片、名称、标识、多代理区分SOUL.md人格、价值观、基础行为底线、输出语气范式3第三优先级调度与通信协议多代理/任务流程规范AGENTS.md子代理委派、SFA2A通信协议、会话流程、路由逻辑BOOTSTRAP.md仅首次启动一次性执行执行后自动销毁4第四优先级工具技能契约Toolkit执行标准TOOLS.md全局工具调用规范、参数格式、工具返回解析规则skills/*/SKILL.md分技能专属执行流程目录覆盖优先级工作区本地内置5第五优先级长期记忆管控LongTermMemory读写规范MEMORY.md记忆召回策略、写入脱敏、记忆分层规则memory/日期.md历史会话原始记忆按需向量检索注入不全会话全量加载6第六优先级租户/用户柔性上下文仅微调输出不突破上层约束USER.md租户画像、行业背景、用户偏好、交互习惯7最低优先级定时调度后置钩子HEARTBEAT.md周期巡检、会话收尾、定时归档逻辑不参与首轮Prompt拼装仅生命周期收尾/定时触发优先级核心逻辑高优先级文件可拦截、阻断、熔断低优先级逻辑低优先级仅补充业务细节无法修改 rules.md、IDENTITY 等刚性约束。示例SOUL.md 定义温和沟通语气但 rules.md 命中敏感输入时会直接拦截输出无视 SOUL 的语气要求。二、统一加载完整流程onSessionCreate 会话初始化一次性加载链路框架启动resolveBootstrapContextForRun()解析所有MD分为5步Step1目录扫描 分层读取启动阶段先读取全局 workspace 根目录文件rules.md、IDENTITY.md、SOUL.md、AGENTS.md、TOOLS.md、MEMORY.md、USER.md、HEARTBEAT.md读取当前 Agent 实例私有目录同名MD同名文件覆盖全局配置遍历 skills 目录加载全部 SKILL.md按目录优先级合并工作区技能 本地安装技能 框架内置技能扫描 memory 历史记忆文件构建向量索引不一次性加载全文仅记录检索规则判断是否存在 BOOTSTRAP.md仅全新空会话执行一次Step2规则预编译rules.md 特殊处理rules.md 不直接塞入Prompt同步编译为运行时规则引擎风控正则、工具黑白名单、Token预算计数器、并发上限、合规脱敏规则规则引擎绑定当前会话实例全生命周期实时拦截校验Step3按优先级顺序拼接 System Prompt 基线固定写入顺序头部最高权重[rules.md 约束摘要] → IDENTITY.md → SOUL.md → AGENTS.md → TOOLS.md → MEMORY.md → USER.md → SKILL.md 所有技能文档 → 运行时动态追加当前时间、模型信息、会话资源水位Step4BOOTSTRAP 一次性执行仅新会话若存在 BOOTSTRAP.md执行内部初始化任务知识库预加载、初始记忆写入执行完成自动删除文件后续会话不再加载。Step5缓存会话上下文快照将拼接完成的基础 System Prompt、编译后的规则引擎、技能元数据、记忆索引绑定到当前会话实例会话生命周期内不再重复读取磁盘MD文件支持热重载开关修改MD文件后下一次新建会话生效。三、各MD文件在Agent完整生命周期8大阶段的作用标准生命周期钩子onSessionCreate(会话创建) → onInput(消息入站) → onReasoningStart(推理启动) → LLM推理轮次 → onToolRun(工具执行) → onMemoryRW(记忆读写) → onOutput(结果输出) → onSessionClose(会话销毁)1. rules.md最高优先级硬规则全生命周期全程参与每个钩子均有独立拦截逻辑唯一具备会话熔断能力onSessionCreate加载编译规则引擎初始化Token、工具调用、并发计数器onInput输入前置风控敏感/越权需求直接拦截不进入LLM推理onReasoningStart校验推理预算、会话时长、模型负载触发降级/终止LLM推理后校验模型输出指令禁止调用黑名单工具、限制单轮工具次数onToolRun高危操作二次确认、并发锁校验、技能权限隔离onMemoryRW记忆写入脱敏校验、跨用户记忆隔离、敏感内容禁止入库onOutput输出合规审计、隐私字段屏蔽、违规内容回滚onSessionClose归档所有规则命中/拦截日志重置会话计数器2. IDENTITY.md代理身份名片生效阶段onSessionCreate 一次性加载全会话常驻PromptonSessionCreate注入系统Prompt顶部定义代理唯一标识多子代理场景区分身份onReasoningStart每轮推理携带强制模型保持统一身份口吻避免角色漂移onSubAgentDispatchAGENTS.md触发委派时子代理识别父代理身份规范跨代理消息格式其余阶段无动态拦截能力仅做身份基线约束。3. SOUL.md人格、价值观、基础行为边界生效阶段会话初始化载入每轮推理自动注入onSessionCreate构建代理行为基线定义输出风格、专业边界、诚实性约束禁止编造数据全推理轮次持续约束模型表达逻辑、思考范式仅在未触发 rules.md 违规时生效onOutput规范返回文本结构、语气、行文风格局限无法覆盖 rules.md 安全阻断规则高风险场景直接失效。4. AGENTS.md多代理调度、SFA2A协议、会话流程核心绑定钩子onSessionCreate、onSubAgentDispatch、onSessionCloseonSessionCreate加载子代理委派规则、消息交互协议、任务路由逻辑绑定多代理调度器onInput复杂任务语义路由匹配规则判断是否需要拆分委派子代理onSubAgentDispatch管控子代理创建上限、通信报文格式、权限传递、SFA2A协议编解码onSessionClose定义多代理会话合并归档、跨代理记忆同步规则5. BOOTSTRAP.md一次性初始化脚本仅参与首次onSessionCreate执行后销毁文件后续生命周期完全不生效作用全新空白会话执行初始化动作预加载基础知识库、初始化空白长期记忆、配置初始会话参数一次性执行不再复用。6. TOOLS.md全局Toolkit工具契约绑定钩子onSessionCreate、onToolRunonSessionCreate写入系统Prompt告知模型全部可用工具、入参格式、返回解析方式onReasoningStart引导模型自主判断何时调用工具、如何组装工具参数onToolRun执行前校验工具调用格式标准化工具返回结果解析逻辑对接Toolkit抽象层7. SKILL.md技能专属流程多文件绑定钩子onToolRun、子代理内部推理循环onSessionCreate全部技能文档载入Prompt告知模型各技能适用场景onToolRun触发对应技能时作为专属执行手册约束工具内部分步逻辑子代理会话子代理私有SKILL.md覆盖全局技能流程实现业务定制化能力8. MEMORY.mdLongTermMemory管控规则绑定钩子onSessionCreate、onMemoryRead、onMemoryWriteonSessionCreate写入Prompt定义记忆使用规范何时召回历史记忆、记忆摘要规则onMemoryRead检索长期记忆前约束召回条数、相关性阈值、记忆过滤规则onMemoryWrite写入向量库前执行摘要压缩、自动分类、过期标记规则对接LongTermMemory底层抽象9. memory/日期.md原始历史记忆分片非全会话常驻按需动态注入onReasoningStart根据当前用户输入语义向量检索匹配相关日期记忆片段临时追加至本轮上下文onMemoryWrite本轮对话结束后自动追加当日memory分片文件不会全部加载所有历史文件防止上下文超限、Token浪费。10. USER.md租户/用户私有画像会话初始化载入每轮推理注入优先级极低onSessionCreate注入行业背景、用户习惯、业务专属术语全推理轮次微调输出内容贴合用户场景一旦触发rules.md风控规则该文件约束直接失效无任何拦截、阻断能力仅做业务个性化补充。11. HEARTBEAT.md定时/收尾调度不参与初始化Prompt拼装仅后置周期钩子生效会话运行中定时轮询默认30min执行记忆压缩、会话资源巡检、临时缓存清理onSessionClose会话销毁收尾定义记忆持久化、快照归档、日志导出完整流程四、核心设计价值对应UpClaw企业生产改造目标分层解耦安全规则、身份人格、工具流程、记忆逻辑拆分独立MD业务迭代不用修改底层代码实现配置分离优先级隔离风险rules.md作为独立规则引擎前置拦截高危场景不消耗大模型算力满足企业合规、成本管控生命周期绑定精准管控不同MD绑定专属生命周期钩子按需加载、按需校验避免全量上下文冗余多代理工程化AGENTS.md、SKILL.md统一管控子代理委派与技能执行配套SFA2A协议、并发安全改造可观测可审计rules.md、HEARTBEAT.md全链路埋点所有拦截、工具执行、记忆读写行为完整归档满足企业上线审计要求。