Litmus — 并行自主机器学习研究智能体

Litmus 启动多个 OpenClaw 子智能体，在你的 GPU 上整夜开展实验。每个子智能体在共享实验室仓库中运行于其独立的 git 分支上——每次实验均对应一次提交，各智能体可相互读取代码、挑选（cherry-pick）突破性成果，并随时基于全局最优结果继续演进。

经验证的有效技术持续沉淀至 技能库（~/.litmus/shared/skills/）。合成器（Synthesizer） 每日凌晨 04:00 运行，将集体知识提炼为可复用技能，并生成次日的研究议程。总监（Director） 每两小时运行一次，用于协调工作者、在停滞时触发 Compass Reset，并组织跨智能体的知识迁移。

为何它不止于自动研究（autoresearch）：

• Git 工作树（worktree）：所有智能体共享同一仓库，各自运行于独立分支——完整保留实验历史，支持 cherry-pick 及跨智能体代码审查，命令示例：git -C ~/.litmus/repo log --all
• 技能库：已验证技术持久化并持续复利积累——智能体无需重复发现已有成果
• 合成器：将整夜记录提炼为可复用技能与研究议程
• Compass Reset：总监检测停滞状态，并依据技能缺口强制执行结构化转向
• 双阶段实验预算机制：先执行耗时约 90 秒的快速验证，再决定是否投入完整训练周期
• 结构化尝试记录：每个实验生成一份 JSON 文件，存于 shared/attempts/ 目录，支撑深度分析
• 闲暇模式（03:00–06:00）：工作者阅读论文、撰写“登月级”假设（moonshot hypotheses）、识别研究空白
• 晨间简报：08:00 将研究叙事推送至你的聊天界面

所有组件均为原生 OpenClaw 子智能体，不依赖任何外部进程，亦无 PID 文件。

首次配置

推荐方式：向你的 OpenClaw 智能体发起指令（将启动引导式入门对话）：

“安装 https://clawhub.ai/kuberwastaken/litmus 并为我的机器完成配置”

完整入门指南见：{baseDir}/references/onboarding.md —— 请优先阅读该文件。

或手动配置：

git clone https://github.com/kuberwastaken/litmus ~/.litmus
bash ~/.litmus/scripts/setup.sh

该流程将克隆 Karpathy 的训练框架，于 ~/.litmus/repo/ 构建共享实验室 Git 仓库，通过 uv 安装 Python 依赖，并下载约 1 GB 的训练数据。请耐心等待执行完成。

启动研究

1 — 准备工作区（创建 Git 工作树）

bash {baseDir}/scripts/prepare-agents.sh --agents 4 --templates architecture,optimizer,general,general

在 ~/.litmus/agents/ 下创建 Git 工作树，每个工作树对应 ~/.litmus/repo/ 中的一条独立分支。由于使用共享实验室 Git 仓库，所有智能体的实验对彼此即时可见：

git -C ~/.litmus/repo log --all --oneline --graph

2 — 启动研究子智能体

sessions_spawn
  task: "读取当前目录下的 program.md 并无限循环执行研究流程。"
  runtime: "subagent"
  mode: "session"
  agentId: "litmus-worker-arch-1"
  cwd: "~/.litmus/agents/arch-1"

为每个智能体重复上述操作后，执行：

sessions_yield message: "研究智能体已启动。新发现将第一时间通知你。"

模板类型：architecture · optimizer · regularization · general
完整模板说明见：{baseDir}/references/templates/

3 — 启动总监层（Director Layer）

bash {baseDir}/scripts/setup-cron.sh --timezone "Your/Timezone"

注册 6 个定时任务（cron job）：

所有时间均可在入门配置过程中自定义——配置智能体会提供默认值，并询问你希望调整哪些项。常见预设方案包括：
• 夜猫子模式（01:00 / 02:00 / 04:00 / 07:00）
• 早起鸟模式（23:00 / 00:30 / 02:00 / 05:30）
• 强度模式（总监每小时运行一次）
可通过 scripts/setup-cron.sh 的如下参数传入自定义时间：--leisure-start、--synthesizer-time、--dawn-time、--digest-time、--director-hours、--watchdog-minutes。

智能体管理

状态查询（实验次数、最佳 val_bpb、Git 树状图）：

bash {baseDir}/scripts/status.sh

排行榜（跨智能体，基于 shared/attempts/ 中的 JSON 数据）：

bash {baseDir}/scripts/results.sh --top 10
bash {baseDir}/scripts/results.sh --agent arch-1  # 单个智能体

完整实验室 Git 历史（所有智能体实验以树状结构呈现）：

git -C ~/.litmus/repo log --all --oneline --graph

查看任意一次实验详情：

git -C ~/.litmus/repo show   # 查看变更内容
cat ~/.litmus/shared/attempts/.json  # 查看指标数据

动态引导（Steer）（运行中重定向，无需重启）：

subagents action: "steer"  target: "litmus-worker-arch-1"
  message: "停止优化 depth。检出 opt-2 分支中的最优提交，并将其 LR 与 DEPTH=10 组合应用。"

终止运行：

subagents action: "kill"  target: "all"

智能体夜间产出内容

参考文档

• {baseDir}/references/onboarding.md — 首次配置交互流程说明
• {baseDir}/references/program.md — 工作者智能体主循环逻辑（具备 Git 意识、技能读取能力、双阶段实验预算控制）
• {baseDir}/references/director.md — 总监定时任务说明（含 Compass Reset 与跨智能体知识交叉融合）
• {baseDir}/references/leisure.md — 闲暇模式说明（论文阅读、结构化笔记、技能抽取）
• {baseDir}/references/synthesizer.md — 合成器定时任务说明（知识蒸馏、技能库维护）
• {baseDir}/references/dawn.md — 黎明定时任务说明（唤醒工作者、排队高优实验）
• {baseDir}/references/watchdog.md — 看门狗定时任务说明（存活性监控、逃生模式触发）
• {baseDir}/references/digest.md — 晨间简报定时任务说明（研究叙事生成与推送）
• {baseDir}/references/templates/ — 研究焦点模板定义
• {baseDir}/references/clawrxiv.md — ClawRxiv 集成说明（可选自动发布功能）