ultraworkers/claw-code

Claw Code – 基于 Rust 的 AI 代理 CLI 工具

简介 – claw-code 是 claw 命令行代理工具 的公开 Rust 实现。它提供了一个二进制文件 (claw)，可以与 LLM 提供商（Anthropic、OpenAI、本地 Ollama 风格服务器）通信，并运行代理风格的提示、会话和工具调用工作流程。该仓库包含 Rust 工作区 (rust/)、一个小型 Python 参考层，以及用于构建、配置和使用该 CLI 的详尽文档。

主要功能（如 README 所述）

• 代理管理的 CLI – 该工具会自动规划、执行、验证和标记工作；它旨在由其他代理运行，而非手动操作。
• 多提供商支持 – 适用于 Anthropic、OpenAI 和本地兼容 OpenAI 的服务器（Ollama、vLLM 等）。
• 交互式与一次性模式 – 使用 claw prompt "…" 进行单次请求，使用 claw 进行交互式 REPL 风格会话。
• 健康检查指令 – claw doctor 可验证 API 密钥、模型访问权限和工具配置。
• 同位检查工具 – 用于确定性测试和迁移追踪的模拟服务 (MOCK_PARITY_HARNESS.md)。
• 容器优先工作流程 – 文档说明了如何在容器内运行该工具。
• 未来的 ACP/Zed JSON-RPC – 路线图提到将增加 ACP 守护进程和 JSON-RPC 入口点。

如何开始

1. 克隆并构建 Rust 工作区：

   git clone https://github.com/ultraworkers/claw-code
   cd claw-code/rust
   cargo build --workspace   # 或 `cargo build --release`
   

2. 设置 API 密钥（例如 Anthropic）：

   export ANTHROPIC_API_KEY="sk-ant-..."
   

3. 运行健康检查：

   ./target/debug/claw doctor
   

4. 尝试提示：

   ./target/debug/claw prompt "say hello"
   

5. 进入交互模式：

   ./target/debug/claw
   

Windows 用户请在 PowerShell 中遵循相同步骤，并使用 claw.exe。

文档地图 – 仓库附带了一系列 markdown 文件：

• USAGE.md – 快速入门指令、验证、会话、同位检查工具。
• rust/README.md – crate 布局和 CLI 界面。
• docs/ – 提供商设置、容器工作流程、Windows 安装、事件/报告合约等。
• PARITY.md, ROADMAP.md, PHILOSOPHY.md – 项目状态、未来计划和设计理念。

生态系统 – claw 与其他 UltraWorkers 工具（如 clawhip、oh-my-openagent、gajae-code 等）并列，社区聚集在两个 Discord 服务器上。

授权 – MIT。

总结 – 如果您需要一个 Rust 原生的 CLI 来运行基于 LLM 的自主代理、管理会话并尝试多提供商设置，claw-code 提供了该工具。这是一个仅限从源代码构建的项目；crates.io 上发布的 claw-code crate 已被弃用，因此您必须自行编译二进制文件或安装上游的 agent-code 包。