🦀 ZeroClaw — 个人AI助手

零开销。零妥协。100% Rust。100% 无绑定。
⚡️ 在10美元硬件上运行，RAM不到5MB：比OpenClaw少99%内存，比Mac mini便宜98%！

由哈佛大学、麻省理工学院和 Sundai.Club 社区的学生及成员构建。

🌐 Languages: 🇺🇸 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

ZeroClaw 是一个运行在你自己设备上的个人AI助手。它在你已经使用的频道上回复你（WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Matrix、IRC、Email、Bluesky、Nostr、Mattermost、Nextcloud Talk、DingTalk、Lark、QQ、Reddit、LinkedIn、Twitter、MQTT、WeChat Work 等）。它有一个用于实时控制的网页仪表板，可以连接硬件外设（ESP32、STM32、Arduino、Raspberry Pi）。Gateway 只是控制平面——产品是助手本身。

如果你想要一个本地化、快速、始终在线的个人单用户助手，这就是它。

官网 · 文档 · 架构 · 入门指南 · 从 OpenClaw 迁移 · 故障排除 · Discord

推荐设置方式： 在终端运行 zeroclaw onboard。ZeroClaw Onboard 会引导你逐步设置网关、工作区、频道和提供者。这是推荐的设置路径，支持 macOS、Linux 和 Windows（通过 WSL2）。首次安装？从这里开始：入门指南

• OpenAI Codex（ChatGPT 订阅）
• Gemini（Google OAuth）
• Anthropic（API 密钥或认证令牌）

模型说明：虽然支持许多提供者/模型，但为获得最佳体验，请使用你可用的最强最新一代模型。参见引导设置。

模型配置 + CLI：提供者参考 认证配置轮换（OAuth 与 API 密钥）+ 故障转移：模型故障转移

运行时：Rust stable 工具链。单一二进制文件，无运行时依赖。

brew install zeroclaw

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

zeroclaw onboard 在安装后自动运行，配置你的工作区和提供者。

完整新手指南（认证、配对、频道）：入门指南

# 安装 + 引导
./install.sh --api-key "sk-..." --provider openrouter

# 启动网关（webhook 服务器 + 网页仪表板）
zeroclaw gateway                # 默认：127.0.0.1:42617
zeroclaw gateway --port 0       # 随机端口（安全加固）

# 与助手对话
zeroclaw agent -m "Hello, ZeroClaw!"

# 交互模式
zeroclaw agent

# 启动完整自主运行时（网关 + 频道 + 定时任务 + 手）
zeroclaw daemon

# 检查状态
zeroclaw status

# 运行诊断
zeroclaw doctor

升级？更新后运行 zeroclaw doctor。

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

cargo build --release --locked
cargo install --path . --force --locked

zeroclaw onboard

开发替代方案（无全局安装）： 命令前加 cargo run --release --（示例：cargo run --release -- status）。

ZeroClaw 可以导入你的 OpenClaw 工作区、记忆和配置：

# 预览将迁移的内容（安全，只读）
zeroclaw migrate openclaw --dry-run

# 执行迁移
zeroclaw migrate openclaw

这会将你的记忆条目、工作区文件和配置从 ~/.openclaw/ 迁移到 ~/.zeroclaw/。配置会自动从 JSON 转换为 TOML。

ZeroClaw 连接到真实的消息平台。将入站 DM 视为不可信输入。

完整安全指南：SECURITY.md

所有频道的默认行为：

• DM 配对（默认）：未知发送者会收到一个短配对码，机器人不会处理他们的消息。
• 使用以下命令批准：zeroclaw pairing approve <channel> <code>（然后发送者会被添加到本地允许列表）。
• 公共入站 DM 需要在 config.toml 中显式启用。
• 运行 zeroclaw doctor 来检测有风险或配置错误的 DM 策略。

自主级别：

沙箱层： 工作区隔离、路径遍历阻止、命令允许列表、禁止路径（/etc、/root、~/.ssh）、速率限制（每小时最大操作数、每日成本上限）。

使用此面板发布重要通知（破坏性更改、安全公告、维护窗口和发布阻塞问题）。

