microclaw/microclaw

📚 什么是 MicroClaw？

MicroClaw 是一个自托管、基于 Rust 的 AI 代理平台，可作为长期运行的服务器、原生桌面“Work”应用，或通过其 microclaw-sdk 嵌入任何 Rust 程序。三个入口点共享相同的核心 Agent Engine——负责与 LLM 提供商通信、执行工具、保存记忆，并执行安全策略的部分。

---

🎯 适合谁使用？

使用案例	推荐界面
常驻聊天机器人、Web/API 端点、定时自动化	MicroClaw Server（macOS、Linux、Windows）
位于桌面的本地、以工作区为中心的“协作者”	MicroClaw Work – 原生 GPUI 应用（Apple Silicon macOS 13+、Linux/Windows 预览版）
将 AI 代理加入现有 Rust 代码库	microclaw-sdk – 直接嵌入引擎

---

⚙️ 核心功能

领域	提供的功能
代理执行	多步骤工具使用、并行只读波次、规划、子代理、完成契约
持续性	可恢复的会话、检查点、持久的外发投递、调度、取消
记忆与学习	文件型 + SQLite 记忆、语义召回、时间知识图谱、受控技能演化
扩展性	技能、插件、钩子、MCP、ClawHub、A2A、ACP – 全部插入同一运行时
接口	Rust SDK、原生 Work UI、本地 Web UI、HTTP/SSE/WebSocket API、数十种聊天适配器（Telegram、Discord、Slack、Matrix 等）
安全与运维	工具审批门、范围能力授权、Docker 沙箱、出口策略、机密编辑、审计轨迹

---

🛠️ 如何开始

1. Work（桌面） – brew tap microclaw/tap && brew install --cask microclaw-work（Apple Silicon macOS）或从 v0.9.0 版本下载 Linux/Windows 预览版。
2. Server – 一行安装命令：curl -fsSL https://microclaw.org/install.sh | bash（macOS/Linux）或 Windows 的 PowerShell 对应命令。然后运行 microclaw doctor && microclaw setup && microclaw start 并打开 http://127.0.0.1:10961。
3. SDK – 添加到 Cargo.toml：

   microclaw-sdk = { version = "0.9.0", features = ["full"] }
   

   并按照快速入门代码片段以编程方式启动代理。

---

📖 文档与社区

• 文档中心 – docs/README.md 链接到入门指南、SDK 概念、工具目录、安全模型和操作手册。
• 支持 – Discord、Reddit 和公开问题跟踪器。安全披露通过 SECURITY.md。
• 发布节奏 – 稳定分支用于生产，main 用于快速开发。最新稳定版为 v0.9.0。

---

🤔 为什么选择 MicroClaw？

• 单一引擎，多种前端 – 您可以从桌面应用开始，之后切换到服务器，或嵌入相同引擎，无需重写逻辑。
• Rust 优先 – 高性能、低占用空间，且易于以单一二进制文件发布；SQLite 持久化将依赖降至最低。
• 持久、可恢复的工作 – 运行时在每次工具调用后建立检查点，因此长时间运行或中断的任务可以安全恢复。
• 提供商无关 – 原生 Anthropic 支持，加上任何 OpenAI 兼容或本地模型，通过统一消息格式。
• 内置安全 – 内置防护措施、沙箱工具执行和审计轨迹，使其适合生产工作负载。

---

📦 快速技术概览

• 语言：Rust（需要 1.93+，v0.9.0 构建于 1.96 工具链）
• 许可证：MIT
• 打包：Homebrew、Docker（ghcr.io/microclaw/microclaw:latest）、源代码（cargo build --release）
• 平台支持：macOS（Apple Silicon）、Linux（x86_64/arm64）、Windows（便携式预览版）

---

MicroClaw 让您在本机或作为服务运行复杂、有状态的 AI 代理，专注于可靠性、扩展性和安全性——全部来自单一 Rust 代码库。