Repolode
zeroclaw-labs

zeroclaw-labs/zeroclaw

一个用 Rust 编写、运行在自己机器上的个人 AI 助手运行时,连接大模型、聊天渠道、工具与硬件。

Star
33,024
Fork
4,985
未关闭 Issue
1,035
最近提交
3小时前

这是什么?

ZeroClaw 是一个以单一 Rust 二进制文件形式运行在本机上的 AI 智能体运行时。它可以接入 Anthropic、OpenAI、Ollama 等大模型服务,并通过 Discord、Telegram、Matrix、邮件、Webhook 和命令行等渠道接收消息,再借助 shell、浏览器、HTTP 以及 GPIO、I2C、SPI 等硬件接口执行操作。

默认的 supervised 自主模式下,中风险操作需要人工审批,高风险操作会被拦截。项目还提供工作区边界、命令策略和操作系统级沙箱(Landlock、Bubblewrap、Seatbelt、Docker),以及包含聊天、记忆浏览、配置编辑和定时任务管理的 Web 控制台。事件触发的 SOP 流程、通过 JSON-RPC 与编辑器集成等能力也都包含在内。

所有配置集中在一个 TOML 文件中,项目提供交互式快速配置,并可注册为 systemd、launchctl 或 Windows 服务长期运行。

核心功能

  • 01对接 Anthropic、OpenAI、Ollama 及兼容 OpenAI 接口的模型服务,支持回退链。
  • 02通过同一个智能体循环统一处理 Discord、Telegram、Matrix、邮件、Webhook 和命令行消息。
  • 03默认 supervised 模式,中风险操作需审批,高风险操作直接拦截。
  • 04工具可在 Landlock、Bubblewrap、Seatbelt、Docker 等系统级沙箱中运行。
  • 05提供 HTTP/WebSocket 网关和 Web 控制台,用于聊天、记忆、配置和定时任务管理。
  • 06支持由 MQTT、Webhook、定时任务或外设事件触发的 SOP 流程。

适用场景

  • 在自己的机器上运行个人助手,通过 Telegram 或 Discord 与其对话。
  • 借助自然语言指令控制树莓派或单片机等硬件。
  • 将本地 Ollama 模型接入聊天渠道,数据无需交给托管服务。
  • 通过 Agent Client Protocol 把智能体集成到编辑器中。

快速上手

  1. 1

    运行 README 中的官方安装脚本

  2. 2

    运行引导式设置,选择模型提供商并生成配置

    "${CARGO_HOME:-$HOME/.cargo}/bin/zeroclaw" quickstart
  3. 3

    与已配置的代理开始交互式聊天

    zeroclaw agent -a <alias>

使用前须知

  • 设置代理需要 LLM 提供商的 API 密钥,或本地模型服务(如 Ollama)。
  • 配置使用多段落的 TOML 文件,初始设置需要一定精力。

标签

常见问题

zeroclaw 是什么?
一个用 Rust 编写、运行在自己机器上的个人 AI 助手运行时,连接大模型、聊天渠道、工具与硬件。 ZeroClaw 是一个以单一 Rust 二进制文件形式运行在本机上的 AI 智能体运行时。它可以接入 Anthropic、OpenAI、Ollama 等大模型服务,并通过 Discord、Telegram、Matrix、邮件、Webhook 和命令行等渠道接收消息,再借助 shell、浏览器、HTTP 以及 GPIO、I2C、SPI 等硬件接口执行操作。
zeroclaw 可以免费使用吗?用的什么许可证?
zeroclaw 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
zeroclaw 还在维护吗?
活跃维护中。zeroclaw 最近一次提交是在 2026年10月22日。
zeroclaw 适合用来做什么?
在自己的机器上运行个人助手,通过 Telegram 或 Discord 与其对话。 借助自然语言指令控制树莓派或单片机等硬件。 将本地 Ollama 模型接入聊天渠道,数据无需交给托管服务。 通过 Agent Client Protocol 把智能体集成到编辑器中。
zeroclaw 怎么安装和运行?
运行 README 中的官方安装脚本 运行引导式设置,选择模型提供商并生成配置: "${CARGO_HOME:-$HOME/.cargo}/bin/zeroclaw" quickstart 与已配置的代理开始交互式聊天: zeroclaw agent -a <alias>
在哪里获取 zeroclaw?
源代码和安装说明在 GitHub 上:https://github.com/zeroclaw-labs/zeroclaw

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目