20260313_openclaw文档_投研用

# OpenClaw 文档总览## 总体定位`D:\openclaw` 不是单一项目的普通文档目录，而是一套围绕多代理协作、代码翻译、代码验证、未来函数检测和自动策略迭代构建的“工作流知识库 + 组件库 + 实例库”。当前文档资产主要由以下几类文件组成：- `md`：给人阅读的说明文档- `json`：给程序和大模型读取的结构化描述- `csv`：对外暴露参数表- `xmind`：任务拆分、结构设计和脑图草稿- `svg`：流程图和结构图## 主要功能域### 1. 代理角色定义目录：- `D:\openclaw\agents设置`作用：- 定义不同子代理的职责边界、输入输出和协作方式- 为多代理工作流提供稳定角色分工代表文件：- [code_reader_python_详细描述.md](/d:/openclaw/agents设置/20260305/code_reader_python_详细描述.md)- [code_translater_mat2py_详细描述.md](/d:/openclaw/agents设置/20260305/code_translater_mat2py_详细描述.md)- [agents_structure.json](/d:/openclaw/agents设置/20260305/agents_structure.json)典型角色包括：- `code_reader_python`- `code_reader_matlab`- `code_translater_mat2py`### 2. 全局研究与执行约束目录：- `D:\openclaw\document`作用：- 规定研究输出、评价规则、未来数据使用边界和执行限制- 为所有下游 workflow 提供统一协议层代表文件：- [agent.md](/d:/openclaw/document/agent.md)- [RESEARCH_PROTOCOL.md](/d:/openclaw/document/RESEARCH_PROTOCOL.md)这里定义的内容包括：- 允许修改的代码范围- 数据目录只读约束- 固定评价指标- 信号和执行时间对齐要求- 严格的无未来数据规则### 3. 可复用 workflow 组件目录：- `D:\openclaw\workflow组件`作用：- 把常见任务抽象成可复用组件- 同时提供人读版说明和机器读版协议当前主要有三条组件线：#### 3.1 未来函数检测目录：- `D:\openclaw\workflow组件\未来函数检测`作用：- 面向批处理量化脚本做最小单元切分- 对每个单元执行未来函数比较- 支持失败后自动修复尝试和结果导出代表文件：- [future_function_workflow_spec.md](/d:/openclaw/workflow组件/未来函数检测/future_function_workflow_spec.md)- [future_function_workflow_spec.json](/d:/openclaw/workflow组件/未来函数检测/future_function_workflow_spec.json)- [future_function_workflow_parameters_cn.csv](/d:/openclaw/workflow组件/未来函数检测/future_function_workflow_parameters_cn.csv)#### 3.2 代码验证目录：- `D:\openclaw\workflow组件\代码验证`作用：- 负责最小单元切分、Python 单元测试验证、跨语言数值对齐验证，以及它们的上层编排代表文件：- [openclaw_validation_orchestration_workflow_cn.md](/d:/openclaw/workflow组件/代码验证/openclaw_validation_orchestration_workflow_cn.md)- [openclaw_minimal_unit_decomposition_workflow_cn.md](/d:/openclaw/workflow组件/代码验证/openclaw_minimal_unit_decomposition_workflow_cn.md)- [openclaw_cross_language_alignment_validation_integration_cn.md](/d:/openclaw/workflow组件/代码验证/openclaw_cross_language_alignment_validation_integration_cn.md)- [validation_component_parameters_cn.csv](/d:/openclaw/workflow组件/代码验证/validation_component_parameters_cn.csv)#### 3.3 自动策略迭代目录：- `D:\openclaw\workflow组件\自动策略迭代`作用：- 围绕 notebook、可变策略单元和长期服务进程构建自动策略迭代闭环代表文件：- [codex_strategy_iteration_workflow.md](/d:/openclaw/workflow组件/自动策略迭代/codex_strategy_iteration_workflow.md)- [codex_strategy_iteration_workflow.json](/d:/openclaw/workflow组件/自动策略迭代/codex_strategy_iteration_workflow.json)- [iteration_server.md](/d:/openclaw/workflow组件/自动策略迭代/iteration_server.md)- [iteration_server.json](/d:/openclaw/workflow组件/自动策略迭代/iteration_server.json)- [minimal_strategy_iteration_example.md](/d:/openclaw/workflow组件/自动策略迭代/minimal_strategy_iteration_example.md)- [minimal_strategy_iteration_example.json](/d:/openclaw/workflow组件/自动策略迭代/minimal_strategy_iteration_example.json)它当前抽象的是：- `main_script.ipynb`- `unit_revise_func.py`- `iteration_server.py`形成的闭环是：```textCodex 修改 unit_revise_func.py  ->iteration_server 调用 notebook cell4  ->比较样本集和验证集指标  ->决定接受或回滚```### 4. 具体任务实例目录：- `D:\openclaw\具体workflow`作用：- 把上面的抽象组件落成具体项目、具体日期、具体任务版本主要子目录：- `代码翻译`- `自动策略投研`- `无具体指定`代表文件：- [20260306_代码翻译工作流_摘要.md](/d:/openclaw/具体workflow/代码翻译/20260306/20260306_代码翻译工作流_摘要.md)- [策略自动迭代prompt问答.md](/d:/openclaw/具体workflow/自动策略投研/策略自动迭代prompt问答.md)- [codex策略迭代流程图.svg](/d:/openclaw/具体workflow/自动策略投研/codex策略迭代流程图.svg)- [20260312_研究任务拆分2.xmind](/d:/openclaw/具体workflow/无具体指定/20260312_研究任务拆分2.xmind)这一层的价值是：- 保存某次任务的人工需求- 保存从需求到组件再到实例的映射关系- 给后续相似任务提供可复用参考### 5. 顶层辅助文件根目录文件：- [相关路径.txt](/d:/openclaw/相关路径.txt)- [问题列表.txt](/d:/openclaw/问题列表.txt)- [策略自动迭代.md](/d:/openclaw/策略自动迭代.md)作用：- 记录共享路径约定- 记录历史问题和任务描述- 保存对话归档或临时知识沉淀## 当前文档库的核心功能总结可以把整个 `D:\openclaw` 概括成四层：1. 角色层：定义谁来做事2. 协议层：定义做事时必须遵守什么规则3. 组件层：定义常见任务如何被标准化复用4. 实例层：定义这些组件如何在具体项目中落地这套结构的主要目标不是单次交付，而是让：- 多代理协作可复用- 工作流可以机器读取- 具体任务可以持续沉淀- 相似任务可以快速复刻## 结构图```textD:\openclaw|+-- agents设置|   ||   +-- 角色定义|       |- code_reader_python|       |- code_reader_matlab|       |- code_translater_mat2py|       |- agents_structure.json|+-- document|   ||   +-- 全局规则|       |- agent.md|       |- RESEARCH_PROTOCOL.md|+-- workflow组件|   ||   +-- 未来函数检测|   |   |- future_function_workflow_spec.md/json|   |   |- future_function_workflow_parameters_cn.csv|   ||   +-- 代码验证|   |   |- 最小单元切分|   |   |- Python 单元测试验证|   |   |- 跨语言数值对齐验证|   |   |- 上层编排 workflow|   ||   +-- 自动策略迭代|       |- codex_strategy_iteration_workflow.md/json/csv|       |- iteration_server.md/json|       |- minimal_strategy_iteration_example.md/json|       |- notebook_unit_split_principles.md/json|       |- 人工需求 xmind/svg|+-- 具体workflow|   ||   +-- 代码翻译|   |   |- 20260306 实例|   |   |- 20260310 实例|   ||   +-- 自动策略投研|   |   |- 策略自动迭代流程图|   |   |- iteration_server 结构图|   |   |- prompt 问答沉淀|   ||   +-- 无具体指定|       |- 研究任务拆分 xmind|+-- 顶层辅助文件    |- 相关路径.txt    |- 问题列表.txt    |- 策略自动迭代.md    |- openclaw_docs_overview.md```## 一句话总结`D:\openclaw` 的本质是一套围绕“代理角色定义 + 全局研究约束 + 可复用 workflow 组件 + 具体任务实例”组织起来的自动化研发知识库。