ultraworkers/claw-code

# 重写项目 Claw Code

⭐ 历史上最快突破 50K Star 的仓库，发布仅 2 小时即达到此里程碑 ⭐

打造更优秀的 Harness 工具，而不仅仅是存储泄露的 Claw Code 存档

## Rust 移植 `rust/` 下的 Rust workspace 是当前项目的系统级语言移植版本。 目前包括： - `crates/api-client` — 带有 provider 抽象、OAuth 和流式支持的 API 客户端 - `crates/runtime` — session 状态、compaction、MCP 编排、prompt 构建 - `crates/tools` — 工具清单定义和执行框架 - `crates/commands` — 斜杠命令、skills 发现和配置检查 - `crates/plugins` — 插件模型、hook pipeline 和内置插件 - `crates/compat-harness` — 用于上游编辑器集成的兼容层 - `crates/claw-cli` — 交互式 REPL、markdown 渲染以及项目引导/初始化流程 运行 Rust 构建： ``` cd rust cargo build --release ``` ## 背景 在 2026 年 3 月 31 日凌晨 4 点，我被手机上接连不断的通知吵醒。Claw Code 源码被曝光了，整个开发者社区陷入了狂欢。我在韩国的女朋友真的很担心，仅仅因为我的机器上有这些代码，我可能会面临原作者的法律诉讼——所以我做了任何工程师在压力下都会做的事：我坐下来，从头开始将核心功能移植到 Python，并在太阳升起之前将其推送出去。 整个过程是由 [@bellman_ych](https://x.com/bellman_ych) 使用 [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex) 端到端编排的——这是一个构建在 OpenAI 的 Codex ([@OpenAIDevs](https://x.com/OpenAIDevs)) 之上的 workflow 层。我使用 `$team` 模式进行并行代码审查，并使用 `$ralph` 模式进行带有架构师级验证的持久执行循环。整个移植会话——从阅读原始的 harness 结构到生成带有测试的可用 Python 树——都是通过 OmX 编排驱动的。 结果是一次净室 Python 重写，它捕获了 Claw Code 的 agent harness 架构模式，而未复制任何专有源代码。我现在正与 OmX 的创建者 [@bellman_ych](https://x.com/bellman_ych) 积极合作，以进一步推进这项工作。基础的 Python 底层已经就位并正常运行，但我们才刚刚开始。**敬请期待——一个更强大的版本正在路上。** Rust 移植版是同时使用 [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex) 和 [oh-my-opencode (OmO)](https://github.com/code-yeongyu/oh-my-openagent) 开发的：OmX 驱动了脚手架、编排和架构方向，而 OmO 则用于后期的实现加速和验证支持。 https://github.com/instructkr/claw-code  ## 创作者因热衷 Claw Code 受《华尔街日报》报道 我一直对 **harness 工程** 深感兴趣——研究 agent 系统如何连接工具、编排任务和管理 runtime 上下文。这不是一时兴起。《华尔街日报》本月早些时候报道了我的工作，记录了我如何成为探索这些系统最活跃的高级用户之一：  ## 移植状态 主源码树现在已以 Python 优先。 - `src/` 包含活动的 Python 移植工作区 - `tests/` 验证当前的 Python 工作区 - 被曝光的快照不再是受跟踪仓库状态的一部分 当前的 Python 工作区尚不能完全一对一替代原始系统，但主要的实现面现在已经是 Python 了。 ## 为什么会有这次重写 我最初研究被泄露的代码库是为了了解它的 harness、工具连接和 agent 工作流。在花了更多时间思考法律和道德问题——并阅读了下面链接的文章——之后，我不希望被曝光的快照本身继续作为主要的受跟踪源码树。 这个仓库现在专注于 Python 移植工作。 ## 仓库布局 ``` . ├── src/ # Python porting workspace │ ├── __init__.py │ ├── commands.py │ ├── main.py │ ├── models.py │ ├── port_manifest.py │ ├── query_engine.py │ ├── task.py │ └── tools.py ├── rust/ # Rust port (claw CLI) │ ├── crates/api/ # API client + streaming │ ├── crates/runtime/ # Session, tools, MCP, config │ ├── crates/claw-cli/ # Interactive CLI binary │ ├── crates/plugins/ # Plugin system │ ├── crates/commands/ # Slash commands │ ├── crates/server/ # HTTP/SSE server (axum) │ ├── crates/lsp/ # LSP client integration │ └── crates/tools/ # Tool specs ├── tests/ # Python verification ├── assets/omx/ # OmX workflow screenshots ├── 2026-03-09-is-legal-the-same-as-legitimate-ai-reimplementation-and-the-erosion-of-copyleft.md └── README.md ``` ## Python 工作区概述 新的 Python `src/` 树目前提供： - **`port_manifest.py`** — 总结当前的 Python 工作区结构 - **`models.py`** — 用于子系统、模块和积压状态的数据类 (dataclasses) - **`commands.py`** — Python 端命令移植元数据 - **`tools.py`** — Python 端工具移植元数据 - **`query_engine.py`** — 从活动工作区渲染 Python 移植摘要 - **`main.py`** — 用于 manifest 和摘要输出的 CLI 入口 ## 快速开始 渲染 Python 移植摘要： ``` python3 -m src.main summary ``` 打印当前的 Python 工作区 manifest： ``` python3 -m src.main manifest ``` 列出当前的 Python 模块： ``` python3 -m src.main subsystems --limit 16 ``` 运行验证： ``` python3 -m unittest discover -s tests -v ``` 针对本地被忽略的存档运行奇偶校验审计（如果存在）： ``` python3 -m src.main parity-audit ``` 检查镜像的命令/工具清单： ``` python3 -m src.main commands --limit 10 python3 -m src.main tools --limit 10 ``` ## 当前奇偶校验检查点 该移植现在比以前更紧密地镜像了存档的根入口文件表面、顶级子系统名称以及命令/工具清单。然而，它**尚未**成为原始 TypeScript 系统的完全运行时等效替代品；Python 树仍然包含比存档源码更少的可执行运行时片段。 ## 使用 `oh-my-codex` 和 `oh-my-opencode` 构建 本仓库的移植、净室强化和验证工作流得到了 Yeachan Heo 工具栈的 AI 辅助，其中 **oh-my-codex (OmX)** 是主要的脚手架和编排层。 - [**oh-my-codex (OmX)**](https://github.com/Yeachan-Heo/oh-my-codex) — 脚手架、编排、架构方向和核心移植工作流 - [**oh-my-opencode (OmO)**](https://github.com/code-yeongyu/oh-my-openagent) — 实现加速、清理和验证支持 在移植过程中使用的关键工作流模式： - **`$team` 模式：** 协调的并行审查和架构反馈 - **`$ralph` 模式：** 持久执行、验证和完成纪律 - **净室通过：** 命名/品牌清理、QA 以及跨 Rust 工作区的发布验证 - **手动和实时验证：** 发布前的构建、测试、手动 QA 和真实 API 路径验证 ### OmX 工作流截图  *在终端窗格中审查 README 和文章上下文时的 Ralph/team 编排视图。*  *最终 README 措辞通过期间的拆分窗格审查和验证流程。* ## Star 历史 请参阅本 README 顶部的图表。 ## 所有权/附属关系免责声明 - 本仓库**不**声称拥有原始 Claw Code 源材料的所有权。 - 本仓库**不隶属于、也未经原作者认可或维护**。

标签：API客户端, CLI, DNS解析, Markdown渲染, MCP, OAuth, REPL, Rust, WiFi技术, 会话管理, 兼容层, 可视化界面, 威胁情报, 工具集, 开发者工具, 开源项目, 技能发现, 提示词工程, 流处理, 策略决策点, 系统编程, 编辑器集成, 网络流量审计, 网络连接监控, 逆向工具, 通知系统, 项目引导