• 默认精简运行时 — 常见 CLI 和状态工作流在发布构建中运行仅需数兆字节内存。
• 低成本部署 — 专为 10 美元开发板和小型云实例设计，无重量级运行时依赖。
• 快速冷启动 — 单一二进制 Rust 运行时使命令和守护进程启动近乎即时。
• 可移植架构 — 跨 ARM、x86 和 RISC-V 的单一二进制文件，可交换的提供者/频道/工具。
• 本地优先网关 — 用于会话、频道、工具、定时任务、SOP 和事件的单一控制平面。
• 多频道收件箱 — WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Matrix、IRC、Email、Bluesky、Nostr、Mattermost、Nextcloud Talk、DingTalk、Lark、QQ、Reddit、LinkedIn、Twitter、MQTT、WeChat Work、WebSocket 等。
• 多代理编排（Hands） — 按计划运行并随时间变得更智能的自主代理群。
• 标准操作规程（SOPs） — 事件驱动的工作流自动化，支持 MQTT、webhook、cron 和外设触发器。
• 网页仪表板 — React 19 + Vite 网页 UI，具有实时聊天、记忆浏览器、配置编辑器、定时任务管理器和工具检查器。
• 硬件外设 — 通过 Peripheral trait 支持 ESP32、STM32 Nucleo、Arduino、Raspberry Pi GPIO。
• 一流工具 — shell、文件 I/O、浏览器、git、网页抓取/搜索、MCP、Jira、Notion、Google Workspace 等 70+ 种。
• 生命周期钩子 — 在每个阶段拦截和修改 LLM 调用、工具执行和消息。
• 技能平台 — 内置、社区和工作区技能，带安全审计。
• 隧道支持 — Cloudflare、Tailscale、ngrok、OpenVPN 和自定义隧道用于远程访问。

• 默认精简： 小型 Rust 二进制文件，快速启动，低内存占用。
• 安全设计： 配对、严格沙箱、显式允许列表、工作区范围限定。
• 完全可替换： 核心系统都是 trait（提供者、频道、工具、记忆、隧道）。
• 无锁定： 支持 OpenAI 兼容提供者 + 可插拔自定义端点。

本地机器快速基准测试（macOS arm64，2026年2月），针对 0.8GHz 边缘硬件标准化。

注意：ZeroClaw 的结果使用 /usr/bin/time -l 在发布构建上测量。OpenClaw 需要 Node.js 运行时（通常约 390MB 额外内存开销），而 NanoBot 需要 Python 运行时。PicoClaw 和 ZeroClaw 是静态二进制文件。上述 RAM 数据为运行时内存；构建时编译需求更高。

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

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

• Gateway HTTP/WS/SSE 控制平面，支持会话、在线状态、配置、定时任务、webhook、网页仪表板和配对。
• CLI 表面：gateway、agent、onboard、doctor、status、service、migrate、auth、cron、channel、skills。
• 代理编排循环，支持工具调度、提示构建、消息分类和记忆加载。
• 会话模型，支持安全策略执行、自主级别和批准门控。
• 弹性提供者包装器，支持故障转移、重试和跨 20+ LLM 后端的模型路由。

频道：WhatsApp（原生）、Telegram、Slack、Discord、Signal、iMessage、Matrix、IRC、Email、Bluesky、DingTalk、Lark、Mattermost、Nextcloud Talk、Nostr、QQ、Reddit、LinkedIn、Twitter、MQTT、WeChat Work、WATI、Mochat、Linq、Notion、WebSocket、ClawdTalk。

功能门控：Matrix（channel-matrix）、Lark（channel-lark）、Nostr（channel-nostr）。

React 19 + Vite 6 + Tailwind CSS 4 网页仪表板直接从 Gateway 提供：

• 仪表板 — 系统概览、健康状态、运行时间、成本跟踪
• 代理聊天 — 与代理的交互式聊天
• 记忆 — 浏览和管理记忆条目
• 配置 — 查看和编辑配置
• 定时任务 — 管理计划任务
• 工具 — 浏览可用工具
• 日志 — 查看代理活动日志
• 成本 — 令牌使用和成本跟踪
• 诊断 — 系统健康诊断
• 集成 — 集成状态和设置
• 配对 — 设备配对管理

• 核心： shell、文件读/写/编辑、git 操作、glob 搜索、内容搜索
• 网络： 浏览器控制、网页抓取、网络搜索、截图、图片信息、PDF 阅读
• 集成： Jira、Notion、Google Workspace、Microsoft 365、LinkedIn、Composio、Pushover
• MCP： Model Context Protocol 工具包装器 + 延迟工具集
• 调度： cron 添加/删除/更新/运行、计划工具
• 记忆： 回忆、存储、遗忘、知识、项目情报
• 高级： 委托（代理到代理）、群体、模型切换/路由、安全操作、云操作
• 硬件： 板信息、内存映射、内存读取（功能门控）

