[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-zeroclaw-labs--zeroclaw":3,"tool-zeroclaw-labs--zeroclaw":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",160015,2,"2026-04-18T11:30:52",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":87,"forks":88,"last_commit_at":89,"license":90,"difficulty_score":32,"env_os":91,"env_gpu":92,"env_ram":93,"env_deps":94,"category_tags":99,"github_topics":100,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":107,"updated_at":108,"faqs":109,"releases":110},9297,"zeroclaw-labs\u002Fzeroclaw","zeroclaw","Fast, small, and fully autonomous AI personal assistant infrastructure, ANY OS, ANY PLATFORM — deploy anywhere, swap anything 🦀","ZeroClaw 是一款极速、轻量且完全自主的个人 AI 助手基础设施，旨在让你在自己的设备上轻松部署专属智能助理。它解决了传统 AI 助手依赖云端、隐私难保障以及硬件成本高昂的痛点，支持在任意操作系统和平台上运行，并能无缝接入你日常使用的沟通渠道，如微信、钉钉、Telegram、Discord、邮件及各类社交媒体，让你在一个统一的界面中管理所有对话。\n\n无论是希望保护数据隐私的普通用户，还是想要低成本搭建本地 AI 服务的开发者或技术爱好者，ZeroClaw 都是理想选择。其最大的技术亮点在于极致的资源优化：基于 Rust 语言构建，内存占用不到 5MB，仅需 10 美元的廉价硬件即可流畅运行，相比同类方案节省了大量内存与资金成本。此外，它具备高度模块化设计，支持灵活替换组件，真正实现了“零开销、零妥协”。由哈佛、MIT 等高校社区成员共同开发，ZeroClaw 以开源精神推动个人 AI 的普及，让每个人都能拥有安全、可控且高效的智能伙伴。","\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_a2d7706f6e4f.png\" alt=\"ZeroClaw\" width=\"600\" \u002F>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">🦀 ZeroClaw — Personal AI Assistant\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>Zero overhead. Zero compromise. 100% Rust. 100% Agnostic.\u003C\u002Fstrong>\u003Cbr>\n  ⚡️ \u003Cstrong>Runs on $10 hardware with \u003C5MB RAM: That's 99% less memory than OpenClaw and 98% cheaper than a Mac mini!\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Factions\u002Fworkflows\u002Fci-run.yml\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fci-run.yml?branch=master&label=build\" alt=\"Build Status\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"LICENSE-APACHE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT%20OR%20Apache%202.0-blue.svg\" alt=\"License: MIT OR Apache-2.0\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.rust-lang.org\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Frust-edition%202024-orange?logo=rust\" alt=\"Rust Edition 2024\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Freleases\u002Flatest\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-v0.7.0-blue\" alt=\"Version v0.7.0\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fgraphs\u002Fcontributors\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fzeroclaw-labs\u002Fzeroclaw?color=green\" alt=\"Contributors\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fx.com\u002Fzeroclawlabs?s=21\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FX-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white\" alt=\"X: @zeroclawlabs\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002FwDshRVqRjx\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?style=flat&logo=discord&logoColor=white\" alt=\"Discord\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.reddit.com\u002Fr\u002Fzeroclawlabs\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FReddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white\" alt=\"Reddit: r\u002Fzeroclawlabs\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\nBuilt by students and members of the Harvard, MIT, and Sundai.Club communities.\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  🌐 \u003Cstrong>Languages:\u003C\u002Fstrong>\n  \u003Ca href=\"README.md\">🇺🇸 English\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fzh-CN\u002FREADME.md\">🇨🇳 简体中文\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fja\u002FREADME.md\">🇯🇵 日本語\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fko\u002FREADME.md\">🇰🇷 한국어\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fvi\u002FREADME.md\">🇻🇳 Tiếng Việt\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Ftl\u002FREADME.md\">🇵🇭 Tagalog\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fes\u002FREADME.md\">🇪🇸 Español\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fpt\u002FREADME.md\">🇧🇷 Português\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fit\u002FREADME.md\">🇮🇹 Italiano\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fde\u002FREADME.md\">🇩🇪 Deutsch\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Ffr\u002FREADME.md\">🇫🇷 Français\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Far\u002FREADME.md\">🇸🇦 العربية\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fhi\u002FREADME.md\">🇮🇳 हिन्दी\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fru\u002FREADME.md\">🇷🇺 Русский\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fbn\u002FREADME.md\">🇧🇩 বাংলা\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fhe\u002FREADME.md\">🇮🇱 עברית\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fpl\u002FREADME.md\">🇵🇱 Polski\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fcs\u002FREADME.md\">🇨🇿 Čeština\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fnl\u002FREADME.md\">🇳🇱 Nederlands\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Ftr\u002FREADME.md\">🇹🇷 Türkçe\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fuk\u002FREADME.md\">🇺🇦 Українська\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fid\u002FREADME.md\">🇮🇩 Bahasa Indonesia\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fth\u002FREADME.md\">🇹🇭 ไทย\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fur\u002FREADME.md\">🇵🇰 اردو\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fro\u002FREADME.md\">🇷🇴 Română\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fsv\u002FREADME.md\">🇸🇪 Svenska\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fel\u002FREADME.md\">🇬🇷 Ελληνικά\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fhu\u002FREADME.md\">🇭🇺 Magyar\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Ffi\u002FREADME.md\">🇫🇮 Suomi\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fda\u002FREADME.md\">🇩🇰 Dansk\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fnb\u002FREADME.md\">🇳🇴 Norsk\u003C\u002Fa>\n\u003C\u002Fp>\n\nZeroClaw is a personal AI assistant you run on your own devices. It answers you on the channels you already use (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, and more). It has a web dashboard for real-time control and can connect to hardware peripherals (ESP32, STM32, Arduino, Raspberry Pi). The Gateway is just the control plane — the product is the assistant.\n\nIf you want a personal, single-user assistant that feels local, fast, and always-on, this is it.\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fzeroclawlabs.ai\">Website\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002FREADME.md\">Docs\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Farchitecture.md\">Architecture\u003C\u002Fa> ·\n  \u003Ca href=\"#quick-start\">Getting Started\u003C\u002Fa> ·\n  \u003Ca href=\"#migrating-from-openclaw\">Migrating from OpenClaw\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fops\u002Ftroubleshooting.md\">Troubleshoot\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002FwDshRVqRjx\">Discord\u003C\u002Fa>\n\u003C\u002Fp>\n\n> **Preferred setup:** run `zeroclaw onboard` in your terminal. ZeroClaw Onboard guides you step by step through setting up the gateway, workspace, channels, and provider. It is the recommended setup path and works on macOS, Linux, and Windows (via WSL2). New install? Start here: [Getting started](#quick-start)\n\n### Subscription Auth (OAuth)\n\n- **OpenAI Codex** (ChatGPT subscription)\n- **Gemini** (Google OAuth)\n- **Anthropic** (API key or auth token)\n\nModel note: while many providers\u002Fmodels are supported, for the best experience use the strongest latest-generation model available to you. See [Onboarding](#quick-start).\n\nModels config + CLI: [Providers reference](docs\u002Freference\u002Fapi\u002Fproviders-reference.md)\nAuth profile rotation (OAuth vs API keys) + failover: [Model failover](docs\u002Freference\u002Fapi\u002Fproviders-reference.md)\n\n## Install (recommended)\n\nRuntime: Rust stable toolchain. Single binary, no runtime dependencies.\n\n### Homebrew (macOS\u002FLinuxbrew)\n\n```bash\nbrew install zeroclaw\n```\n\n### One-click bootstrap\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw.git\ncd zeroclaw\n.\u002Finstall.sh\n```\n\n`zeroclaw onboard` runs automatically after install to configure your workspace and provider.\n\n## Quick start (TL;DR)\n\nFull beginner guide (auth, pairing, channels): [Getting started](docs\u002Fsetup-guides\u002Fone-click-bootstrap.md)\n\n```bash\n# Install + onboard\n.\u002Finstall.sh\n\n# Start the gateway (webhook server + web dashboard)\nzeroclaw gateway                # default: 127.0.0.1:42617\nzeroclaw gateway --port 0       # random port (security hardened)\n\n# Talk to the assistant\nzeroclaw agent -m \"Hello, ZeroClaw!\"\n\n# Interactive mode\nzeroclaw agent\n\n# Start full autonomous runtime (gateway + channels + cron + hands)\nzeroclaw daemon\n\n# Check status\nzeroclaw status\n\n# Run diagnostics\nzeroclaw doctor\n```\n\nUpgrading? Run `zeroclaw doctor` after updating.\n\n### From source (development)\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw.git\ncd zeroclaw\n\ncargo build --release --locked\ncargo install --path . --force --locked\n\nzeroclaw onboard\n```\n\n> **Dev fallback (no global install):** prefix commands with `cargo run --release --` (example: `cargo run --release -- status`).\n\n## Migrating from OpenClaw\n\nZeroClaw can import your OpenClaw workspace, memory, and configuration:\n\n```bash\n# Preview what will be migrated (safe, read-only)\nzeroclaw migrate openclaw --dry-run\n\n# Run the migration\nzeroclaw migrate openclaw\n```\n\nThis migrates your memory entries, workspace files, and configuration from `~\u002F.openclaw\u002F` to `~\u002F.zeroclaw\u002F`. Config is converted from JSON to TOML automatically.\n\n## Security defaults (DM access)\n\nZeroClaw connects to real messaging surfaces. Treat inbound DMs as untrusted input.\n\nFull security guide: [SECURITY.md](SECURITY.md)\n\nDefault behavior on all channels:\n\n- **DM pairing** (default): unknown senders receive a short pairing code and the bot does not process their message.\n- Approve with: `zeroclaw pairing approve \u003Cchannel> \u003Ccode>` (then the sender is added to a local allowlist).\n- Public inbound DMs require an explicit opt-in in `config.toml`.\n- Run `zeroclaw doctor` to surface risky or misconfigured DM policies.\n\n**Autonomy levels:**\n\n| Level | Behavior |\n|-------|----------|\n| `ReadOnly` | Agent can observe but not act |\n| `Supervised` (default) | Agent acts with approval for medium\u002Fhigh risk operations |\n| `Full` | Agent acts autonomously within policy bounds |\n\n**Sandboxing layers:** workspace isolation, path traversal blocking, command allowlisting, forbidden paths (`\u002Fetc`, `\u002Froot`, `~\u002F.ssh`), rate limiting (max actions\u002Fhour, cost\u002Fday caps).\n\n\u003C!-- BEGIN:WHATS_NEW -->\n\u003C!-- END:WHATS_NEW -->\n\n### 📢 Announcements\n\nUse this board for important notices (breaking changes, security advisories, maintenance windows, and release blockers).\n\n| Date (UTC) | Level       | Notice                                                                                                                                                                                                                                                                                                                                                 | Action                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |\n| ---------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| 2026-02-19 | _Critical_  | We are **not affiliated** with `openagen\u002Fzeroclaw`, `zeroclaw.org` or `zeroclaw.net`. The `zeroclaw.org` and `zeroclaw.net` domains currently points to the `openagen\u002Fzeroclaw` fork, and that domain\u002Frepository are impersonating our official website\u002Fproject.                                                                                       | Do not trust information, binaries, fundraising, or announcements from those sources. Use only [this repository](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw) and our verified social accounts.                                                                                                                                                                                                                                                                                                                                                                                                                       |\n| 2026-02-21 | _Important_ | Our official website is now live: [zeroclawlabs.ai](https:\u002F\u002Fzeroclawlabs.ai). Thanks for your patience while we prepared the launch. We are still seeing impersonation attempts, so do **not** join any investment or fundraising activity claiming the ZeroClaw name unless it is published through our official channels.                            | Use [this repository](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw) as the single source of truth. Follow [X (@zeroclawlabs)](https:\u002F\u002Fx.com\u002Fzeroclawlabs?s=21), [Facebook (Group)](https:\u002F\u002Fwww.facebook.com\u002Fgroups\u002Fzeroclawlabs), and [Reddit (r\u002Fzeroclawlabs)](https:\u002F\u002Fwww.reddit.com\u002Fr\u002Fzeroclawlabs\u002F) for official updates. |\n| 2026-02-19 | _Important_ | Anthropic updated the Authentication and Credential Use terms on 2026-02-19. Claude Code OAuth tokens (Free, Pro, Max) are intended exclusively for Claude Code and Claude.ai; using OAuth tokens from Claude Free\u002FPro\u002FMax in any other product, tool, or service (including Agent SDK) is not permitted and may violate the Consumer Terms of Service. | Please temporarily avoid Claude Code OAuth integrations to prevent potential loss. Original clause: [Authentication and Credential Use](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Flegal-and-compliance#authentication-and-credential-use).                                                                                                                                                                                                                                                                                                                                                                                    |\n\n## Highlights\n\n- **Lean Runtime by Default** — common CLI and status workflows run in a few-megabyte memory envelope on release builds.\n- **Cost-Efficient Deployment** — designed for $10 boards and small cloud instances, no heavyweight runtime dependencies.\n- **Fast Cold Starts** — single-binary Rust runtime keeps command and daemon startup near-instant.\n- **Portable Architecture** — one binary across ARM, x86, and RISC-V with swappable providers\u002Fchannels\u002Ftools.\n- **Local-first Gateway** — single control plane for sessions, channels, tools, cron, SOPs, and events.\n- **Multi-channel inbox** — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket, and more.\n- **Multi-agent orchestration (Hands)** — autonomous agent swarms that run on schedule and grow smarter over time.\n- **Standard Operating Procedures (SOPs)** — event-driven workflow automation with MQTT, webhook, cron, and peripheral triggers.\n- **Web Dashboard** — React 19 + Vite web UI with real-time chat, memory browser, config editor, cron manager, and tool inspector.\n- **Hardware peripherals** — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO via the `Peripheral` trait.\n- **First-class tools** — shell, file I\u002FO, browser, git, web fetch\u002Fsearch, MCP, Jira, Notion, Google Workspace, and 70+ more.\n- **Lifecycle hooks** — intercept and modify LLM calls, tool executions, and messages at every stage.\n- **Skills platform** — bundled, community, and workspace skills with security auditing.\n- **Tunnel support** — Cloudflare, Tailscale, ngrok, OpenVPN, and custom tunnels for remote access.\n\n### Why teams pick ZeroClaw\n\n- **Lean by default:** small Rust binary, fast startup, low memory footprint.\n- **Secure by design:** pairing, strict sandboxing, explicit allowlists, workspace scoping.\n- **Fully swappable:** core systems are traits (providers, channels, tools, memory, tunnels).\n- **No lock-in:** OpenAI-compatible provider support + pluggable custom endpoints.\n\n## Benchmark Snapshot (ZeroClaw vs OpenClaw, Reproducible)\n\nLocal machine quick benchmark (macOS arm64, Feb 2026) normalized for 0.8GHz edge hardware.\n\n|                           | OpenClaw      | NanoBot        | PicoClaw        | ZeroClaw 🦀          |\n| ------------------------- | ------------- | -------------- | --------------- | -------------------- |\n| **Language**              | TypeScript    | Python         | Go              | **Rust**             |\n| **RAM**                   | > 1GB         | > 100MB        | \u003C 10MB          | **\u003C 5MB**            |\n| **Startup (0.8GHz core)** | > 500s        | > 30s          | \u003C 1s            | **\u003C 10ms**           |\n| **Binary Size**           | ~28MB (dist)  | N\u002FA (Scripts)  | ~8MB            | **~8.8 MB**          |\n| **Cost**                  | Mac Mini $599 | Linux SBC ~$50 | Linux Board $10 | **Any hardware $10** |\n\n> Notes: ZeroClaw results are measured on release builds using `\u002Fusr\u002Fbin\u002Ftime -l`. OpenClaw requires Node.js runtime (typically ~390MB additional memory overhead), while NanoBot requires Python runtime. PicoClaw and ZeroClaw are static binaries. The RAM figures above are runtime memory; build-time compilation requirements are higher.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_b7c714b15444.jpeg\" alt=\"ZeroClaw vs OpenClaw Comparison\" width=\"800\" \u002F>\n\u003C\u002Fp>\n\n### Reproducible local measurement\n\n```bash\ncargo build --release\nls -lh target\u002Frelease\u002Fzeroclaw\n\n\u002Fusr\u002Fbin\u002Ftime -l target\u002Frelease\u002Fzeroclaw --help\n\u002Fusr\u002Fbin\u002Ftime -l target\u002Frelease\u002Fzeroclaw status\n```\n\n## Everything we built so far\n\n### Core platform\n\n- Gateway HTTP\u002FWS\u002FSSE control plane with sessions, presence, config, cron, webhooks, web dashboard, and pairing.\n- CLI surface: `gateway`, `agent`, `onboard`, `doctor`, `status`, `service`, `migrate`, `auth`, `cron`, `channel`, `skills`.\n- Agent orchestration loop with tool dispatch, prompt construction, message classification, and memory loading.\n- Session model with security policy enforcement, autonomy levels, and approval gating.\n- Resilient provider wrapper with failover, retry, and model routing across 20+ LLM backends.\n\n### Channels\n\nChannels: WhatsApp (native), Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, DingTalk, Lark, Mattermost, Nextcloud Talk, Nostr, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WATI, Mochat, Linq, Notion, WebSocket, ClawdTalk.\n\nFeature-gated: Matrix (`channel-matrix`), Lark (`channel-lark`), Nostr (`channel-nostr`).\n\n### Web dashboard\n\nReact 19 + Vite 6 + Tailwind CSS 4 web dashboard served directly from the Gateway:\n\n- **Dashboard** — system overview, health status, uptime, cost tracking\n- **Agent Chat** — interactive chat with the agent\n- **Memory** — browse and manage memory entries\n- **Config** — view and edit configuration\n- **Cron** — manage scheduled tasks\n- **Tools** — browse available tools\n- **Logs** — view agent activity logs\n- **Cost** — token usage and cost tracking\n- **Doctor** — system health diagnostics\n- **Integrations** — integration status and setup\n- **Pairing** — device pairing management\n\n### Firmware targets\n\n| Target | Platform | Purpose |\n|--------|----------|---------|\n| ESP32 | Espressif ESP32 | Wireless peripheral agent |\n| ESP32-UI | ESP32 + Display | Agent with visual interface |\n| STM32 Nucleo | STM32 (ARM Cortex-M) | Industrial peripheral |\n| Arduino | Arduino | Basic sensor\u002Factuator bridge |\n| Uno Q Bridge | Arduino Uno | Serial bridge to agent |\n\n### Tools + automation\n\n- **Core:** shell, file read\u002Fwrite\u002Fedit, git operations, glob search, content search\n- **Web:** browser control, web fetch, web search, screenshot, image info, PDF read\n- **Integrations:** Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover, Weather (wttr.in)\n- **MCP:** Model Context Protocol tool wrapper + deferred tool sets\n- **Scheduling:** cron add\u002Fremove\u002Fupdate\u002Frun, schedule tool\n- **Memory:** recall, store, forget, knowledge, project intel\n- **Advanced:** delegate (agent-to-agent), swarm, model switch\u002Frouting, security ops, cloud ops\n- **Hardware:** board info, memory map, memory read (feature-gated)\n\n### Runtime + safety\n\n- **Autonomy levels:** ReadOnly, Supervised (default), Full.\n- **Sandboxing:** workspace isolation, path traversal blocking, command allowlists, forbidden paths, Landlock (Linux), Bubblewrap.\n- **Rate limiting:** max actions per hour, max cost per day (configurable).\n- **Approval gating:** interactive approval for medium\u002Fhigh risk operations.\n- **E-stop:** emergency shutdown capability.\n- **129+ security tests** in automated CI.\n\n### Ops + packaging\n\n- Web dashboard served directly from the Gateway.\n- Tunnel support: Cloudflare, Tailscale, ngrok, OpenVPN, custom command.\n- Docker runtime adapter for containerized execution.\n- CI\u002FCD: beta (auto on push) → stable (manual dispatch) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.\n- Pre-built binaries for Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).\n\n\n## Configuration\n\nMinimal `~\u002F.zeroclaw\u002Fconfig.toml`:\n\n```toml\ndefault_provider = \"anthropic\"\napi_key = \"sk-ant-...\"\n```\n\nFull configuration reference: [docs\u002Freference\u002Fapi\u002Fconfig-reference.md](docs\u002Freference\u002Fapi\u002Fconfig-reference.md).\n\n### Channel configuration\n\n**Telegram:**\n```toml\n[channels.telegram]\nbot_token = \"123456:ABC-DEF...\"\n```\n\n**Discord:**\n```toml\n[channels.discord]\ntoken = \"your-bot-token\"\n```\n\n**Slack:**\n```toml\n[channels.slack]\nbot_token = \"xoxb-...\"\napp_token = \"xapp-...\"\n```\n\n**WhatsApp:**\n```toml\n[channels.whatsapp]\nenabled = true\n```\n\n**Matrix:**\n```toml\n[channels.matrix]\nhomeserver_url = \"https:\u002F\u002Fmatrix.org\"\nusername = \"@bot:matrix.org\"\npassword = \"...\"\n```\n\n**Signal:**\n```toml\n[channels.signal]\nphone_number = \"+1234567890\"\n```\n\n### Tunnel configuration\n\n```toml\n[tunnel]\nkind = \"cloudflare\"  # or \"tailscale\", \"ngrok\", \"openvpn\", \"custom\", \"none\"\n```\n\nDetails: [Channel reference](docs\u002Freference\u002Fapi\u002Fchannels-reference.md) · [Config reference](docs\u002Freference\u002Fapi\u002Fconfig-reference.md)\n\n### Runtime support (current)\n\n- **`native`** (default) — direct process execution, fastest path, ideal for trusted environments.\n- **`docker`** — full container isolation, enforced security policies, requires Docker.\n\nSet `runtime.kind = \"docker\"` for strict sandboxing or network isolation.\n\n## Subscription Auth (OpenAI Codex \u002F Claude Code \u002F Gemini)\n\nZeroClaw supports subscription-native auth profiles (multi-account, encrypted at rest).\n\n- Store file: `~\u002F.zeroclaw\u002Fauth-profiles.json`\n- Encryption key: `~\u002F.zeroclaw\u002F.secret_key`\n- Profile id format: `\u003Cprovider>:\u003Cprofile_name>` (example: `openai-codex:work`)\n\n```bash\n# OpenAI Codex OAuth (ChatGPT subscription)\nzeroclaw auth login --provider openai-codex --device-code\n\n# Gemini OAuth\nzeroclaw auth login --provider gemini --profile default\n\n# Anthropic setup-token\nzeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization\n\n# Check \u002F refresh \u002F switch profile\nzeroclaw auth status\nzeroclaw auth refresh --provider openai-codex --profile default\nzeroclaw auth use --provider openai-codex --profile work\n\n# Run the agent with subscription auth\nzeroclaw agent --provider openai-codex -m \"hello\"\nzeroclaw agent --provider anthropic -m \"hello\"\n```\n\n## Agent workspace + skills\n\nWorkspace root: `~\u002F.zeroclaw\u002Fworkspace\u002F` (configurable via config).\n\nInjected prompt files:\n- `IDENTITY.md` — agent personality and role\n- `USER.md` — user context and preferences\n- `MEMORY.md` — long-term facts and lessons\n- `AGENTS.md` — session conventions and initialization rules\n- `SOUL.md` — core identity and operating principles\n\nSkills: `~\u002F.zeroclaw\u002Fworkspace\u002Fskills\u002F\u003Cskill>\u002FSKILL.md` or `SKILL.toml`.\n\n```bash\n# List installed skills\nzeroclaw skills list\n\n# Install from git\nzeroclaw skills install https:\u002F\u002Fgithub.com\u002Fuser\u002Fmy-skill.git\n\n# Security audit before install\nzeroclaw skills audit https:\u002F\u002Fgithub.com\u002Fuser\u002Fmy-skill.git\n\n# Remove a skill\nzeroclaw skills remove my-skill\n```\n\n## CLI commands\n\n```bash\n# Workspace management\nzeroclaw onboard              # Guided setup wizard\nzeroclaw status               # Show daemon\u002Fagent status\nzeroclaw doctor               # Run system diagnostics\n\n# Gateway + daemon\nzeroclaw gateway              # Start gateway server (127.0.0.1:42617)\nzeroclaw daemon               # Start full autonomous runtime\n\n# Agent\nzeroclaw agent                # Interactive chat mode\nzeroclaw agent -m \"message\"   # Single message mode\n\n# Service management\nzeroclaw service install      # Install as OS service (launchd\u002Fsystemd)\nzeroclaw service start|stop|restart|status\n\n# Channels\nzeroclaw channel list         # List configured channels\nzeroclaw channel doctor       # Check channel health\nzeroclaw channel bind-telegram 123456789\n\n# Cron + scheduling\nzeroclaw cron list            # List scheduled jobs\nzeroclaw cron add \"*\u002F5 * * * *\" --prompt \"Check system health\"\nzeroclaw cron remove \u003Cid>\n\n# Memory\nzeroclaw memory list          # List memory entries\nzeroclaw memory get \u003Ckey>     # Retrieve a memory\nzeroclaw memory stats         # Memory statistics\n\n# Auth profiles\nzeroclaw auth login --provider \u003Cname>\nzeroclaw auth status\nzeroclaw auth use --provider \u003Cname> --profile \u003Cprofile>\n\n# Hardware peripherals\nzeroclaw hardware discover    # Scan for connected devices\nzeroclaw peripheral list      # List connected peripherals\nzeroclaw peripheral flash     # Flash firmware to device\n\n# Migration\nzeroclaw migrate openclaw --dry-run\nzeroclaw migrate openclaw\n\n# Shell completions\nsource \u003C(zeroclaw completions bash)\nzeroclaw completions zsh > ~\u002F.zfunc\u002F_zeroclaw\n```\n\nFull commands reference: [docs\u002Freference\u002Fcli\u002Fcommands-reference.md](docs\u002Freference\u002Fcli\u002Fcommands-reference.md)\n\n## Prerequisites\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Windows\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n#### Required\n\n1. **Visual Studio Build Tools** (provides the MSVC linker and Windows SDK):\n\n    ```powershell\n    winget install Microsoft.VisualStudio.2022.BuildTools\n    ```\n\n    During installation (or via the Visual Studio Installer), select the **\"Desktop development with C++\"** workload.\n\n2. **Rust toolchain:**\n\n    ```powershell\n    winget install Rustlang.Rustup\n    ```\n\n    After installation, open a new terminal and run `rustup default stable` to ensure the stable toolchain is active.\n\n3. **Verify** both are working:\n    ```powershell\n    rustc --version\n    cargo --version\n    ```\n\n#### Optional\n\n- **Docker Desktop** — required only if using the [Docker sandboxed runtime](#runtime-support-current) (`runtime.kind = \"docker\"`). Install via `winget install Docker.DockerDesktop`.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Linux \u002F macOS\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n#### Required\n\n1. **Build essentials:**\n    - **Linux (Debian\u002FUbuntu):** `sudo apt install build-essential pkg-config`\n    - **Linux (Fedora\u002FRHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config`\n    - **macOS:** Install Xcode Command Line Tools: `xcode-select --install`\n\n2. **Rust toolchain:**\n\n    ```bash\n    curl --proto '=https' --tlsv1.2 -sSf https:\u002F\u002Fsh.rustup.rs | sh\n    ```\n\n    See [rustup.rs](https:\u002F\u002Frustup.rs) for details.\n\n3. **Verify** both are working:\n    ```bash\n    rustc --version\n    cargo --version\n    ```\n\n#### One-Line Installer\n\nOr skip the steps above and install everything (Rust, ZeroClaw) in a single command:\n\n```bash\ncurl -LsSf https:\u002F\u002Fraw.githubusercontent.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fmaster\u002Finstall.sh | bash\n```\n\n#### Build profiles\n\n```bash\n.\u002Finstall.sh                                          # full (default features)\n.\u002Finstall.sh --minimal                                # kernel only (~6.6MB)\n.\u002Finstall.sh --minimal --features agent-runtime,channel-discord  # custom\n.\u002Finstall.sh --list-features                          # see all available features\n```\n\nFor pre-built binaries, see [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Freleases\u002Flatest).\n\n#### Optional\n\n- **Docker** — required only if using the [Docker sandboxed runtime](#runtime-support-current) (`runtime.kind = \"docker\"`). Install via your package manager or [docker.com](https:\u002F\u002Fdocs.docker.com\u002Fengine\u002Finstall\u002F).\n\n> **Note:** The default `cargo build --release` uses `codegen-units=1` to lower peak compile pressure. For faster builds on powerful machines, use `cargo build --profile release-fast`.\n\n\u003C\u002Fdetails>\n\n### Pre-built binaries\n\nRelease assets are published for:\n\n- Linux: `x86_64`, `aarch64`, `armv7`\n- macOS: `x86_64`, `aarch64`\n- Windows: `x86_64`\n\nDownload the latest assets from:\n\u003Chttps:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Freleases\u002Flatest>\n\n## Docs\n\nUse these when you're past the onboarding flow and want the deeper reference.\n\n- Start with the [docs index](docs\u002FREADME.md) for navigation and \"what's where.\"\n- Read the [architecture overview](docs\u002Farchitecture.md) for the full system model.\n- Use the [configuration reference](docs\u002Freference\u002Fapi\u002Fconfig-reference.md) when you need every key and example.\n- Run the Gateway by the book with the [operational runbook](docs\u002Fops\u002Foperations-runbook.md).\n- Follow [ZeroClaw Onboard](#quick-start) for a guided setup.\n- Debug common failures with the [troubleshooting guide](docs\u002Fops\u002Ftroubleshooting.md).\n- Review [security guidance](docs\u002Fsecurity\u002FREADME.md) before exposing anything.\n\n### Reference docs\n\n- Documentation hub: [docs\u002FREADME.md](docs\u002FREADME.md)\n- Unified docs TOC: [docs\u002FSUMMARY.md](docs\u002FSUMMARY.md)\n- Commands reference: [docs\u002Freference\u002Fcli\u002Fcommands-reference.md](docs\u002Freference\u002Fcli\u002Fcommands-reference.md)\n- Config reference: [docs\u002Freference\u002Fapi\u002Fconfig-reference.md](docs\u002Freference\u002Fapi\u002Fconfig-reference.md)\n- Providers reference: [docs\u002Freference\u002Fapi\u002Fproviders-reference.md](docs\u002Freference\u002Fapi\u002Fproviders-reference.md)\n- Channels reference: [docs\u002Freference\u002Fapi\u002Fchannels-reference.md](docs\u002Freference\u002Fapi\u002Fchannels-reference.md)\n- Operations runbook: [docs\u002Fops\u002Foperations-runbook.md](docs\u002Fops\u002Foperations-runbook.md)\n- Troubleshooting: [docs\u002Fops\u002Ftroubleshooting.md](docs\u002Fops\u002Ftroubleshooting.md)\n\n### Collaboration docs\n\n- Contribution guide: [CONTRIBUTING.md](CONTRIBUTING.md)\n- PR workflow policy: [docs\u002Fcontributing\u002Fpr-workflow.md](docs\u002Fcontributing\u002Fpr-workflow.md)\n- CI workflow guide: [docs\u002Fcontributing\u002Fci-map.md](docs\u002Fcontributing\u002Fci-map.md)\n- Reviewer playbook: [docs\u002Fcontributing\u002Freviewer-playbook.md](docs\u002Fcontributing\u002Freviewer-playbook.md)\n- Security disclosure policy: [SECURITY.md](SECURITY.md)\n- Documentation template: [docs\u002Fcontributing\u002Fdoc-template.md](docs\u002Fcontributing\u002Fdoc-template.md)\n\n### Deployment + operations\n\n- Network deployment guide: [docs\u002Fops\u002Fnetwork-deployment.md](docs\u002Fops\u002Fnetwork-deployment.md)\n- Proxy agent playbook: [docs\u002Fops\u002Fproxy-agent-playbook.md](docs\u002Fops\u002Fproxy-agent-playbook.md)\n- Hardware guides: [docs\u002Fhardware\u002FREADME.md](docs\u002Fhardware\u002FREADME.md)\n\n## Icy Crab 🦀\n\nZeroClaw was built for the smooth crab 🦀, a fast and efficient AI assistant. Built by Argenis De La Rosa and the community.\n\n- [zeroclawlabs.ai](https:\u002F\u002Fzeroclawlabs.ai)\n- [@zeroclawlabs](https:\u002F\u002Fx.com\u002Fzeroclawlabs)\n\n## Support ZeroClaw\n\n### 🙏 Special Thanks\n\nA heartfelt thank you to the communities and institutions that inspire and fuel this open-source work:\n\n- **Harvard University** — for fostering intellectual curiosity and pushing the boundaries of what's possible.\n- **MIT** — for championing open knowledge, open source, and the belief that technology should be accessible to everyone.\n- **Sundai Club** — for the community, the energy, and the relentless drive to build things that matter.\n- **The World & Beyond** 🌍✨ — to every contributor, dreamer, and builder out there making open source a force for good. This is for you.\n\nWe're building in the open because the best ideas come from everywhere. If you're reading this, you're part of it. Welcome. 🦀❤️\n\n## Contributing\n\nNew to ZeroClaw? Look for issues labeled [`good first issue`](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fissues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) — see our [Contributing Guide](CONTRIBUTING.md#first-time-contributors) for how to get started. AI\u002Fvibe-coded PRs welcome! 🤖\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) and [CLA.md](docs\u002Fcontributing\u002Fcla.md). Implement a trait, submit a PR:\n\n- CI workflow guide: [docs\u002Fcontributing\u002Fci-map.md](docs\u002Fcontributing\u002Fci-map.md)\n- New `Provider` → `src\u002Fproviders\u002F`\n- New `Channel` → `src\u002Fchannels\u002F`\n- New `Observer` → `src\u002Fobservability\u002F`\n- New `Tool` → `src\u002Ftools\u002F`\n- New `Memory` → `src\u002Fmemory\u002F`\n- New `Tunnel` → `src\u002Ftunnel\u002F`\n- New `Peripheral` → `src\u002Fperipherals\u002F`\n- New `Skill` → `~\u002F.zeroclaw\u002Fworkspace\u002Fskills\u002F\u003Cname>\u002F`\n\n\u003C!-- BEGIN:RECENT_CONTRIBUTORS -->\n\u003C!-- END:RECENT_CONTRIBUTORS -->\n\n## ⚠️ Official Repository & Impersonation Warning\n\n**This is the only official ZeroClaw repository:**\n\n> https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\n\nAny other repository, organization, domain, or package claiming to be \"ZeroClaw\" or implying affiliation with ZeroClaw Labs is **unauthorized and not affiliated with this project**. Known unauthorized forks will be listed in [TRADEMARK.md](docs\u002Fmaintainers\u002Ftrademark.md).\n\nIf you encounter impersonation or trademark misuse, please [open an issue](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fissues).\n\n---\n\n## License\n\nZeroClaw is dual-licensed for maximum openness and contributor protection:\n\n| License | Use case |\n|---|---|\n| [MIT](LICENSE-MIT) | Open-source, research, academic, personal use |\n| [Apache 2.0](LICENSE-APACHE) | Patent protection, institutional, commercial deployment |\n\nYou may choose either license. **Contributors automatically grant rights under both** — see [CLA.md](docs\u002Fcontributing\u002Fcla.md) for the full contributor agreement.\n\n### Trademark\n\nThe **ZeroClaw** name and logo are trademarks of ZeroClaw Labs. This license does not grant permission to use them to imply endorsement or affiliation. See [TRADEMARK.md](docs\u002Fmaintainers\u002Ftrademark.md) for permitted and prohibited uses.\n\n### Contributor Protections\n\n- You **retain copyright** of your contributions\n- **Patent grant** (Apache 2.0) shields you from patent claims by other contributors\n- Your contributions are **permanently attributed** in commit history and [NOTICE](NOTICE)\n- No trademark rights are transferred by contributing\n\n---\n\n**ZeroClaw** — Zero overhead. Zero compromise. Deploy anywhere. Swap anything. 🦀\n\n## Contributors\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_ad1b539fd493.png\" alt=\"ZeroClaw contributors\" \u002F>\n\u003C\u002Fa>\n\nThis list is generated from the GitHub contributors graph and updates automatically.\n\n## Star History\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#zeroclaw-labs\u002Fzeroclaw&type=date&legend=top-left\">\n    \u003Cpicture>\n     \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=zeroclaw-labs\u002Fzeroclaw&type=date&theme=dark&legend=top-left\" \u002F>\n     \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_3b71498530ec.png\" \u002F>\n     \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_3b71498530ec.png\" \u002F>\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n","\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_a2d7706f6e4f.png\" alt=\"ZeroClaw\" width=\"600\" \u002F>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">🦀 ZeroClaw — 个人AI助手\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>零开销。零妥协。100% Rust。100% 通用。\u003C\u002Fstrong>\u003Cbr>\n  ⚡️ \u003Cstrong>可在仅需$10的硬件上运行，且内存占用低于5MB：这比OpenClaw少99%的内存，也比Mac mini便宜98%！\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Factions\u002Fworkflows\u002Fci-run.yml\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fci-run.yml?branch=master&label=build\" alt=\"构建状态\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"LICENSE-APACHE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT%20OR%20Apache%202.0-blue.svg\" alt=\"许可证：MIT 或 Apache-2.0\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.rust-lang.org\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Frust-edition%202024-orange?logo=rust\" alt=\"Rust 2024版\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Freleases\u002Flatest\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-v0.7.0-blue\" alt=\"版本 v0.7.0\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fgraphs\u002Fcontributors\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fzeroclaw-labs\u002Fzeroclaw?color=green\" alt=\"贡献者\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fx.com\u002Fzeroclawlabs?s=21\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FX-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white\" alt=\"X: @zeroclawlabs\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002FwDshRVqRjx\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?style=flat&logo=discord&logoColor=white\" alt=\"Discord\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.reddit.com\u002Fr\u002Fzeroclawlabs\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FReddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white\" alt=\"Reddit: r\u002Fzeroclawlabs\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n由哈佛、MIT以及Sundai.Club社区的学生和成员共同打造。\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  🌐 \u003Cstrong>语言：\u003C\u002Fstrong>\n  \u003Ca href=\"README.md\">🇺🇸 英语\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fzh-CN\u002FREADME.md\">🇨🇳 简体中文\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fja\u002FREADME.md\">🇯🇵 日本語\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fko\u002FREADME.md\">🇰🇷 한국어\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fvi\u002FREADME.md\">🇻🇳 Tiếng Việt\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Ftl\u002FREADME.md\">🇵🇭 Tagalog\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fes\u002FREADME.md\">🇪🇸 Español\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fpt\u002FREADME.md\">🇧🇷 Português\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fit\u002FREADME.md\">🇮🇹 Italiano\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fde\u002FREADME.md\">🇩🇪 Deutsch\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Ffr\u002FREADME.md\">🇫🇷 Français\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Far\u002FREADME.md\">🇸🇦 العربية\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fhi\u002FREADME.md\">🇮🇳 हिन्दी\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fru\u002FREADME.md\">🇷🇺 Русский\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fbn\u002FREADME.md\">🇧🇩 বাংলা\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fhe\u002FREADME.md\">🇮🇱 עברית\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fpl\u002FREADME.md\">🇵🇱 Polski\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fcs\u002FREADME.md\">🇨🇿 Čeština\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fnl\u002FREADME.md\">🇳🇱 Nederlands\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Ftr\u002FREADME.md\">🇹🇷 Türkçe\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fuk\u002FREADME.md\">🇺🇦 Українська\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fid\u002FREADME.md\">🇮🇩 Bahasa Indonesia\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fth\u002FREADME.md\">🇹🇭 ไทย\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fur\u002FREADME.md\">🇵🇰 اردو\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fro\u002FREADME.md\">🇷🇴 Română\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fsv\u002FREADME.md\">🇸🇪 Svenska\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fel\u002FREADME.md\">🇬🇷 Ελληνικά\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fhu\u002FREADME.md\">🇭🇺 Magyar\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Ffi\u002FREADME.md\">🇫🇮 Suomi\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fda\u002FREADME.md\">🇩🇰 Dansk\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fi18n\u002Fnb\u002FREADME.md\">🇳🇴 Norsk\u003C\u002Fa>\n\u003C\u002Fp>\n\nZeroClaw是一款您可以在自己的设备上运行的个人AI助手。它会通过您常用的渠道（WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Matrix、IRC、Email、Bluesky、Nostr、Mattermost、Nextcloud Talk、DingTalk、Lark、QQ、Reddit、LinkedIn、Twitter、MQTT、WeChat Work等）与您互动。它配备了一个用于实时控制的Web仪表盘，并可连接到硬件外设（ESP32、STM32、Arduino、树莓派）。网关只是控制平面——产品是助手本身。\n\n如果您想要一个本地化、快速响应且始终在线的单用户个人助手，那么这就是它。\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fzeroclawlabs.ai\">官网\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002FREADME.md\">文档\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Farchitecture.md\">架构\u003C\u002Fa> ·\n  \u003Ca href=\"#quick-start\">快速入门\u003C\u002Fa> ·\n  \u003Ca href=\"#migrating-from-openclaw\">从OpenClaw迁移\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Fops\u002Ftroubleshooting.md\">故障排除\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002FwDshRVqRjx\">Discord\u003C\u002Fa>\n\u003C\u002Fp>\n\n> **推荐设置：** 在终端中运行`zeroclaw onboard`。ZeroClaw Onboard会逐步引导您完成网关、工作空间、渠道和提供商的设置。这是推荐的设置流程，适用于macOS、Linux和Windows（通过WSL2）。如果是新安装，请从此处开始：[快速入门](#quick-start)\n\n### 订阅认证（OAuth）\n\n- **OpenAI Codex**（ChatGPT订阅）\n- **Gemini**（Google OAuth）\n- **Anthropic**（API密钥或认证令牌）\n\n模型说明：虽然支持多种提供商和模型，但为了获得最佳体验，建议使用您可用的最强大、最新一代模型。请参阅[入门指南](#quick-start)。\n\n模型配置 + CLI：[提供商参考](docs\u002Freference\u002Fapi\u002Fproviders-reference.md)\n认证凭据轮换（OAuth vs API密钥）+ 故障转移：[模型故障转移](docs\u002Freference\u002Fapi\u002Fproviders-reference.md)\n\n## 安装（推荐）\n\n运行时：Rust稳定工具链。单个二进制文件，无运行时依赖。\n\n### Homebrew（macOS\u002FLinuxbrew）\n\n```bash\nbrew install zeroclaw\n```\n\n### 一键启动\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw.git\ncd zeroclaw\n.\u002Finstall.sh\n```\n\n安装完成后，`zeroclaw onboard`会自动运行，以配置您的工作空间和提供商。\n\n## 快速入门（简要版）\n\n完整的初学者指南（认证、配对、渠道）：[快速入门](docs\u002Fsetup-guides\u002Fone-click-bootstrap.md)\n\n```bash\n# 安装 + 启动\n.\u002Finstall.sh\n\n# 启动网关（webhook服务器 + Web仪表盘）\nzeroclaw gateway                # 默认：127.0.0.1:42617\nzeroclaw gateway --port 0       # 随机端口（安全性增强）\n\n# 与助手对话\nzeroclaw agent -m \"你好，ZeroClaw！\"\n\n# 交互模式\nzeroclaw agent\n\n# 启动完全自主运行（网关 + 渠道 + 定时任务 + 手动操作）\nzeroclaw daemon\n\n# 检查状态\nzeroclaw status\n\n# 运行诊断\nzeroclaw doctor\n```\n\n升级后，请运行`zeroclaw doctor`。\n\n### 从源码编译（开发）\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw.git\ncd zeroclaw\n\ncargo build --release --locked\ncargo install --path . --force --locked\n\nzeroclaw onboard\n```\n\n> **开发回退方案（无需全局安装）：** 在命令前加上`cargo run --release --`（例如：`cargo run --release -- status`）。\n\n## 从OpenClaw迁移\n\nZeroClaw可以导入您的OpenClaw工作空间、记忆和配置：\n\n```bash\n\n# 预览将要迁移的内容（安全、只读）\nzeroclaw migrate openclaw --dry-run\n\n# 执行迁移\nzeroclaw migrate openclaw\n```\n\n这会将您的内存条目、工作区文件和配置从 `~\u002F.openclaw\u002F` 迁移到 `~\u002F.zeroclaw\u002F`。配置文件会自动从 JSON 转换为 TOML 格式。\n\n## 安全默认设置（DM 访问）\n\nZeroClaw 会连接到真实的通信界面。请将传入的私信视为不受信任的输入。\n\n完整安全指南：[SECURITY.md](SECURITY.md)\n\n所有频道的默认行为：\n\n- **DM 配对**（默认）：未知发件人会收到一个简短的配对码，机器人不会处理他们的消息。\n- 批准方式：`zeroclaw pairing approve \u003Cchannel> \u003Ccode>`（然后该发件人会被加入本地白名单）。\n- 公开的传入 DM 需要在 `config.toml` 中明确启用。\n- 运行 `zeroclaw doctor` 可以发现有风险或配置错误的 DM 策略。\n\n**自主级别：**\n\n| 级别 | 行为 |\n|-------|----------|\n| `ReadOnly` | 代理可以观察但不能行动 |\n| `Supervised`（默认） | 代理在获得批准后才能执行中高风险操作 |\n| `Full` | 代理在策略范围内自主行动 |\n\n**沙箱层：** 工作区隔离、路径遍历拦截、命令白名单、禁止访问路径（`\u002Fetc`、`\u002Froot`、`~\u002F.ssh`）、速率限制（每小时最大操作数、每日费用上限）。\n\n\u003C!-- BEGIN:WHATS_NEW -->\n\u003C!-- END:WHATS_NEW -->\n\n### 📢 公告\n\n请在此公告板上查看重要通知（重大变更、安全公告、维护窗口以及发布阻塞事项）。\n\n| 日期（UTC） | 级别       | 通知                                                                                                                                                                                                                                                                                                                                                 | 行动                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |\n| ---------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| 2026-02-19 | _Critical_  | 我们与 `openagen\u002Fzeroclaw`、`zeroclaw.org` 或 `zeroclaw.net` **没有任何关联**。目前 `zeroclaw.org` 和 `zeroclaw.net` 域名指向的是 `openagen\u002Fzeroclaw` 的分支项目，而该域名及仓库正在冒充我们的官方网站和项目。                                                                                       | 请勿相信来自这些来源的信息、二进制文件、筹款活动或公告。仅使用 [此仓库](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw) 和我们经过验证的社交媒体账号。                                                                                                                                                                                                                                                                                                                                                                                                                       |\n| 2026-02-21 | _Important_ | 我们的官方网站现已上线：[zeroclawlabs.ai](https:\u002F\u002Fzeroclawlabs.ai)。感谢您在我们准备上线期间的耐心等待。我们仍然发现有人试图冒充我们，请 **不要** 参与任何声称与 ZeroClaw 有关的投资或筹款活动，除非这些信息是由我们的官方渠道发布的。                            | 请以 [此仓库](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw) 作为唯一的真实信息来源。关注 [X (@zeroclawlabs)](https:\u002F\u002Fx.com\u002Fzeroclawlabs?s=21)、[Facebook (Group)](https:\u002F\u002Fwww.facebook.com\u002Fgroups\u002Fzeroclawlabs) 和 [Reddit (r\u002Fzeroclawlabs)](https:\u002F\u002Fwww.reddit.com\u002Fr\u002Fzeroclawlabs\u002F) 以获取官方更新。 |\n| 2026-02-19 | _Important_ | Anthropic 于 2026 年 2 月 19 日更新了《身份验证与凭证使用》条款。Claude Code OAuth 令牌（Free、Pro、Max）仅适用于 Claude Code 和 Claude.ai；在任何其他产品、工具或服务中使用 Claude Free\u002FPro\u002FMax 的 OAuth 令牌（包括 Agent SDK）均不被允许，并可能违反《消费者服务条款》。 | 请暂时避免使用 Claude Code 的 OAuth 集成，以防止潜在损失。原文条款：[身份验证与凭证使用](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Flegal-and-compliance#authentication-and-credential-use)。                                                                                                                                                                                                                                                                                                                                                                                    |\n\n## 亮点\n\n- **默认精益运行时** — 常用 CLI 和状态工作流在发布版本中仅占用几 MB 内存。\n- **经济高效的部署** — 专为 10 美元的开发板和小型云实例设计，无重量级运行时依赖。\n- **快速冷启动** — 单二进制 Rust 运行时使命令和守护进程启动几乎瞬间完成。\n- **可移植架构** — 一个二进制文件适用于 ARM、x86 和 RISC-V 架构，并支持插拔式提供商、通道和工具。\n- **本地优先网关** — 统一控制平面，用于会话、通道、工具、定时任务、标准操作流程和事件管理。\n- **多通道收件箱** — WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Matrix、IRC、Email、Bluesky、Nostr、Mattermost、Nextcloud Talk、DingTalk、Lark、QQ、Reddit、LinkedIn、Twitter、MQTT、企业微信、WebSocket 等。\n- **多智能体编排（Hands）** — 按计划运行并随时间不断学习进化的自主智能体群。\n- **标准操作流程 (SOPs)** — 基于 MQTT、Webhook、Cron 定时任务及外部触发器的事件驱动工作流自动化。\n- **Web 控制台** — 使用 React 19 + Vite 构建的 Web UI，提供实时聊天、内存浏览器、配置编辑器、Cron 任务管理器和工具检查器。\n- **硬件外设** — 通过 `Peripheral` 特性接口支持 ESP32、STM32 Nucleo、Arduino 和 Raspberry Pi GPIO。\n- **一流工具集** — 包括 Shell、文件 I\u002FO、浏览器、Git、Web 请求\u002F搜索、MCP、Jira、Notion、Google Workspace 等 70 多种工具。\n- **生命周期钩子** — 在每个阶段拦截并修改 LLM 调用、工具执行和消息。\n- **技能平台** — 提供捆绑式、社区贡献及工作空间专属技能，并进行安全审计。\n- **隧道支持** — Cloudflare、Tailscale、ngrok、OpenVPN 以及自定义远程访问隧道。\n\n### 为什么团队选择 ZeroClaw\n\n- **默认精益**：Rust 编写的轻量级二进制文件，启动迅速，内存占用低。\n- **设计安全**：配对机制、严格沙盒隔离、显式白名单、工作空间范围限制。\n- **完全可插拔**：核心系统采用特性（Providers、Channels、Tools、Memory、Tunnels）实现模块化。\n- **无厂商锁定**：兼容 OpenAI 的提供商支持 + 可插拔的自定义端点。\n\n## 基准测试快照（ZeroClaw vs OpenClaw，可复现）\n\n本地机器快速基准测试（macOS arm64，2026 年 2 月），以 0.8GHz 边缘硬件为基准归一化。\n\n|                           | OpenClaw      | NanoBot        | PicoClaw        | ZeroClaw 🦀          |\n| ------------------------- | ------------- | -------------- | --------------- | -------------------- |\n| **语言**              | TypeScript    | Python         | Go              | **Rust**             |\n| **RAM**                   | > 1GB         | > 100MB        | \u003C 10MB          | **\u003C 5MB**            |\n| **启动时间（0.8GHz 核心）** | > 500s        | > 30s          | \u003C 1s            | **\u003C 10ms**           |\n| **二进制大小**           | ~28MB (dist)  | N\u002FA (Scripts)  | ~8MB            | **~8.8 MB**          |\n| **成本**                  | Mac Mini $599 | Linux SBC ~$50 | Linux Board $10 | **任何硬件 $10** |\n\n> 注：ZeroClaw 的结果基于发布版本，使用 `\u002Fusr\u002Fbin\u002Ftime -l` 测量。OpenClaw 需要 Node.js 运行时（通常额外消耗约 390MB 内存），而 NanoBot 则需要 Python 运行时。PicoClaw 和 ZeroClaw 是静态编译的二进制文件。上述 RAM 数值为运行时内存；构建时的编译需求更高。\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_b7c714b15444.jpeg\" alt=\"ZeroClaw vs OpenClaw 对比图\" width=\"800\" \u002F>\n\u003C\u002Fp>\n\n### 可复现的本地测量方法\n\n```bash\ncargo build --release\nls -lh target\u002Frelease\u002Fzeroclaw\n\n\u002Fusr\u002Fbin\u002Ftime -l target\u002Frelease\u002Fzeroclaw --help\n\u002Fusr\u002Fbin\u002Ftime -l target\u002Frelease\u002Fzeroclaw status\n```\n\n## 我们迄今为止构建的一切\n\n### 核心平台\n\n- HTTP\u002FWS\u002FSSE 控制平面网关，支持会话管理、在线状态、配置、定时任务、Webhook、Web 控制台和设备配对。\n- CLI 接口：`gateway`、`agent`、`onboard`、`doctor`、`status`、`service`、`migrate`、`auth`、`cron`、`channel`、`skills`。\n- 智能体编排循环，包括工具调度、提示构造、消息分类和记忆加载。\n- 会话模型，内置安全策略执行、自主级别和审批门控机制。\n- 弹性提供商封装层，支持故障转移、重试及跨 20 多个 LLM 后端的模型路由。\n\n### 通道\n\n通道：WhatsApp（原生）、Telegram、Slack、Discord、Signal、iMessage、Matrix、IRC、Email、Bluesky、DingTalk、Lark、Mattermost、Nextcloud Talk、Nostr、QQ、Reddit、LinkedIn、Twitter、MQTT、企业微信、WATI、Mochat、Linq、Notion、WebSocket、ClawdTalk。\n\n功能开关：Matrix (`channel-matrix`)、Lark (`channel-lark`)、Nostr (`channel-nostr`)。\n\n### Web 控制台\n\n由 Gateway 直接提供服务的 React 19 + Vite 6 + Tailwind CSS 4 Web 控制台：\n\n- **仪表盘** — 系统概览、健康状态、运行时间、成本跟踪。\n- **智能体聊天** — 与智能体的交互式聊天。\n- **记忆** — 浏览和管理记忆条目。\n- **配置** — 查看和编辑配置。\n- **Cron** — 管理定时任务。\n- **工具** — 浏览可用工具。\n- **日志** — 查看智能体活动日志。\n- **成本** — 记录 Token 使用情况和成本。\n- **医生** — 系统健康诊断。\n- **集成** — 集成状态与设置。\n- **配对** — 设备配对管理。\n\n### 固件目标\n\n| 目标       | 平台           | 用途               |\n|------------|----------------|--------------------|\n| ESP32      | Espressif ESP32 | 无线外设智能体     |\n| ESP32-UI   | ESP32 + 显示屏 | 带可视化界面的智能体 |\n| STM32 Nucleo | STM32（ARM Cortex-M） | 工业级外设         |\n| Arduino    | Arduino        | 基础传感器\u002F执行器桥接 |\n| Uno Q Bridge | Arduino Uno    | 串口桥接到智能体   |\n\n### 工具与自动化\n\n- **核心工具**：Shell、文件读写编辑、Git 操作、Glob 搜索、内容搜索。\n- **Web 工具**：浏览器控制、网页抓取、网络搜索、截图、图片信息提取、PDF 阅读。\n- **集成工具**：Jira、Notion、Google Workspace、Microsoft 365、LinkedIn、Composio、Pushover、天气预报（wttr.in）。\n- **MCP**：模型上下文协议工具封装 + 延迟工具集。\n- **调度工具**：Cron 添加\u002F删除\u002F更新\u002F运行、定时任务工具。\n- **记忆工具**：回忆、存储、遗忘、知识获取、项目情报。\n- **高级工具**：代理间委托、智能体群、模型切换\u002F路由、安全运维、云运维。\n- **硬件工具**：板卡信息、内存映射、内存读取（需功能开关）。\n\n### 运行时与安全性\n\n- **自主级别**：只读、受监督（默认）、完全自主。\n- **沙盒隔离**：工作空间隔离、路径遍历阻断、命令白名单、禁止路径、Linux 的 Landlock 和 Bubblewrap。\n- **速率限制**：每小时最大操作次数、每日最大成本（可配置）。\n- **审批门控**：中高风险操作需交互式审批。\n- **紧急停止**：具备紧急关机能力。\n- 自动化 CI 中包含 129+ 项安全测试。\n\n### 运维 + 打包\n\n- Web 仪表板直接由网关提供服务。\n- 隧道支持：Cloudflare、Tailscale、ngrok、OpenVPN、自定义命令。\n- Docker 运行时适配器，用于容器化执行。\n- CI\u002FCD：测试版（推送自动触发）→ 稳定版（手动调度）→ Docker、crates.io、Scoop、AUR、Homebrew、推特发布。\n- 预编译二进制文件适用于 Linux（x86_64、aarch64、armv7）、macOS（x86_64、aarch64）、Windows（x86_64）。\n\n\n## 配置\n\n最小化的 `~\u002F.zeroclaw\u002Fconfig.toml`：\n\n```toml\ndefault_provider = \"anthropic\"\napi_key = \"sk-ant-...\"\n```\n\n完整配置参考：[docs\u002Freference\u002Fapi\u002Fconfig-reference.md](docs\u002Freference\u002Fapi\u002Fconfig-reference.md)。\n\n### 通道配置\n\n**Telegram：**\n```toml\n[channels.telegram]\nbot_token = \"123456:ABC-DEF...\"\n```\n\n**Discord：**\n```toml\n[channels.discord]\ntoken = \"your-bot-token\"\n```\n\n**Slack：**\n```toml\n[channels.slack]\nbot_token = \"xoxb-...\"\napp_token = \"xapp-...\"\n```\n\n**WhatsApp：**\n```toml\n[channels.whatsapp]\nenabled = true\n```\n\n**Matrix：**\n```toml\n[channels.matrix]\nhomeserver_url = \"https:\u002F\u002Fmatrix.org\"\nusername = \"@bot:matrix.org\"\npassword = \"...\"\n```\n\n**Signal：**\n```toml\n[channels.signal]\nphone_number = \"+1234567890\"\n```\n\n### 隧道配置\n\n```toml\n[tunnel]\nkind = \"cloudflare\"  # 或 \"tailscale\"、\"ngrok\"、\"openvpn\"、\"custom\"、\"none\"\n```\n\n详情：[通道参考](docs\u002Freference\u002Fapi\u002Fchannels-reference.md) · [配置参考](docs\u002Freference\u002Fapi\u002Fconfig-reference.md)\n\n### 当前运行时支持\n\n- **`native`**（默认）— 直接进程执行，路径最快，适合可信环境。\n- **`docker`** — 完全容器隔离，强制安全策略，需要 Docker。\n\n设置 `runtime.kind = \"docker\"` 以实现严格的沙箱或网络隔离。\n\n## 订阅认证（OpenAI Codex \u002F Claude Code \u002F Gemini）\n\nZeroClaw 支持订阅原生认证配置文件（多账号，静态加密）。\n\n- 存储文件：`~\u002F.zeroclaw\u002Fauth-profiles.json`\n- 加密密钥：`~\u002F.zeroclaw\u002F.secret_key`\n- 配置文件 ID 格式：`\u003Cprovider>:\u003Cprofile_name>`（例如：`openai-codex:work`）\n\n```bash\n# OpenAI Codex OAuth（ChatGPT 订阅）\nzeroclaw auth login --provider openai-codex --device-code\n\n# Gemini OAuth\nzeroclaw auth login --provider gemini --profile default\n\n# Anthropic setup-token\nzeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization\n\n# 检查 \u002F 刷新 \u002F 切换配置文件\nzeroclaw auth status\nzeroclaw auth refresh --provider openai-codex --profile default\nzeroclaw auth use --provider openai-codex --profile work\n\n# 使用订阅认证运行代理\nzeroclaw agent --provider openai-codex -m \"hello\"\nzeroclaw agent --provider anthropic -m \"hello\"\n```\n\n## 代理工作区 + 技能\n\n工作区根目录：`~\u002F.zeroclaw\u002Fworkspace\u002F`（可通过配置调整）。\n\n注入的提示文件：\n- `IDENTITY.md` — 代理个性与角色\n- `USER.md` — 用户上下文与偏好\n- `MEMORY.md` — 长期事实与经验教训\n- `AGENTS.md` — 会话约定与初始化规则\n- `SOUL.md` — 核心身份与运作原则\n\n技能：`~\u002F.zeroclaw\u002Fworkspace\u002Fskills\u002F\u003Cskill>\u002FSKILL.md` 或 `SKILL.toml`。\n\n```bash\n# 列出已安装技能\nzeroclaw skills list\n\n# 从 Git 安装\nzeroclaw skills install https:\u002F\u002Fgithub.com\u002Fuser\u002Fmy-skill.git\n\n# 安装前安全审计\nzeroclaw skills audit https:\u002F\u002Fgithub.com\u002Fuser\u002Fmy-skill.git\n\n# 移除技能\nzeroclaw skills remove my-skill\n```\n\n## CLI 命令\n\n```bash\n# 工作区管理\nzeroclaw onboard              # 引导式设置向导\nzeroclaw status               # 显示守护进程\u002F代理状态\nzeroclaw doctor               # 运行系统诊断\n\n# 网关 + 守护进程\nzeroclaw gateway              # 启动网关服务器（127.0.0.1:42617）\nzeroclaw daemon               # 启动完全自主运行时\n\n# 代理\nzeroclaw agent                # 交互式聊天模式\nzeroclaw agent -m \"message\"   # 单消息模式\n\n# 服务管理\nzeroclaw service install      # 作为操作系统服务安装（launchd\u002Fsystemd）\nzeroclaw service start|stop|restart|status\n\n# 通道\nzeroclaw channel list         # 列出已配置的通道\nzeroclaw channel doctor       # 检查通道健康状况\nzeroclaw channel bind-telegram 123456789\n\n# Cron + 调度\nzeroclaw cron list            # 列出计划任务\nzeroclaw cron add \"*\u002F5 * * * *\" --prompt \"检查系统健康\"\nzeroclaw cron remove \u003Cid>\n\n# 内存\nzeroclaw memory list          # 列出记忆条目\nzeroclaw memory get \u003Ckey>     # 获取某条记忆\nzeroclaw memory stats         # 内存统计信息\n\n# 认证配置文件\nzeroclaw auth login --provider \u003Cname>\nzeroclaw auth status\nzeroclaw auth use --provider \u003Cname> --profile \u003Cprofile>\n\n# 硬件外设\nzeroclaw hardware discover    # 扫描连接的设备\nzeroclaw peripheral list      # 列出已连接的外设\nzeroclaw peripheral flash     # 为设备刷写固件\n\n# 迁移\nzeroclaw migrate openclaw --dry-run\nzeroclaw migrate openclaw\n\n# Shell 补全\nsource \u003C(zeroclaw completions bash)\nzeroclaw completions zsh > ~\u002F.zfunc\u002F_zeroclaw\n```\n\n完整命令参考：[docs\u002Freference\u002Fcli\u002Fcommands-reference.md](docs\u002Freference\u002Fcli\u002Fcommands-reference.md)\n\n## 先决条件\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Windows\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n#### 必需\n\n1. **Visual Studio 构建工具**（提供 MSVC 链接器和 Windows SDK）：\n\n    ```powershell\n    winget install Microsoft.VisualStudio.2022.BuildTools\n    ```\n\n    在安装过程中（或通过 Visual Studio 安装程序），请选择 **“使用 C++ 的桌面开发”** 工作负载。\n\n2. **Rust 工具链：**\n\n    ```powershell\n    winget install Rustlang.Rustup\n    ```\n\n    安装完成后，打开一个新的终端并运行 `rustup default stable`，以确保稳定版工具链处于激活状态。\n\n3. **验证**两者是否正常工作：\n    ```powershell\n    rustc --version\n    cargo --version\n    ```\n\n#### 可选\n\n- **Docker Desktop** — 仅在使用 [Docker 沙盒运行时](#runtime-support-current)（`runtime.kind = \"docker\"`）时需要。可通过 `winget install Docker.DockerDesktop` 进行安装。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Linux \u002F macOS\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n#### 必需\n\n1. **构建必备工具：**\n    - **Linux (Debian\u002FUbuntu)：** `sudo apt install build-essential pkg-config`\n    - **Linux (Fedora\u002FRHEL)：** `sudo dnf group install development-tools && sudo dnf install pkg-config`\n    - **macOS：** 安装 Xcode 命令行工具：`xcode-select --install`\n\n2. **Rust 工具链：**\n\n    ```bash\n    curl --proto '=https' --tlsv1.2 -sSf https:\u002F\u002Fsh.rustup.rs | sh\n    ```\n\n    更多详情请参阅 [rustup.rs](https:\u002F\u002Frustup.rs)。\n\n3. **验证**两者是否正常工作：\n    ```bash\n    rustc --version\n    cargo --version\n    ```\n\n#### 一键安装脚本\n\n或者跳过上述步骤，通过以下命令一次性安装所有内容（Rust、ZeroClaw）：\n\n```bash\ncurl -LsSf https:\u002F\u002Fraw.githubusercontent.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fmaster\u002Finstall.sh | bash\n```\n\n#### 构建配置\n\n```bash\n.\u002Finstall.sh                                          # 完整版（默认功能）\n.\u002Finstall.sh --minimal                                # 仅内核版 (~6.6MB)\n.\u002Finstall.sh --minimal --features agent-runtime,channel-discord  # 自定义\n.\u002Finstall.sh --list-features                          # 查看所有可用功能\n```\n\n如需预编译的二进制文件，请参阅 [GitHub 发布页面](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Freleases\u002Flatest)。\n\n#### 可选\n\n- **Docker** — 仅在使用 [Docker 沙盒运行时](#runtime-support-current)（`runtime.kind = \"docker\"`）时需要。可通过您的包管理器或 [docker.com](https:\u002F\u002Fdocs.docker.com\u002Fengine\u002Finstall\u002F) 进行安装。\n\n> **注意：** 默认的 `cargo build --release` 使用 `codegen-units=1` 来降低编译峰值压力。对于性能强大的机器，可使用 `cargo build --profile release-fast` 以加快构建速度。\n\n\u003C\u002Fdetails>\n\n### 预编译二进制文件\n\n发布资产适用于以下平台：\n\n- Linux：`x86_64`、`aarch64`、`armv7`\n- macOS：`x86_64`、`aarch64`\n- Windows：`x86_64`\n\n请从以下链接下载最新版本的资产：\n\u003Chttps:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Freleases\u002Flatest>\n\n## 文档\n\n当您完成入门流程并希望深入了解时，请使用这些文档。\n\n- 从 [文档索引](docs\u002FREADME.md) 开始，了解导航和内容分布。\n- 阅读 [架构概述](docs\u002Farchitecture.md)，以全面了解系统模型。\n- 当您需要每个配置项及示例时，请参考 [配置参考](docs\u002Freference\u002Fapi\u002Fconfig-reference.md)。\n- 按照 [运维手册](docs\u002Fops\u002Foperations-runbook.md) 正确运行 Gateway。\n- 按照 [ZeroClaw 入门](#quick-start) 进行引导式设置。\n- 使用 [故障排除指南](docs\u002Fops\u002Ftroubleshooting.md) 调试常见问题。\n- 在公开任何内容之前，请查阅 [安全指南](docs\u002Fsecurity\u002FREADME.md)。\n\n### 参考文档\n\n- 文档中心：[docs\u002FREADME.md](docs\u002FREADME.md)\n- 统一文档目录：[docs\u002FSUMMARY.md](docs\u002FSUMMARY.md)\n- 命令参考：[docs\u002Freference\u002Fcli\u002Fcommands-reference.md](docs\u002Freference\u002Fcli\u002Fcommands-reference.md)\n- 配置参考：[docs\u002Freference\u002Fapi\u002Fconfig-reference.md](docs\u002Freference\u002Fapi\u002Fconfig-reference.md)\n- 提供商参考：[docs\u002Freference\u002Fapi\u002Fproviders-reference.md](docs\u002Freference\u002Fapi\u002Fproviders-reference.md)\n- 渠道参考：[docs\u002Freference\u002Fapi\u002Fchannels-reference.md](docs\u002Freference\u002Fapi\u002Fchannels-reference.md)\n- 运维手册：[docs\u002Fops\u002Foperations-runbook.md](docs\u002Fops\u002Foperations-runbook.md)\n- 故障排除：[docs\u002Fops\u002Ftroubleshooting.md](docs\u002Fops\u002Ftroubleshooting.md)\n\n### 协作文档\n\n- 贡献指南：[CONTRIBUTING.md](CONTRIBUTING.md)\n- PR 流程政策：[docs\u002Fcontributing\u002Fpr-workflow.md](docs\u002Fcontributing\u002Fpr-workflow.md)\n- CI 流程指南：[docs\u002Fcontributing\u002Fci-map.md](docs\u002Fcontributing\u002Fci-map.md)\n- 审查员手册：[docs\u002Fcontributing\u002Freviewer-playbook.md](docs\u002Fcontributing\u002Freviewer-playbook.md)\n- 安全披露政策：[SECURITY.md](SECURITY.md)\n- 文档模板：[docs\u002Fcontributing\u002Fdoc-template.md](docs\u002Fcontributing\u002Fdoc-template.md)\n\n### 部署 + 运维\n\n- 网络部署指南：[docs\u002Fops\u002Fnetwork-deployment.md](docs\u002Fops\u002Fnetwork-deployment.md)\n- 代理助手手册：[docs\u002Fops\u002Fproxy-agent-playbook.md](docs\u002Fops\u002Fproxy-agent-playbook.md)\n- 硬件指南：[docs\u002Fhardware\u002FREADME.md](docs\u002Fhardware\u002FREADME.md)\n\n## 冰蟹 🦀\n\nZeroClaw 是为顺滑的螃蟹 🦀 打造的，它是一款快速高效的 AI 助手。由 Argenis De La Rosa 和社区共同构建。\n\n- [zeroclawlabs.ai](https:\u002F\u002Fzeroclawlabs.ai)\n- [@zeroclawlabs](https:\u002F\u002Fx.com\u002Fzeroclawlabs)\n\n## 支持 ZeroClaw\n\n### 🙏 特别致谢\n\n衷心感谢那些激励并推动这项开源工作的社区和机构：\n\n- **哈佛大学** — 激发了我们的求知欲，并不断突破可能性的边界。\n- **MIT** — 致力于推广开放知识、开源文化，以及科技应惠及每个人的信念。\n- **Sundai Club** — 感谢社区、活力以及不懈地打造有意义事物的动力。\n- **世界及更远的地方** 🌍✨ — 感谢每一位贡献者、梦想家和建设者，是你们让开源成为一股向善的力量。这一切都属于你们。\n\n我们之所以选择开源，是因为最好的想法来自四面八方。如果您正在阅读这段文字，那么您就是其中的一员。欢迎加入。🦀❤️\n\n## 贡献\n\n刚接触 ZeroClaw？请查找标记为 [`good first issue`](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fissues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 的问题 — 请参阅我们的 [贡献指南](CONTRIBUTING.md#first-time-contributors) 了解如何开始。欢迎提交 AI 或充满创意的 PR！🤖\n\n请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 和 [CLA.md](docs\u002Fcontributing\u002Fcla.md)。实现一个 trait，提交一个 PR：\n\n- CI 流程指南：[docs\u002Fcontributing\u002Fci-map.md](docs\u002Fcontributing\u002Fci-map.md)\n- 新的 `Provider` → `src\u002Fproviders\u002F`\n- 新的 `Channel` → `src\u002Fchannels\u002F`\n- 新的 `Observer` → `src\u002Fobservability\u002F`\n- 新的 `Tool` → `src\u002Ftools\u002F`\n- 新的 `Memory` → `src\u002Fmemory\u002F`\n- 新的 `Tunnel` → `src\u002Ftunnel\u002F`\n- 新的 `Peripheral` → `src\u002Fperipherals\u002F`\n- 新的 `Skill` → `~\u002F.zeroclaw\u002Fworkspace\u002Fskills\u002F\u003Cname>\u002F`\n\n\u003C!-- BEGIN:RECENT_CONTRIBUTORS -->\n\u003C!-- END:RECENT_CONTRIBUTORS -->\n\n## ⚠️ 官方仓库与冒充警告\n\n**这是唯一的官方 ZeroClaw 仓库：**\n\n> https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\n\n任何其他声称是“ZeroClaw”或暗示与 ZeroClaw Labs 有关联的仓库、组织、域名或软件包，均 **未经授权且与本项目无关**。已知的未经授权的分叉将在 [TRADEMARK.md](docs\u002Fmaintainers\u002Ftrademark.md) 中列出。\n\n如果您遇到冒充或商标滥用的情况，请 [提交一个问题](https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fissues)。\n\n---\n\n## 许可证\n\nZeroClaw 采用双重许可证，以实现最大的开放性和对贡献者的保护：\n\n| 许可证 | 使用场景 |\n|---|---|\n| [MIT](LICENSE-MIT) | 开源、研究、学术、个人使用 |\n| [Apache 2.0](LICENSE-APACHE) | 专利保护、机构级、商业部署 |\n\n您可以选择其中任意一种许可证。**贡献者会自动授予两种许可证下的权利**——完整贡献者协议请参阅 [CLA.md](docs\u002Fcontributing\u002Fcla.md)。\n\n### 商标\n\n**ZeroClaw** 名称和标志是 ZeroClaw Labs 的注册商标。本许可证并不授予您使用这些商标以暗示认可或关联的权利。有关允许和禁止的使用方式，请参阅 [TRADEMARK.md](docs\u002Fmaintainers\u002Ftrademark.md)。\n\n### 贡献者保护\n\n- 您 **保留对您贡献的版权**\n- **专利许可**（Apache 2.0）可保护您免受其他贡献者的专利诉讼\n- 您的贡献将 **永久署名** 在提交记录和 [NOTICE](NOTICE) 文件中\n- 贡献并不会转移任何商标权\n\n---\n\n**ZeroClaw** — 零开销。零妥协。随处部署。任意替换。🦀\n\n## 贡献者\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_ad1b539fd493.png\" alt=\"ZeroClaw 贡献者\" \u002F>\n\u003C\u002Fa>\n\n此列表由 GitHub 贡献者图生成，并会自动更新。\n\n## 星标历史\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#zeroclaw-labs\u002Fzeroclaw?type=date&legend=top-left\">\n    \u003Cpicture>\n     \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=zeroclaw-labs\u002Fzeroclaw&type=date&theme=dark&legend=top-left\" \u002F>\n     \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_3b71498530ec.png\" \u002F>\n     \u003Cimg alt=\"星标历史图表\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_readme_3b71498530ec.png\" \u002F>\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>","# ZeroClaw 快速上手指南\n\nZeroClaw 是一款零开销、完全用 Rust 编写的个人 AI 助手。它支持在极低配置硬件（\u003C5MB 内存）上运行，并能通过 WhatsApp、微信、钉钉、Telegram 等多种渠道与你交互。\n\n## 环境准备\n\n*   **操作系统**：macOS, Linux, 或 Windows (需通过 WSL2)。\n*   **运行时依赖**：无（编译后为单一二进制文件）。\n*   **构建依赖**（仅源码安装需要）：Rust Stable 工具链。\n    *   安装 Rust: `curl --proto '=https' --tlsv1.2 -sSf https:\u002F\u002Fsh.rustup.rs | sh`\n\n## 安装步骤\n\n推荐以下两种安装方式，任选其一即可。\n\n### 方式一：一键脚本安装（推荐）\n\n此方法会自动克隆仓库并运行初始化向导。\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw.git\ncd zeroclaw\n.\u002Finstall.sh\n```\n\n> 安装完成后，`zeroclaw onboard` 会自动运行，引导你配置工作空间和 AI 提供商。\n\n### 方式二：Homebrew 安装 (macOS\u002FLinux)\n\n```bash\nbrew install zeroclaw\n```\n\n安装完成后，手动运行初始化向导：\n\n```bash\nzeroclaw onboard\n```\n\n### 方式三：源码编译 (开发模式)\n\n如果你希望从最新源码构建：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs\u002Fzeroclaw.git\ncd zeroclaw\n\ncargo build --release --locked\ncargo install --path . --force --locked\n\nzeroclaw onboard\n```\n\n## 基本使用\n\n安装并配置完成后，你可以使用以下命令启动服务或与助手交互。\n\n### 1. 启动网关（Web 控制台）\n启动 Webhook 服务器和网页仪表盘，默认监听 `127.0.0.1:42617`。\n\n```bash\nzeroclaw gateway\n```\n\n若需随机端口以增强安全性：\n```bash\nzeroclaw gateway --port 0\n```\n\n### 2. 与助手对话\n发送单条消息测试：\n\n```bash\nzeroclaw agent -m \"Hello, ZeroClaw!\"\n```\n\n进入交互式对话模式：\n\n```bash\nzeroclaw agent\n```\n\n### 3. 启动全自动守护进程\n同时运行网关、渠道监听、定时任务和执行模块（生产环境推荐）：\n\n```bash\nzeroclaw daemon\n```\n\n### 4. 状态检查与诊断\n查看运行状态：\n```bash\nzeroclaw status\n```\n\n运行健康检查（升级后建议执行）：\n```bash\nzeroclaw doctor\n```\n\n---\n**安全提示**：ZeroClaw 默认开启 DM 配对保护。陌生用户发送消息时会收到配对码，需管理员手动批准（`zeroclaw pairing approve \u003Cchannel> \u003Ccode>`）后方可交互，以防止未授权访问。","一位独立开发者希望在树莓派等低成本设备上部署全天候个人 AI 助手，以统一管理分散在微信、钉钉、Telegram 和邮件等多个渠道的工作通知与指令。\n\n### 没有 zeroclaw 时\n- **硬件门槛高**：主流 AI 助手框架通常占用数百兆内存，必须购买昂贵的云服务器或高性能主机，每月增加额外开支。\n- **部署复杂且割裂**：针对不同通讯平台（如钉钉和 Telegram）需分别编写维护独立的脚本，代码冗余且难以统一升级。\n- **响应延迟严重**：由于资源受限，旧方案在低配设备上运行缓慢，导致关键工作指令无法实时处理，经常错过重要消息。\n- **隐私数据风险**：为了节省本地算力，不得不将敏感数据转发至第三方云端 API 处理，存在数据泄露隐患。\n\n### 使用 zeroclaw 后\n- **极致轻量部署**：zeroclaw 仅需不到 5MB 内存即可运行，直接部署在价值仅 10 美元的老旧硬件或开发板上，成本降低 98%。\n- **全平台统一接入**：通过 zeroclaw 的单一架构，一次性配置即可打通微信、钉钉、邮件等二十余种渠道，实现“一处部署，全域响应”。\n- **毫秒级自主响应**：基于 Rust 构建的零开销特性，即使在低配设备上也能实现全自主快速决策，确保工作流零中断。\n- **数据完全本地化**：所有逻辑与数据处理均在本地设备完成，无需上传云端，彻底保障个人隐私与企业数据安全。\n\nzeroclaw 让开发者能够以极低的硬件成本，在完全自主可控的前提下，构建一个横跨所有通讯平台的实时智能中枢。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fzeroclaw-labs_zeroclaw_a2d7706f.png","zeroclaw-labs","ZeroClaw Labs","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fzeroclaw-labs_891a68ac.jpg","Personal AI Private Assistant",null,"info@zeroclawlabs.ai","zeroclawlabs","www.zeroclawlabs.ai","https:\u002F\u002Fgithub.com\u002Fzeroclaw-labs",[83],{"name":84,"color":85,"percentage":86},"Rust","#dea584",100,30315,4391,"2026-04-18T15:00:33","Apache-2.0","Linux, macOS, Windows (via WSL2)","未说明","\u003C5MB",{"notes":95,"python":96,"dependencies":97},"该工具由 Rust 编写，编译为单一二进制文件，无运行时依赖。支持在仅需 10 美元的低端硬件上运行。安装后可通过 'zeroclaw onboard' 命令进行配置。支持多种通信渠道（如 WhatsApp, Telegram, Discord 等）及硬件外设（ESP32, Arduino 等）。","不需要 (基于 Rust)",[98],"Rust stable toolchain",[15,13,14],[101,102,103,6,104,105,106,65],"agent","agentic","ai","infra","ml","os","2026-03-27T02:49:30.150509","2026-04-19T06:03:18.680185",[],[111,116,121,126,131,136,141,146,151,156,161,166,171,175,179,184,189,194,199,204],{"id":112,"version":113,"summary_zh":114,"released_at":115},333783,"v0.7.0-beta.1047","# 更改日志 — v0.6.9 → v0.7.0\n\n> 自 **v0.6.9** 稳定版以来的变更。本次发布是 ZeroClaw 历史上最大规模的架构重构：整个代码库已被拆分为一个结构完善的 Cargo 工作区，包含多个职责明确的 crate；同时推出了一套全新的配置 schema，并提供了在线迁移路径；在此基础上，还引入了一系列频道、提供商及安全方面的改进。\n\n---\n\n## 亮点\n\n- **工作区拆分完成** — ZeroClaw 现已成为一个多 crate 的 Cargo 工作区。原有的单体源码树已被分解为 12 个以上的专注型 crate（`zeroclaw-api`、`zeroclaw-runtime`、`zeroclaw-gateway`、`zeroclaw-channels`、`zeroclaw-tools`、`zeroclaw-memory`、`zeroclaw-providers`、`zeroclaw-infra`、`zeroclaw-config`、`zeroclaw-tui`、`zeroclaw-plugins`、`zeroclaw-hardware`）。基础二进制文件在使用 `--no-default-features` 构建时，大小仅为 **6.6 MB**。\n  \n- **Config V2 配置 schema 及自动迁移功能** — 提供商配置已迁移到更整洁的布局。运行 `zeroclaw config migrate` 即可原地升级现有配置，并保留注释。旧的 `props` 子命令仍可使用，但现已弃用，推荐改用 `zeroclaw config`。\n\n- **OpenRouter 流式响应支持** — OpenRouterProvider 现在可以逐 token 流式返回响应，不再需要等待完整响应，从而与原生提供商的体验保持一致。\n\n- **Web 控制台与二进制分离** — 控制台现已被单独构建，并在发布时嵌入其中。通过 `cargo install` 以及 AUR\u002FHomebrew 包安装时均会包含该控制台。此外，控制台新增了 **语音模式** 和 **插件页面**。\n\n- **LINE 频道支持** — LINE 消息 API 现已正式成为受支持的渠道之一。\n\n- **Matrix 改进** — 新增仅提及过滤功能（即机器人仅在被提及时才回复）、恢复加密媒体下载、新增对外发送附件的支持，以及保留引导向导功能。\n\n---\n\n## 新特性\n\n### 架构与工作区\n\n- 从单体代码库中提取出 12 个工作区 crate，实现了微内核 RFC 路线图（RFC D1–D5）。所有子系统——提供商、频道、工具、内存、基础设施、配置、网关、TUI、插件、硬件——现在都各自独立存在于一个 crate 中，编译器会强制执行明确的依赖边界。\n- 基础二进制文件（使用 `--no-default-features`）干净编译后的大小为 6.6 MB。\n- `agent-runtime` 功能标志用于控制完整的代理循环；内核二进制文件则无需该功能即可构建。\n- 将 TLS 库从 `aws-lc-rs` 切换至 `ring`，并移除了 `.eh_frame` 段，进一步减小了二进制文件的大小。\n- `schemars` 现在作为可选依赖项，需通过 `schema-export` 功能标志启用——不再是强制性的编译依赖。\n- 为每个频道添加了 28 个独立的功能标志，并采用转发链机制，确保未使用的频道不会增加任何编译时间。\n- 工作区范围内的 `[workspace.dependencies]` 和 `[workspace.package]` 继承机制，消除了各 `Cargo.toml` 文件之间的版本重复问题。\n- 符合 RFC Rev 2 标准：稳定性层级、版本控制策略和发布配置现已集成到工作区中。\n\n### 提供者","2026-04-18T08:55:25",{"id":117,"version":118,"summary_zh":119,"released_at":120},333784,"v0.6.9","## 新增功能\n\n- config：可配置的 derive 宏和 zeroclaw props CLI\n- config：默认启用浏览器工具，并支持自动批准\n- gateway：将定时任务结果广播到仪表板 WebSocket 客户端\n- gateway：为仪表板日志持久化缓存 SSE 事件\n- heartbeat：默认启用心跳机制\n- i18n：将全部 31 种语言添加至 Web 仪表板，并修复 locale API\n- providers：在 ModelProviderConfig 中新增 merge_system_into_user 选项\n- skills：新增 github-pr-review 技能，用于自主 PR 分类与评审\n- web：添加可折叠的桌面侧边栏，并支持本地状态持久化\n- web：添加基于表单的配置编辑器，并支持模式切换\n\n## 贡献者\n\n- Abdul Sadath\n- Argenis\n- argenis de la rosa\n- Claude Opus 4.6\n- Claude Opus 4.6 (1M 上下文)\n- Claude Sonnet 4.6\n- Drew Lipiecki\n- Henrik Akselsen\n- HoWon\n- ilteoood\n- jordanthejet\n- linyibin\n- m-tky\n- Matteo Pietro Dazzi\n- Michael Lohr\n- Richard Piacentini\n- Shane Engelman\n- shedwards\n\n---\n*完整变更日志：v0.6.8...v0.6.9*\n","2026-04-08T06:11:40",{"id":122,"version":123,"summary_zh":124,"released_at":125},333785,"v0.6.8","## 新增功能\n\n- tui：移除 OAuth\u002F浏览器认证方式，扩展引导界面\n\n## 贡献者\n\n- 阿尔赫尼斯·德拉罗萨\n\n---\n*完整变更日志：v0.6.7…v0.6.8*\n","2026-04-02T00:41:57",{"id":127,"version":128,"summary_zh":129,"released_at":130},333786,"v0.6.7","## 新增功能\n\n- 代理：在交互式守护进程循环中添加上下文溢出恢复机制\n- 代理：在工具调用循环中添加上下文溢出恢复机制\n- 代理：在上下文压缩器中添加快速路径工具结果修剪功能\n- 代理：在调用提供商之前添加预检上下文检查\n- 代理：为父代理与子代理协调添加共享迭代预算\n- 代理：添加工具结果截断以防止上下文爆满\n- 代理：当达到最大工具迭代次数时进行优雅关闭\n- 通道：添加入站消息防抖功能\n- 钩子：在空闲超时、关闭和替换时触发 `session:end` 钩子\n- 路由器：添加基于复杂度的自动模型路由\n- 技能：支持 `.well-known\u002Fagent-skills` 发现机制，用于技能安装\n- 工具：在 `file_read` 中添加二进制文件类型检测\n- HTTP 请求：添加 `allowed_private_hosts` 配置，用于绕过 SSRF 攻击\n- 引导：在设置向导中支持与 Anthropic 兼容的端点\n\n## 自动化\n\n- 添加了 `scripts\u002Frelease\u002Fbump-version.sh` 脚本，可通过单个命令同步仓库所有文件中的版本号\n- 添加了 `.github\u002Fworkflows\u002Fversion-sync.yml` 工作流，在 `Cargo.toml` 文件变更时自动同步版本号\n- 修复了阻止发布构建的 Clippy 错误\n- 修复了发布工作流中的 Git 配置和令牌权限问题\n\n---\n*完整变更日志：v0.6.5...v0.6.7*","2026-03-29T21:16:09",{"id":132,"version":133,"summary_zh":134,"released_at":135},333787,"v0.6.5","## 新增功能\n\n- agent：在交互式守护进程循环中添加上下文溢出恢复机制\n- agent：在工具调用循环中添加上下文溢出恢复机制\n- agent：在上下文压缩器中添加快速路径工具结果裁剪功能\n- agent：在调用提供商之前添加预检上下文检查\n- agent：为父代理与子代理的协调添加共享迭代预算\n- agent：添加工具结果截断以防止上下文爆满\n- agent：当达到最大工具迭代次数时进行优雅关闭\n- channels：为快速发送者添加入站消息防抖功能\n- ci：为 Coolify、Dokploy 和 EasyPanel 添加市场模板\n- gateway：添加认证速率限制以防御暴力破解\n- gateway：为每个会话添加 Actor 队列，实现并发轮次序列化\n- locale：实现本地化存储功能\n- matrix：自动端到端加密恢复、多房间监听以及遮蔽敏感信息\n- memory：确保所有执行路径上的内存连续性\n- session：添加会话状态机，支持空闲\u002F运行\u002F错误状态跟踪\n- slack：通过 Slack API 解析永久链接\n- web：在导航和刷新时持久化 Agent 聊天记录\n\n## 贡献者\n\n- Alix-007\n- Argenis\n- argenis de la rosa\n- awol2005ex\n- Burnww\n- Claude Opus 4.6\n- Eds Nody\n- Giulio V\n- linyibin\n- Markus Bergholz\n- MZI13\n- Rafael Xavier de Souza\n- Shane Engelman\n- Vast-stars\n\n---\n*完整变更日志：v0.6.4...v0.6.5*\n","2026-03-27T03:43:17",{"id":137,"version":138,"summary_zh":139,"released_at":140},333788,"v0.6.3","## 新增功能\n\n- 添加技能自我提升和管道工具（关闭 #3683）\n- 添加 Windows 安装批处理文件和指南（关闭 #3693）\n- anthropic：为聊天响应添加 SSE 流式传输支持\n- channels：在提供者回退时通知用户\n- ci：添加 Discord 版本发布公告\n- cli：为 systemd\u002Flaunchd\u002FWindows 添加服务日志命令\n- cli：为代理 REPL 添加流式输出和 Ctrl+C 取消功能\n- config：添加 MultiMessage 流式模式和 Matrix 流式配置\n- config：使每个提供者的 max_tokens 可配置\n- discord：添加 Partial 和 MultiMessage 流式模式\n- discord：添加提供者级别的令牌流式传输，以实现实时交付\n- gateway：为高安全性部署实现双向 TLS (mTLS)\n- i18n：为所有 31 种 README 语言添加工具描述\n- 实现基于 stdio 的 ACP 服务器模式\n- matrix：添加 Partial 和 MultiMessage 流式模式\n- memory：为记忆检索添加 BM25 关键字搜索模式\n- memory：添加批量 JSON 导出，以符合 GDPR 第 20 条的数据可携带性要求\n- observability：添加 DORA 指标用于部署跟踪\n- onboard：将 Discord 的 stream_mode 默认设置为 MultiMessage\n- provider：从 SSE 流中解析代理工具事件\n- providers：添加成本优化的提供者路由策略\n- sandbox：添加 macOS sandbox-exec（Seatbelt）配置文件\n- security：添加 WebAuthn \u002F 硬件密钥认证\n- security：Ed25519 插件签名验证\n- security：将 HMAC-SHA256 签名接入审计追踪\n- slack：通过 chat.update 添加渐进式草稿消息流式传输\n- slack：DraftEvent 枚举和渐进式草稿流式传输\n- tools：添加紧急路由的人工升级工具\n- tools：将报告模板引擎作为独立的代理工具公开\n- trust：添加按域名的信任评分和回归检测\n- voice：实时语音通话支持（Twilio\u002FTelnyx）\n- web：添加带有汉堡菜单切换的响应式移动端侧边栏\n- web：可折叠的思考\u002F推理 UI 和聊天中的 Markdown 渲染\n- web_fetch：添加 allowed_private_hosts 配置，用于绕过 SSRF\n\n## 贡献者\n\n- 0668000448\n- Aleksandr Prilipko\n- Argenis\n- argenis de la rosa\n- bennyzen\n- Claude Opus 4.6\n- Claude Opus 4.6 (1M 上下文)\n- Joe Hoyle\n- Nero\n- Nim G\n- rareba\n- Roman Tataurov\n- Ryan Tregea\n- Shane Engelman\n- smallwhite\n- Vlad\n- windyboy\n\n---\n*完整变更日志：v0.6.2...v0.6.3*\n","2026-03-26T14:33:45",{"id":142,"version":143,"summary_zh":144,"released_at":145},333789,"v0.6.2","## 新增内容\n\n- 增量改进和优化\n\n## 贡献者\n\n\n\n---\n*完整更新日志：v0.6.2…v*\n","2026-03-24T20:02:05",{"id":147,"version":148,"summary_zh":149,"released_at":150},333790,"v0.6.1","## 新增内容\n\n- 增量改进和优化\n\n## 贡献者\n\n\n\n---\n*完整更新日志：v0.6.1...v*\n","2026-03-24T08:28:22",{"id":152,"version":153,"summary_zh":154,"released_at":155},333791,"v0.6.1-beta.637","\n","2026-03-24T08:25:24",{"id":157,"version":158,"summary_zh":159,"released_at":160},333792,"v0.6.0","## 新增内容\n\n- 增量改进和优化\n\n## 贡献者\n\n\n\n---\n*完整更新日志：v0.6.0…v*\n","2026-03-24T01:40:41",{"id":162,"version":163,"summary_zh":164,"released_at":165},333793,"v0.5.9","## 新增内容\n\n- 增量改进和优化\n\n## 贡献者\n\n\n\n---\n*完整更新日志：v0.5.9...v*\n","2026-03-23T01:21:49",{"id":167,"version":168,"summary_zh":169,"released_at":170},333794,"v0.5.9-beta.579","## What's New\n\n- add browser automation skill and VNC setup scripts\n- add image and file support for Feishu\u002FLark channel\n- add SearXNG search provider support\n- add voice message transcription support\n- declarative cron job configuration\n- gateway: add named sessions with reconnect and validation fixes\n- memory: restore time-decay scoring lost in main→master migration\n- register skill tools as callable tool specs\n- tools: enable internet access by default\n\n## Contributors\n\n- Argenis\n- OpenClaw Assistant\n\n---\n*Full changelog: v0.5.8...HEAD*\n","2026-03-23T01:21:32",{"id":172,"version":173,"summary_zh":169,"released_at":174},333795,"v0.5.9-beta.578","2026-03-23T00:47:54",{"id":176,"version":177,"summary_zh":169,"released_at":178},333796,"v0.5.8-beta.577","2026-03-23T00:03:38",{"id":180,"version":181,"summary_zh":182,"released_at":183},333797,"v0.5.8","## What's New\n\n- matrix: add allowed_rooms config for room-level gating (#4230)\n- multimodal: route image messages to dedicated vision provider\n- telegram: support forwarded messages with attribution\n- tts: add local Piper TTS provider\n\n## Contributors\n\n- Alix-007\n- Argenis\n- argenis de la rosa\n- Canberk Özkan\n- loriscience\n\n---\n*Full changelog: v0.5.7...v0.5.8*\n","2026-03-22T22:08:19",{"id":185,"version":186,"summary_zh":187,"released_at":188},333798,"v0.5.8-beta.564","## What's New\n\n- matrix: add allowed_rooms config for room-level gating (#4230)\n- multimodal: route image messages to dedicated vision provider\n- telegram: support forwarded messages with attribution\n- tts: add local Piper TTS provider\n\n## Contributors\n\n- Alix-007\n- Argenis\n- argenis de la rosa\n- Canberk Özkan\n- loriscience\n\n---\n*Full changelog: v0.5.7...HEAD*\n","2026-03-22T20:53:45",{"id":190,"version":191,"summary_zh":192,"released_at":193},333799,"v0.5.7-beta.563","## What's New\n\n- matrix: add allowed_rooms config for room-level gating (#4230)\n- multimodal: route image messages to dedicated vision provider\n- telegram: support forwarded messages with attribution\n- tts: add local Piper TTS provider\n\n## Contributors\n\n- Alix-007\n- Argenis\n- Canberk Özkan\n- loriscience\n\n---\n*Full changelog: v0.5.7...HEAD*\n","2026-03-22T19:06:37",{"id":195,"version":196,"summary_zh":197,"released_at":198},333800,"v0.5.7","## What's New\n\n- heartbeat: add load_session_context to inject conversation history\n- memory: layered architecture upgrade + remove mem0 backend\n- tools: add emoji reaction tool for cross-channel reactions\n- tools: add session list, history, and send tools for inter-agent messaging\n- tools: add standalone image generation tool via fal.ai\n\n## Contributors\n\n- Argenis\n- argenis de la rosa\n- Chris Hengge\n- Claude Opus 4.6\n- Claude Opus 4.6 (1M context)\n- Giulio V\n- Martin Minkus\n- ninenox\n- rareba\n- WareWolf-MoonWall\n\n---\n*Full changelog: v0.5.6...v0.5.7*\n","2026-03-22T06:41:41",{"id":200,"version":201,"summary_zh":202,"released_at":203},333801,"v0.5.7-beta.554","## What's New\n\n- heartbeat: add load_session_context to inject conversation history\n- memory: layered architecture upgrade + remove mem0 backend\n- tools: add emoji reaction tool for cross-channel reactions\n- tools: add session list, history, and send tools for inter-agent messaging\n- tools: add standalone image generation tool via fal.ai\n\n## Contributors\n\n- Argenis\n- argenis de la rosa\n- Chris Hengge\n- Claude Opus 4.6\n- Claude Opus 4.6 (1M context)\n- Giulio V\n- Martin Minkus\n- ninenox\n- rareba\n- WareWolf-MoonWall\n\n---\n*Full changelog: v0.5.6...HEAD*\n","2026-03-22T05:59:35",{"id":205,"version":206,"summary_zh":207,"released_at":208},333802,"v0.5.6-beta.536","## What's New\n\n- tools: add emoji reaction tool for cross-channel reactions\n- tools: add session list, history, and send tools for inter-agent messaging\n- tools: add standalone image generation tool via fal.ai\n\n## Contributors\n\n- Argenis\n- argenis de la rosa\n- Claude Opus 4.6 (1M context)\n- Giulio V\n- ninenox\n- rareba\n- WareWolf-MoonWall\n\n---\n*Full changelog: v0.5.6...HEAD*\n","2026-03-22T02:03:35"]