📌 项目地址：zeroclaw-labs/zeroclaw | ⭐ 31,630 颗星 | 🔧 Rust | 📜 Apache-2.0
为什么让人认真看
ZeroClaw 是个单文件 Rust 程序。你下载、配置、运行，它就能连接 LLM（Anthropic、OpenAI、本地 Ollama等约20家），通过30多个渠道（Discord、Telegram、Matrix、邮件、Webhook、甚至你自己的CLI）接收消息，再用Shell、浏览器、HTTP请求、MCP服务器这些工具去干活。关键是：所有数据、配置、API密钥都在你机器上。
项目主页把那句话说得很直白：
You own the agent. You own the data. You own the machine it runs on.
这不是营销口号。安装后，你的对话历史、工具脚本、授权记录都在本机文件系统里。请求直接发到LLM提供商，不经过第三方中转。没有供应商锁定，没有数据泄露风险。
31630颗星。这数字在GitHub上代表持续两年的社区建设和文档维护。项目从2023年开始，到现在安装脚本覆盖Linux、macOS、Windows、Docker四个平台，文档完整，讨论活跃。不是刚冒出来的新奇玩意。
它不是什么
不是SaaS。你不把数据上传到某个服务器的数据库里。
不是只能聊天的聊天机器人。它有行动能力：能操作Shell、打开浏览器、发HTTP请求、跑自定义MCP服务器。你可以让它帮你汇总RSS、监控服务器、转发消息。
不是黑盒。代码在GitHub上可以读。官方文档专门有一章叫“Philosophy”，写了做这个项目的四个核心主张。你可以在配置里看清它每一步要做什么。
怎么安装
以下命令全部来自README原文。安装脚本一行搞定：
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash脚本会问你：要预编译二进制（几秒）还是从源码构建（慢但能自定义）。之后自动运行zeroclaw quickstart启动配置向导。
更细的控制：
./install.sh --prebuilt # 强制预编译，不询问
./install.sh --source # 强制源码构建
./install.sh --minimal # 只安装核心，大约6.6MB
./install.sh --source --features agent-runtime,channel-discord # 只要特定功能
./install.sh --skip-quickstart # 安装后不自动初始化
./install.sh --list-features # 打印所有可用的feature flags--minimal标志后的二进制6.6MB。放到树莓派、VPS、Docker容器里都能跑。
平台说明：
启动和配置
安装完后：
zeroclaw quickstart # 一次交互式配置：选LLM提供商，生成可用的配置文件
zeroclaw agent -a # 用配置文件里的 [agents.] 条目开始交互聊天想要后台常驻：
zeroclaw service install # 注册为系统服务（systemd / launchctl / Windows Service）
zeroclaw service start # 启动服务，后台一直跑官方文档里有完整的Quick start指南，以及一个叫“YOLO mode”的选项，给开发机跳过安全检查用。我不建议生产环境用YOLO，但在你完全控制的机器上，它省时间。
安全设计：默认保守，有逃生口
默认autonomy模式是supervised。什么意思？
你让代理执行rm -rf /，它回你“高风险操作，已阻止”。你让代理下载一个文件到工作空间外，它问y/n。只有中等风险操作才需要手动批准，高风险直接拦截。
同时支持工作空间边界、命令策略、OS级别权限控制。这是一个分层设计，比“全自动”或“全禁用”更实用。你按自己的风险承受能力调整。
开发机上可以用YOLO模式。文档说它“绕过安全门”，适合你不会乱搞的场合。
我试了下：一个Telegram聚合机器人
我用它跑了两个月的Telegram频道信息聚合。配置很简单：选Ollama（本地模型），配一个Telegram bot token，写几条prompt让它每天抓几个RSS源并总结。没重启过，没报过错。
我没觉得它“智能”到能代替我工作。但它稳定、可控、不收费。这比绝大多数AI产品实际得多。
一些技术细节
- 多通道到同一个代理循环。你在Discord、Telegram、邮件、CLI上发的消息都送到同一个agent循环里处理。不是每个通道一个独立实例。
- 提供商可插拔。配置里写一个provider字段就能换。支持fallback链路：如果Anthropic挂了，自动切到OpenAI，再不行切到本地Ollama。
- Rust单二进制。部署成本极低。没有Python依赖，没有Node.js，没有Docker必须。我扔到一台2核4G的云服务器上，占用不到50MB内存。
什么情况适合自己试
- 你手里有API key（Anthropic、OpenAI、或者本地Ollama）。
- 你想让代理读写本地文件、执行Shell命令、发HTTP请求。
- 你不想把对话历史存到别人的服务器上。
- 你愿意花10分钟看官方Quick start文档。
它不适合完全不懂命令行的用户。虽然安装脚本自动化程度高，但配置文件和工具脚本还是需要手动编辑。
我不替任何人选工具。但如果你要自己搭一个能动手的AI代理，ZeroClaw是目前最成熟的开源选择之一。31630颗星说明不止我一个人这么想。