zeroclaw

Rust 写的超轻量自主 AI 助理，任意设备一键部署

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 32983

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类智能体

开发团队zeroclaw-labs

所属国家

官网地址https://www.zeroclaw.com

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

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言Rust

技术栈/模型agent,agentic,ai,infra,ml,openclaw,os,zeroclaw

GitHub 星标★ 32983

30天Star增速

HF 下载量

上线时间2026-02-13 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-17

浏览次数0

项目介绍

ZeroClaw 是一个用 Rust 编写的轻量级、全自主 AI 个人助理基础设施，目标是让任何人都能在任意操作系统和平台上快速部署属于自己的 AI 助理。它解决的是现有个人 AI 助理框架体积大、依赖重、绑定特定云服务或平台的问题，通过极小的运行时和模块化设计，让助理可以跑在服务器、树莓派、笔记本甚至边缘设备上。核心能力包括自主任务规划与执行、多步骤工具调用、可插拔的模型与工具后端，以及跨平台的统一部署体验。项目强调“swap anything”，意味着模型、记忆、工具链、消息通道等组件都可以按需替换，避免被单一供应商锁定。Rust 实现带来低内存占用和快速启动，适合长期常驻运行。它面向希望自托管、注重隐私、需要深度定制助理行为的开发者和技术用户，而非开箱即用的消费级产品。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：进阶约 15 分钟部署方式：命令行工具 7 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Rust edition 2024 语言环境（README 徽章标注的 Rust 版本）
支持 systemd / launchctl / Windows Service 的操作系统，用于常驻服务
一个 TOML 配置文件，固定放在 ~/.zeroclaw/config.toml
可选：已登录的 Codex CLI 认证文件 ~/.codex/auth.json

安装与启动步骤

1安装 zeroclaw

README 的 Install 章节为空，未给出任何安装命令。请以官网 zeroclaw.com 或 docs.zeroclaw.com 的安装指引、以及 GitHub Releases 页面为准，先装好 zeroclaw 可执行文件。
2运行一键初始化

执行 quickstart 完成一次性设置：选择一个模型 provider，并自动写出可用的配置文件。
```
zeroclaw quickstart
```
3导入 Codex 认证(可选)

若本机已用 Codex CLI 登录，可直接把认证文件导入，省去手动填 token。
```
zeroclaw auth login --model-provider openai-codex --import ~/.codex/auth.json
```
4指定 provider 初始化

非交互方式指定 openai-codex 作为 provider 和 gpt-5.4 模型，由 quickstart 写入 provider 段。
```
zeroclaw quickstart --model-provider openai-codex --model gpt-5.4
```
5开始交互对话

用 [agents.] 中配置的别名启动交互式聊天。示例配置文件里的别名是 coding。
```
zeroclaw agent -a coding
```
6注册为系统服务

把 ZeroClaw 注册成 systemd / launchctl / Windows Service，便于长期常驻运行。
```
zeroclaw service install
```
7后台常驻启动

让服务在后台一直运行，实现 always-on 的个人助理。
```
zeroclaw service start
```

关键配置

配置项	必填	说明	示例
`config.toml 路径`	是	唯一配置文件，所有 provider、agent、channel 均在此声明	`~/.zeroclaw/config.toml`
`providers.models..`	是	provider 条目，type 为类型、alias 由你自取，至少一个	`[providers.models.openai.coding]`
`model`	是	该 provider 实际调用的模型名	`gpt-5.4`
`wire_api`	否	模型请求使用的 API 形态，如 responses	`responses`
`requires_openai_auth`	否	标记该 provider 使用 OpenAI 认证方式	`true`
`model_provider`	是	agent 引用 provider，写法为类型.别名	`openai.coding`

如何确认成功

运行 zeroclaw auth status 应能正常显示认证信息；执行 zeroclaw agent -a coding 能进入交互聊天，或 zeroclaw service start 后服务已在后台运行，即视为成功。

常见问题

Q：README 的 Install 章节是空的，怎么安装？

A：

Q：提示 provider streaming failed, falling back to non-streaming

A：这不是致命错误：ZeroClaw 会用非流式模式重试同一请求。先执行 zeroclaw auth status 确认认证正常，再去改 provider 配置。

Q：Claude Max 的 setup-token 怎么配？

A：先运行 claude setup-token 生成 token，再在 Quickstart 中选择 setup_token，把生成的 token 粘贴到 API key/token 提示处。

Q：什么时候需要在 provider 条目里写 api_key 或 uri？

A：只有当你明确要指向自定义的 OpenAI 兼容网关或端点时才设置；标准的 OpenAI Codex 订阅认证走的是已存储的 auth profile，不写 api_key。

Q：YOLO mode 是什么，能用吗？

A：README 说明它是用来跳过安全门控的开发模式，建议只在开发机上使用。

注意事项

README 未提供任何安装命令，本教程的安装步骤无法给出确切命令，需以官网/文档/Releases 为准。
配置文件只有一个：~/.zeroclaw/config.toml，不要在别处另建配置。
V3 配置至少需要四个 section：一个 provider 条目、一个引用它的 agent、以及 agent 所依据的风险配置(risk profile)。
provider 认证通常使用存储的 auth profile，而不是在 provider 条目里直接写 api_key。

核心亮点

Rust 实现，内存占用低、启动快，适合树莓派等资源受限设备常驻
组件高度可替换，模型、记忆、工具、通道均可插拔，避免供应商锁定
跨 OS 跨平台部署，覆盖服务器、桌面到边缘设备，自主任务执行链路完整

不足之处

配置与组件替换需要一定技术门槛，非技术用户上手成本较高
生态与文档相对年轻，部分集成和最佳实践仍在快速演进中

适用场景

在树莓派或旧笔记本上自托管一个常驻的私人 AI 助理
企业内部部署可定制、数据不出内网的自主任务代理
开发者基于其模块化架构快速搭建垂直领域 AI 助理产品

替代项目

OpenHands、AutoGPT

上一篇：nullclaw

下一篇：zylos-core