• 自主级别： ReadOnly、Supervised（默认）、Full。
• 沙箱： 工作区隔离、路径遍历阻止、命令允许列表、禁止路径、Landlock（Linux）、Bubblewrap。
• 速率限制： 每小时最大操作数、每日最大成本（可配置）。
• 批准门控： 中/高风险操作的交互式批准。
• 紧急停止： 紧急关闭功能。
• 129+ 安全测试 在自动化 CI 中。

• 网页仪表板直接从 Gateway 提供。
• 隧道支持：Cloudflare、Tailscale、ngrok、OpenVPN、自定义命令。
• Docker 运行时适配器用于容器化执行。
• CI/CD：beta（推送时自动）→ stable（手动触发）→ Docker、crates.io、Scoop、AUR、Homebrew、tweet。
• 预构建二进制文件支持 Linux（x86_64、aarch64、armv7）、macOS（x86_64、aarch64）、Windows（x86_64）。

最小 ~/.zeroclaw/config.toml：

default_provider = "anthropic"
api_key = "sk-ant-..."

完整配置参考：docs/reference/api/config-reference.md。

Telegram：

[channels.telegram]
bot_token = "123456:ABC-DEF..."

Discord：

[channels.discord]
token = "your-bot-token"

Slack：

[channels.slack]
bot_token = "xoxb-..."
app_token = "xapp-..."

WhatsApp：

[channels.whatsapp]
enabled = true

Matrix：

[channels.matrix]
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

Signal：

[channels.signal]
phone_number = "+1234567890"

[tunnel]
kind = "cloudflare"  # or "tailscale", "ngrok", "openvpn", "custom", "none"

详情：频道参考 · 配置参考

• native（默认）— 直接进程执行，最快路径，适合可信环境。
• docker — 完全容器隔离，强制安全策略，需要 Docker。

设置 runtime.kind = "docker" 以获得严格沙箱或网络隔离。

ZeroClaw 支持订阅原生认证配置文件（多账户，静态加密）。

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

# OpenAI Codex OAuth（ChatGPT 订阅）
zeroclaw auth login --provider openai-codex --device-code

# Gemini OAuth
zeroclaw auth login --provider gemini --profile default

# Anthropic setup-token
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

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

# 使用订阅认证运行代理
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

工作区根目录：~/.zeroclaw/workspace/（可通过配置自定义）。

注入的提示文件：

• IDENTITY.md — 代理人格和角色
• USER.md — 用户上下文和偏好
• MEMORY.md — 长期事实和经验
• AGENTS.md — 会话约定和初始化规则
• SOUL.md — 核心身份和运作原则

技能：~/.zeroclaw/workspace/skills/<skill>/SKILL.md 或 SKILL.toml。

# 列出已安装的技能
zeroclaw skills list

# 从 git 安装
zeroclaw skills install https://github.com/user/my-skill.git

# 安装前安全审计
zeroclaw skills audit https://github.com/user/my-skill.git

# 移除技能
zeroclaw skills remove my-skill

# 工作区管理
zeroclaw onboard              # 引导设置向导
zeroclaw status               # 显示守护进程/代理状态
zeroclaw doctor               # 运行系统诊断

# 网关 + 守护进程
zeroclaw gateway              # 启动网关服务器（127.0.0.1:42617）
zeroclaw daemon               # 启动完整自主运行时

# 代理
zeroclaw agent                # 交互式聊天模式
zeroclaw agent -m "message"   # 单条消息模式

# 服务管理
zeroclaw service install      # 作为系统服务安装（launchd/systemd）
zeroclaw service start|stop|restart|status

# 频道
zeroclaw channel list         # 列出已配置的频道
zeroclaw channel doctor       # 检查频道健康状况
zeroclaw channel bind-telegram 123456789

# 定时任务 + 调度
zeroclaw cron list            # 列出计划任务
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# 记忆
zeroclaw memory list          # 列出记忆条目
zeroclaw memory get <key>     # 检索记忆
zeroclaw memory stats         # 记忆统计

# 认证配置文件
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# 硬件外设
zeroclaw hardware discover    # 扫描已连接的设备
zeroclaw peripheral list      # 列出已连接的外设
zeroclaw peripheral flash     # 向设备刷写固件

# 迁移
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Shell 补全
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

