内容
# 无损OpenClaw编排器
**LCO 将本地 Codex 会话转换为可搜索、有界限、审批感知的可工作对象，用于 OpenClaw。**
在代理或用户需要回答以下问题时使用：哪些会话是活跃的，它们计划了什么，它们完成了什么，它们触及了哪些文件，以及在不重新阅读原始记录的情况下，下一步的安全操作是什么。
[](https://www.npmjs.com/package/lossless-openclaw-orchestrator)
[](https://github.com/100yenadmin/Lossless-Codex-Orchestrator-LCO/actions/workflows/ci.yml)
[](https://github.com/100yenadmin/Lossless-Codex-Orchestrator-LCO/actions/workflows/codeql.yml)
[](LICENSE)
[](CONTRIBUTING.md)
[设置](docs/SETUP.md) · [贡献](CONTRIBUTING.md) · [代理说明](AGENTS.md) · [代理技能](skills/lossless-openclaw-orchestrator/SKILL.md) · [OpenClaw 插件](docs/OPENCLAW_PLUGIN.md) · [安全](SECURITY.md) · [行为准则](CODE_OF_CONDUCT.md) · [愿景](VISION.md) · [隐私](docs/PRIVACY.md) · [Claude 边界](docs/CLAUDE_ADAPTER_BOUNDARY.md) · [声明审计](docs/CLAIM_AUDIT.md) · [发布说明](docs/RELEASE_NOTES_1.0.0.md) · [许可证](LICENSE)
## 为什么它很重要
Codex 很强大，但长时间运行的本地工作可能很难监督，一旦你有数十或数百个线程。LCO 为你的编排代理提供了一个安全的运行图：先搜索，然后检查紧凑的会话卡片，只扩展有界证据，并在任何实时发生之前预运行下一步。
如果你是来贡献的，请从 [CONTRIBUTING.md](CONTRIBUTING.md) 开始。如果你是这个仓库中的代理，请在编辑文件之前阅读 [AGENTS.md](AGENTS.md)。
## 它做了什么
LCO 是一个针对 Codex-heavy 工作本地优先的编排层：
- 将本地 Codex 会话存储索引到本地 SQLite 数据库
- 按安全摘要、计划、最终消息、触及的文件和引用搜索会话
- 描述一个会话而不暴露整个记录
- 仅扩展代理需要的证据，并使用 token-budgeted 配置文件
- 通过 MCP 和 OpenClaw 插件公开 `loo_*` 工具
- 在 Codex 恢复/发送/引导/中断之前创建预运行审批包
- 在不修改 GUI 的情况下报告 Codex Desktop 可见性和备用准备情况
- 验证精确的动作绑定 Desktop 协作证明包而不执行它们
- 总结运行时 Desktop 可见性覆盖率和下一个只读证明步骤
结果是一个分阶段的召回循环：
1. 广泛搜索。
2. 描述可能的会话。
3. 扩展一个小的证据包。
4. 预运行下一步。
5. 在用户批准确切的目标/动作后执行。
## 安装
要求：
- Node.js 22 或更高版本
- npm
- 本地 Codex 会话文件，通常位于 `~/.codex/sessions`
- 如果您想通过 OpenClaw 安装 `loo_*` 工具，则需要 OpenClaw Desktop/CLI
稳定安装：
```bash
npm install -g lossless-openclaw-orchestrator@latest
loo doctor
```
测试版本，当您明确想要最新的预发布版本：
```bash
npm install -g lossless-openclaw-orchestrator@beta
```
软件包渠道：
- `latest` 是稳定的公共渠道。
- `beta` 是活跃的预发布列车。
- `next` 保留用于发布候选版本。
完整的首次运行说明位于 [docs/SETUP.md](docs/SETUP.md)。
## 设置
选择 LCO 存储其本地索引的位置。默认情况下已经位于 `~/.openclaw` 下，但显式设置使安装更容易检查：
```bash
export LOO_DB_PATH="$HOME/.openclaw/lossless-openclaw-orchestrator/orchestrator.sqlite"
```
索引本地 Codex 会话：
```bash
loo index codex --max-files 500 "$HOME/.codex/sessions" "$HOME/.codex/archived_sessions"
```
可选：允许从一个或多个 OpenClaw LCM 对等数据库进行只读回忆：
```bash
export LOO_LCM_DB_PATHS="$HOME/.openclaw/lcm.db"
```
检查本地准备情况：
```bash
loo doctor
loo onboard status --strict
```
## 第一个工作流
搜索会话：
```bash
loo search "billing bridge proposed plan"
```
描述结果：
```bash
loo describe codex_thread:<thread-id>
```
扩展有界简报：
```bash
loo expand-ref --profile brief --token-budget 1000 codex_thread:<thread-id>
```
从查询中扩展，当您不知道引用时：
```bash
loo expand-query --profile brief --token-budget 1000 "billing bridge"
```
对于正常代理工作流，请使用 MCP/OpenClaw 工具：
- `loo_search_sessions`
- `loo_describe_session`
- `loo_expand_session`
- `loo_codex_plans`
- `loo_codex_final_messages`
- `loo_codex_touched_files`
- `loo_codex_control_dry_run`
`loo_codex_control_dry_run` 返回审计 ID 和哈希，代理应显示在任何实时恢复/发送/引导/中断调用之前。实时控制需要匹配的 `approval_audit_id`。
打包的代理剧本是 [skills/lossless-openclaw-orchestrator/SKILL.md](skills/lossless-openclaw-orchestrator/SKILL.md)。
## OpenClaw 和 MCP
直接运行 MCP 服务器：
```bash
loo-mcp-server
```
典型的 MCP 客户端入口：
```json
{
"mcpServers": {
"lossless-openclaw-orchestrator": {
"command": "loo-mcp-server"
}
}
}
```
从 npm 安装 OpenClaw 插件：
```bash
openclaw plugins install lossless-openclaw-orchestrator@latest
openclaw plugins list --json
```
验证包和 OpenClaw 网关路径：
```bash
loo openclaw dogfood --profile lco-dogfood --install-source lossless-openclaw-orchestrator@latest --required-tool loo_doctor --required-tool loo_search_sessions --strict
loo openclaw tool-smoke --profile lco-dogfood --required-tool loo_doctor --required-tool loo_search_sessions --strict
```
OpenClaw 网关设置可能需要本地凭证、设备配对、令牌或范围批准步骤，然后才能通过工具烟雾测试。LCO 将这些报告为设置阻止器，而不是包失败。参见 [docs/SETUP.md](docs/SETUP.md) 和 [docs/OPENCLAW_PLUGIN.md](docs/OPENCLAW_PLUGIN.md)。
## 安全边界
LCO 是 Codex-first 和 local-first 的。
默认行为：
- 本地 SQLite 索引
- 公共安全摘要在原始扩展之前
- 源引用而不是原始记录路径
- 有界扩展配置文件
- 只读 OpenClaw LCM 对等数据库访问
- 在桌面备用之前直接 Codex 协议
- 预运行加上匹配的 `approval_audit_id` 在实时 Codex 控制之前
未声明：
- 完整的 Claude Code 对等性
- 云同步
- 无人值守的桌面接管
- 权限绕过
- 企业或客户级安全声明
- 不支持通用 GUI 突变
- Codex GUI 突变不是稳定的公共声明
Claude Code 支持是一个适配器存根和编辑后的夹具清单，直到其存储和控制路径得到证明。桌面备用表面报告就绪状态、阻塞器和证明状态；它们不授权提示输入、点击、刷新/重启自动化或任意应用程序控制。
Claude 适配器证明边界位于 [docs/CLAUDE_ADAPTER_BOUNDARY.md](docs/CLAUDE_ADAPTER_BOUNDARY.md)。公共声明细节位于 [docs/CLAIM_AUDIT.md](docs/CLAIM_AUDIT.md)。
隐私细节位于 [docs/PRIVACY.md](docs/PRIVACY.md) 和 [docs/SAFE_SUMMARIES.md](docs/SAFE_SUMMARIES.md)。
## 社区和贡献
LCO 设计为易于尝试和安全改进。公共贡献路径是：
1. 阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 以了解问题路由、验证、证据和代理作者的 PR 期望。
2. 按照 [docs/SETUP.md](docs/SETUP.md) 进行本地安装和首次运行设置。
3. 在进行编码更改时使用 [AGENTS.md](AGENTS.md)。
4. 通过 GitHub 问题表单提交错误、文档错误、功能请求、适配器请求、协议漂移报告或不安全控制报告。
适合新手的问题候选包括文档空白、编辑后的夹具覆盖范围、设置诊断、问题模板改进和狭窄的 CLI 帮助修复。使用适配器请求表单请求适配器；描述目标应用程序/运行时、读取/索引路径、控制边界和编辑后的证明可用于测试它。
永远不要在公共问题或 PR 中粘贴原始 Codex 记录、私有 SQLite 数据库、令牌、cookie、连接器 URL 或客户数据。使用 [SECURITY.md](SECURITY.md) 进行私有漏洞报告，使用 [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) 进行社区期望。
## 架构
- `packages/core`：SQLite 索引、Codex 导入、安全摘要、源引用、提取、搜索和扩展
- `packages/mcp-server`：stdio MCP 服务器，公开 `loo_*` 工具
- `packages/openclaw-plugin`：OpenClaw 插件入口和清单表面
- `packages/cli`：`loo` CLI，用于设置、索引、回忆、烟雾测试、评估和发布门控
- `packages/adapters`：Codex 传输、审计、编辑、 CUA/Peekaboo 就绪性和适配器边界
- `skills/`：打包的代理面向 OpenClaw 的剧本
- `evals/`：场景和记分卡合约
- `docs/`：设置、隐私、发布证明、源权威、适配器边界和更深入的操作员指南
## 路线图和证明状态
稳定的公共产品是 Codex-first 本地编排：索引、搜索、描述、扩展、OpenClaw/MCP 工具和审批门控干预边界。
当前的更深入的产品工作在 GitHub 问题中跟踪，并在 [VISION.md](VISION.md) 中总结。保持冲刺和代理操作员的详细信息在 [AGENTS.md](AGENTS.md) 和打包的 [代理技能](skills/lossless-openclaw-orchestrator/SKILL.md) 中，而不是在这个公共登陆页面上。
## 维护者证明
发布和就绪证明位于运行手册中，而不是在首次设置路径中：
- [发布检查清单](docs/RELEASE_CHECKLIST.md)
- [发布运行手册](docs/BETA_RELEASE_RUNBOOK.md)
- [声明审计](docs/CLAIM_AUDIT.md)
- [QA 演示](docs/BETA_RELEASE_DEMO.md)
对于 `1.0`，通用发布检查清单需要新鲜的 npm clean-profile 证据、代理狗粮证据通过网关工具、CI、记分卡和声明审计证明，然后再推广到 `latest`。
版本证明合约位于 `evals/scorecards/v1.0` 和 `evals/scenarios/v1`；运行时所需的场景合约位于 `evals/scenarios/v1.1`。
核心证明命令：
```bash
loo scorecards sweep --evidence-dir /Volumes/LEXAR/Codex/lossless-openclaw-orchestrator/YYYY-MM-DD/issue-<number>-scorecard-sweep --strict
loo eval scenarios --evidence-dir /Volumes/LEXAR/Codex/lossless-openclaw-orchestrator/YYYY-MM-DD/issue-<number>-qa-lab --strict
loo release preflight --claim-scope codex-read-search-expand-dry-run --evidence-dir /Volumes/LEXAR/Codex/lossless-openclaw-orchestrator/YYYY-MM-DD/release-preflight --strict
loo release demo-status --claim-scope codex-read-search-expand-dry-run --evidence-dir /Volumes/LEXAR/Codex/lossless-openclaw-orchestrator/YYYY-MM-DD/demo --strict
loo release status --claim-scope codex-read-search-expand-dry-run --evidence-dir /Volumes/LEXAR/Codex/lossless-openclaw-orchestrator/YYYY-MM-DD/release-status --candidate-sha <release-candidate-sha> --npm-publish-approval-evidence npm-publish-approval.json --github-release-approval-evidence github-release-approval.json --github-ci-evidence github-ci.json --codeql-evidence codeql.json --strict
loo release general-readiness --evidence-dir /Volumes/LEXAR/Codex/lossless-openclaw-orchestrator/YYYY-MM-DD/general-readiness --fresh-npm-evidence published-package-smoke.json --agent-dogfood-evidence openclaw-tool-smoke.json --strict
```
## 开发
```bash
npm install
npm run build
npm test
npm run check
```
测试套件使用编辑后的夹具和 Node 内置的测试运行器。重验证预计在 CI 中运行；本地开发应首先使用聚焦测试。
有关贡献者工作流的详细信息，请使用 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 许可证
当前源代码和已发布的 npm 版本在 [PolyForm Noncommercial License 1.0.0](LICENSE) 下可源代码可用。非商业用途根据这些条款允许。
商业、内部业务、托管服务或产品使用需要项目所有者的单独商业许可证。
早期预发布工件此前带有 MIT 元数据，不再在 npm 上发布。任何已下载的副本仍受分发时附带的许可证条款约束。
