Skip to content

README.zh-CN.md

Latest commit

 

History

History
262 lines (196 loc) · 12.3 KB

README.zh-CN.md

File metadata and controls

262 lines (196 loc) · 12.3 KB

ZeroClaw

ZeroClaw 🦀（简体中文）

零开销、零妥协；随处部署、万物可换。

License: MIT OR Apache-2.0 Contributors Buy Me a Coffee X: @zeroclawlabs Facebook Group Discord TikTok: @zeroclawlabs RedNote Reddit: r/zeroclawlabs

🌐 语言： 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

一键部署 | 安装入门 | 文档总览 | 文档目录

场景分流： 参考手册 · 运维部署 · 故障排查 · 安全专题 · 硬件外设 · 贡献与 CI

本文是对 README.md 的人工对齐翻译（强调可读性与准确性，不做逐字直译）。

技术标识（命令、配置键、API 路径、Trait 名称）保持英文，避免语义漂移。

最后对齐时间：2026-03-14。

🚀 What's New in v0.3.1 (March 2026)

Area Highlights
ci add Termux (aarch64-linux-android) release target

📢 公告板

用于发布重要通知（破坏性变更、安全通告、维护窗口、版本阻塞问题等）。

日期（UTC） 级别 通知 处理建议
2026-02-19 紧急 我们与 openagen/zeroclaw 及 zeroclaw.org 没有任何关系。zeroclaw.org 当前会指向 openagen/zeroclaw 这个 fork，并且该域名/仓库正在冒充我们的官网与官方项目。 请不要相信上述来源发布的任何信息、二进制、募资活动或官方声明。请仅以本仓库和已验证官方社媒为准。
2026-02-21 重要 我们的官网现已上线：zeroclawlabs.ai。感谢大家一直以来的耐心等待。我们仍在持续发现冒充行为，请勿参与任何未经我们官方渠道发布、但打着 ZeroClaw 名义进行的投资、募资或类似活动。 一切信息请以本仓库为准；也可关注 X（@zeroclawlabs）、Telegram（@zeroclawlabs）、Facebook（群组）、Reddit（r/zeroclawlabs） 与 小红书账号 获取官方最新动态。
2026-02-19 重要 Anthropic 于 2026-02-19 更新了 Authentication and Credential Use 条款。条款明确：OAuth authentication（用于 Free、Pro、Max）仅适用于 Claude Code 与 Claude.ai；将 Claude Free/Pro/Max 账号获得的 OAuth token 用于其他任何产品、工具或服务（包括 Agent SDK）不被允许，并可能构成对 Consumer Terms of Service 的违规。 为避免损失，请暂时不要尝试 Claude Code OAuth 集成；原文见：Authentication and Credential Use。

项目简介

ZeroClaw 是一个高性能、低资源占用、可组合的自主智能体运行时。ZeroClaw 是面向智能代理工作流的运行时操作系统 — 它抽象了模型、工具、记忆和执行层，使代理可以一次构建、随处运行。

  • Rust 原生实现，单二进制部署，跨 ARM / x86 / RISC-V。
  • Trait 驱动架构，Provider / Channel / Tool / Memory 可替换。
  • 安全默认值优先：配对鉴权、显式 allowlist、沙箱与作用域约束。

为什么选择 ZeroClaw

  • 默认轻量运行时：常见 CLI 与 status 工作流通常保持在几 MB 级内存范围。
  • 低成本部署友好：面向低价板卡与小规格云主机设计，不依赖厚重运行时。
  • 冷启动速度快：Rust 单二进制让常用命令与守护进程启动更接近“秒开”。
  • 跨架构可移植：同一套二进制优先流程覆盖 ARM / x86 / RISC-V，并保持 provider/channel/tool 可替换。

基准快照（ZeroClaw vs OpenClaw，可复现）

以下是本地快速基准对比（macOS arm64，2026 年 2 月），按 0.8GHz 边缘 CPU 进行归一化展示：

OpenClaw NanoBot PicoClaw ZeroClaw 🦀
语言 TypeScript Python Go Rust
RAM > 1GB > 100MB < 10MB < 5MB
启动时间（0.8GHz 核） > 500s > 30s < 1s < 10ms
二进制体积 ~28MB（dist） N/A（脚本） ~8MB ~8.8 MB
成本 Mac Mini $599 Linux SBC ~$50 Linux 板卡 $10 任意 $10 硬件

说明：ZeroClaw 的数据来自 release 构建，并通过 /usr/bin/time -l 测得。OpenClaw 需要 Node.js 运行时环境，仅该运行时通常就会带来约 390MB 的额外内存占用；NanoBot 需要 Python 运行时环境。PicoClaw 与 ZeroClaw 为静态二进制。

ZeroClaw vs OpenClaw 对比图

本地可复现测量

基准数据会随代码与工具链变化，建议始终在你的目标环境自行复测：

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

当前 README 的样例数据（macOS arm64，2026-02-18）：

  • Release 二进制：8.8M
  • zeroclaw --help：约 0.02s，峰值内存约 3.9MB
  • zeroclaw status：约 0.01s，峰值内存约 4.1MB

一键部署

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

可选环境初始化：./install.sh --install-system-deps --install-rust（可能需要 sudo）。

详细说明见：docs/setup-guides/one-click-bootstrap.md。

快速开始

Homebrew（macOS/Linuxbrew）

brew install zeroclaw
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked

# 快速初始化（无交互）
zeroclaw onboard --api-key sk-... --provider openrouter

# 或使用引导式向导
zeroclaw onboard

# 单次对话
zeroclaw agent -m "Hello, ZeroClaw!"

# 启动网关（默认: 127.0.0.1:42617）
zeroclaw gateway

# 启动长期运行模式
zeroclaw daemon

Subscription Auth（OpenAI Codex / Claude Code）

ZeroClaw 现已支持基于订阅的原生鉴权配置（多账号、静态加密存储）。

  • 配置文件：~/.zeroclaw/auth-profiles.json
  • 加密密钥：~/.zeroclaw/.secret_key
  • Profile ID 格式：<provider>:<profile_name>（例：openai-codex:work）

OpenAI Codex OAuth（ChatGPT 订阅）：

# 推荐用于服务器/无显示器环境
zeroclaw auth login --provider openai-codex --device-code

# 浏览器/回调流程，支持粘贴回退
zeroclaw auth login --provider openai-codex --profile default
zeroclaw auth paste-redirect --provider openai-codex --profile default

# 检查 / 刷新 / 切换 profile
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

Claude Code / Anthropic setup-token：

# 粘贴订阅/setup token（Authorization header 模式）
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# 别名命令
zeroclaw auth setup-token --provider anthropic --profile default

使用 subscription auth 运行 agent：

zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider openai-codex --auth-profile openai-codex:work -m "hello"

# Anthropic 同时支持 API key 和 auth token 环境变量：
# ANTHROPIC_AUTH_TOKEN, ANTHROPIC_OAUTH_TOKEN, ANTHROPIC_API_KEY
zeroclaw agent --provider anthropic -m "hello"

贡献与许可证

🌟 Recent Contributors (v0.3.1)

3 contributors shipped features, fixes, and improvements in this release cycle:

  • Argenis
  • argenis de la rosa
  • Claude Opus 4.6

Thank you to everyone who opened issues, reviewed PRs, translated docs, and helped test. Every contribution matters. 🦀

如果你需要完整实现细节（架构图、全部命令、完整 API、开发流程），请直接阅读英文主文档：README.md。