完整命令参考：docs/reference/cli/commands-reference.md

curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

./install.sh --prefer-prebuilt

./install.sh --prebuilt-only

发布资产可用于：

• Linux: x86_64、aarch64、armv7
• macOS: x86_64、aarch64
• Windows: x86_64

从以下位置下载最新资产： https://github.com/zeroclaw-labs/zeroclaw/releases/latest

当你完成引导流程后需要更深入的参考时使用这些文档。

• 从文档索引开始了解导航和内容分布。
• 阅读架构概述了解完整系统模型。
• 使用配置参考查阅所有键和示例。
• 按照运维手册运行 Gateway。
• 按照 ZeroClaw Onboard 进行引导设置。
• 使用故障排除指南调试常见故障。
• 在暴露任何内容之前查看安全指南。

• 文档中心：docs/README.md
• 统一文档目录：docs/SUMMARY.md
• 命令参考：docs/reference/cli/commands-reference.md
• 配置参考：docs/reference/api/config-reference.md
• 提供者参考：docs/reference/api/providers-reference.md
• 频道参考：docs/reference/api/channels-reference.md
• 运维手册：docs/ops/operations-runbook.md
• 故障排除：docs/ops/troubleshooting.md

• 贡献指南：CONTRIBUTING.md
• PR 工作流策略：docs/contributing/pr-workflow.md
• CI 工作流指南：docs/contributing/ci-map.md
• 审查员手册：docs/contributing/reviewer-playbook.md
• 安全披露策略：SECURITY.md
• 文档模板：docs/contributing/doc-template.md

• 网络部署指南：docs/ops/network-deployment.md
• 代理代理手册：docs/ops/proxy-agent-playbook.md
• 硬件指南：docs/hardware/README.md

ZeroClaw 为 smooth crab 🦀 而构建，一个快速高效的 AI 助手。由 Argenis De La Rosa 和社区共同构建。

• zeroclawlabs.ai
• @zeroclawlabs

如果 ZeroClaw 对你的工作有帮助，你想支持持续开发，可以在这里捐款：

衷心感谢激励和推动这项开源工作的社区和机构：

• 哈佛大学 — 培养求知欲并推动可能性的边界。
• MIT — 倡导开放知识、开源以及技术应该人人可及的信念。
• Sundai Club — 社区、能量以及不懈追求构建有意义事物的动力。
• 世界及更远 🌍✨ — 致每一位贡献者、梦想家和构建者，你们让开源成为一股向善的力量。这是献给你们的。

我们公开构建，因为最好的想法来自四面八方。如果你在阅读这些，你就是其中的一部分。欢迎。🦀❤️

ZeroClaw 新手？寻找标记为 good first issue 的问题 — 参阅我们的贡献指南了解如何开始。欢迎 AI/vibe-coded PR！🤖

参见 CONTRIBUTING.md 和 CLA.md。实现一个 trait，提交 PR：

• CI 工作流指南：docs/contributing/ci-map.md
• 新 Provider → src/providers/
• 新 Channel → src/channels/
• 新 Observer → src/observability/
• 新 Tool → src/tools/
• 新 Memory → src/memory/
• 新 Tunnel → src/tunnel/
• 新 Peripheral → src/peripherals/
• 新 Skill → ~/.zeroclaw/workspace/skills/<name>/

这是唯一的 ZeroClaw 官方仓库：

https://github.com/zeroclaw-labs/zeroclaw

任何其他声称是"ZeroClaw"或暗示与 ZeroClaw Labs 有关联的仓库、组织、域名或包都是未经授权的，与本项目无关。已知的未授权分支将在 TRADEMARK.md 中列出。

如果你遇到冒充或商标滥用，请提交问题。

ZeroClaw 采用双重许可，以实现最大开放性和贡献者保护：

你可以选择任一许可证。贡献者自动授予两种许可证的权利 — 参见 CLA.md 了解完整的贡献者协议。

ZeroClaw 名称和标志是 ZeroClaw Labs 的商标。此许可证不授予使用它们暗示背书或关联的权限。参见 TRADEMARK.md 了解允许和禁止的使用。

• 你保留你贡献的版权
• 专利授权（Apache 2.0）保护你免受其他贡献者的专利索赔
• 你的贡献在提交历史和 NOTICE 中永久归属
• 贡献不转让商标权

ZeroClaw — 零开销。零妥协。随处部署。任意替换。🦀

此列表从 GitHub 贡献者图表生成，自动更新。