用 Go 编写的轻量级自托管 AI 智能体,部署在服务器上,通过 Telegram 与你交互。
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
运行 README 中的官方安装脚本
- 2
运行引导式设置,选择模型提供商并生成配置
"${CARGO_HOME:-$HOME/.cargo}/bin/zeroclaw" quickstart - 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 数据每日更新。
相关项目
一个用 YAML 构建智能体工作流的自动化平台,可跨对话渠道运行,支持工具、MCP、记忆与 RAG。
可自托管的个人 AI 助手,以单个 Go 二进制文件提供 LLM 对话、RAG 知识库和代理循环能力。
可本地或云端部署的个人 AI 助手,支持钉钉、飞书、Discord、Telegram 等多种聊天渠道。
开源个人 AI 助理与 Agent Harness,可规划任务、调用工具与技能,并支持记忆与多渠道接入。
开源多智能体 AI 助手,可在网页、桌面、文件及 Telegram、飞书、企业微信等聊天应用中执行任务。