ZeroClaw

用Rust构建的单二进制 AI Agent 基础设施，支持多 Provider、多渠道、可插拔工具与记忆后端，默认安全边界。

15.6kRustMIT

项目简介

ZeroClaw 把“可控的智能体执行环境”做成一个几 MB 的单二进制：通过 trait 驱动的可插拔子系统，把模型 Provider、消息 Channel、工具 Tool、记忆 Memory、隧道 Tunnel、观测 Observer 都变成配置级替换，避免把业务逻辑绑死在某个 SDK 或平台。它同时把安全当作默认姿态：网关本地绑定与配对鉴权、严格 allowlist、工作区作用域与可选 Docker 沙箱，让自托管智能体在可控边界内执行命令与读写文件。记忆系统走“本地全栈搜索引擎”路线：以 SQLite 的 FTS5 + 向量相似度做混合检索，并可切换到 PostgreSQL 作为远端持久化后端，适合从个人终端助手一路扩展到团队级自动化运行时。

痛点 vs 创新

✕传统痛点	✓创新方案
传统智能体运行时往往依赖厚重的语言运行时与多进程组合，冷启动慢、占用大，低配设备与边缘部署不友好。	单二进制 + trait 可插拔，把 Provider/Channel/Tool/Memory/Tunnel 变成配置级替换，减少工程耦合与供应商锁定。
安全边界经常后置：网关暴露、命令/文件权限不清晰，导致自托管时需要额外补一层“安全外壳”。	安全默认开启：本地绑定、配对鉴权、allowlist、工作区作用域与可选 Docker 沙箱，让执行能力可审计、可收敛。

架构深度解析

Trait 驱动的可替换内核

把 Provider、Channel、Tool、Memory、Tunnel、Observer 等子系统抽象为 trait，并提供内置实现与别名目录；运行时通过配置选择实现，从“写代码集成”变成“换配置拼装”。

本地优先的网关与安全策略

网关默认绑定 127.0.0.1，并用一次性配对码换取 Bearer Token；通道侧按 allowlist 进行来信控制，工具侧用工作区作用域、禁用路径与命令白名单收敛能力，必要时再用 Docker 运行适配器隔离执行环境。

全栈记忆检索引擎（可选 Postgres）

默认以 SQLite 承载关键词检索（FTS5/BM25）与向量相似度（BLOB + cosine），再用加权融合排序实现混合召回；当需要远端持久化或多实例共享时，可切换 PostgreSQL 作为存储后端。

部署指南

1. 一键安装（适合新机器或低配主机）

bash

1curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash

2. 从源码构建（需要 Rust 工具链）

bash

1git clone https://github.com/zeroclaw-labs/zeroclaw.git && cd zeroclaw && cargo build --release --locked

3. 初始化运行配置并绑定模型 Provider（通常需要 API Key）

bash

1./target/release/zeroclaw onboard --interactive

4. 启动长期运行的自治运行时或网关（按需二选一）

bash

1./target/release/zeroclaw daemon  # 或 ./target/release/zeroclaw gateway

落地场景

核心场景	目标人群	解决方案	最终收益
团队自托管的多渠道研发助手	研发团队与工具平台组	把 CLI/Telegram/Discord/Slack 的消息入口接到同一运行时，统一工具执行与权限边界	让日常排障、脚本化操作与知识沉淀在可审计的自治流程内闭环
低配设备上的边缘自动化代理	做工厂/门店/家庭实验的工程师	在树莓派/小型云主机上跑单二进制 agent，执行本地命令、采集状态并回传	用更低成本获得稳定的常驻自动化能力
可插拔记忆的业务流程机器人	需要长期上下文的业务运营与支持团队	用 SQLite 混合检索做本地记忆，并在增长后切到 PostgreSQL 共享存储	在不改应用逻辑的前提下，实现从个人记忆到团队记忆的平滑迁移

避坑指南

多数功能要跑通需要配置模型 Provider 的 API Key 或订阅认证信息；建议把密钥管理与审计纳入你的平台基建。
编译从源码需要一定磁盘与内存预算；在低配机器上更适合优先使用预编译发布包或一键脚本。

常见问题

怎么在不改代码的情况下切换模型供应商？▾

把 Provider 当成配置项：选择 OpenAI 兼容或自定义端点即可完成切换；工具与通道保持不变，重点是固定你的提示词协议与工具接口。

如何把记忆从本地 SQLite 扩展到 PostgreSQL？▾

先用 SQLite 跑通混合检索与 autosave，再把存储 provider 切到 PostgreSQL 并指定 schema/table；迁移时先 dry-run 做安全预览，确认索引与权限后再切流量。

如何把网关安全地对外提供服务？▾

保持默认本地绑定，使用隧道把入口变成“显式暴露”，例如 Tailscale 或 Cloudflare；再用配对鉴权、allowlist 与最小化工具权限把攻击面收敛到可控范围。

项目简介

痛点 vs 创新

✕传统痛点	✓创新方案
传统智能体运行时往往依赖厚重的语言运行时与多进程组合，冷启动慢、占用大，低配设备与边缘部署不友好。	单二进制 + trait 可插拔，把 Provider/Channel/Tool/Memory/Tunnel 变成配置级替换，减少工程耦合与供应商锁定。
安全边界经常后置：网关暴露、命令/文件权限不清晰，导致自托管时需要额外补一层“安全外壳”。	安全默认开启：本地绑定、配对鉴权、allowlist、工作区作用域与可选 Docker 沙箱，让执行能力可审计、可收敛。

架构深度解析

Trait 驱动的可替换内核

本地优先的网关与安全策略

全栈记忆检索引擎（可选 Postgres）

部署指南

1. 一键安装（适合新机器或低配主机）

bash

1curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash

2. 从源码构建（需要 Rust 工具链）

bash

1git clone https://github.com/zeroclaw-labs/zeroclaw.git && cd zeroclaw && cargo build --release --locked

3. 初始化运行配置并绑定模型 Provider（通常需要 API Key）

bash

1./target/release/zeroclaw onboard --interactive

4. 启动长期运行的自治运行时或网关（按需二选一）

bash

1./target/release/zeroclaw daemon  # 或 ./target/release/zeroclaw gateway

落地场景

核心场景	目标人群	解决方案	最终收益
团队自托管的多渠道研发助手	研发团队与工具平台组	把 CLI/Telegram/Discord/Slack 的消息入口接到同一运行时，统一工具执行与权限边界	让日常排障、脚本化操作与知识沉淀在可审计的自治流程内闭环
低配设备上的边缘自动化代理	做工厂/门店/家庭实验的工程师	在树莓派/小型云主机上跑单二进制 agent，执行本地命令、采集状态并回传	用更低成本获得稳定的常驻自动化能力
可插拔记忆的业务流程机器人	需要长期上下文的业务运营与支持团队	用 SQLite 混合检索做本地记忆，并在增长后切到 PostgreSQL 共享存储	在不改应用逻辑的前提下，实现从个人记忆到团队记忆的平滑迁移

常见问题

怎么在不改代码的情况下切换模型供应商？▾

把 Provider 当成配置项：选择 OpenAI 兼容或自定义端点即可完成切换；工具与通道保持不变，重点是固定你的提示词协议与工具接口。

如何把记忆从本地 SQLite 扩展到 PostgreSQL？▾

先用 SQLite 跑通混合检索与 autosave，再把存储 provider 切到 PostgreSQL 并指定 schema/table；迁移时先 dry-run 做安全预览，确认索引与权限后再切流量。

如何把网关安全地对外提供服务？▾

保持默认本地绑定，使用隧道把入口变成“显式暴露”，例如 Tailscale 或 Cloudflare；再用配对鉴权、allowlist 与最小化工具权限把攻击面收敛到可控范围。

ZeroClaw

项目简介

痛点 vs 创新

架构深度解析

部署指南

1. 一键安装（适合新机器或低配主机）

2. 从源码构建（需要 Rust 工具链）

3. 初始化运行配置并绑定模型 Provider（通常需要 API Key）

4. 启动长期运行的自治运行时或网关（按需二选一）

落地场景

避坑指南

常见问题

ZeroClaw

项目简介

痛点 vs 创新

架构深度解析

部署指南

1. 一键安装（适合新机器或低配主机）

2. 从源码构建（需要 Rust 工具链）

3. 初始化运行配置并绑定模型 Provider（通常需要 API Key）

4. 启动长期运行的自治运行时或网关（按需二选一）

落地场景

避坑指南

常见问题

相关项目