NanoClaw

1. 产品档案 (Product Profile)

NanoClaw 是一个轻量级、开源的个人 AI 代理框架，旨在运行在用户自己的机器上。它通过容器隔离技术（如 Docker 或 Apple Container）提供操作系统级别的安全性，并基于 Anthropic 的 Claude Agent SDK 构建，让用户能够完全拥有和控制自己的 AI 助手。

核心价值
NanoClaw 解决了传统大型 AI 代理框架（如 OpenClaw）存在的安全性差、代码复杂、难以审计以及用户无法完全掌控代理行为等痛点。它强调透明、可审计的代码库、强大的隔离机制和高度的可定制性，为用户提供一个安全、私密且可信赖的个人 AI 自动化解决方案。

适用人群
NanoClaw 的主要用户包括开发者、技术运维人员以及注重隐私和安全的个人用户。它特别适合那些希望对 AI 代理的运行时行为、容器隔离和本地工作流程拥有更严格控制的用户，而非寻求一键式聊天机器人体验的普通用户。同时，它也适用于需要部署数字员工以自动化高风险工作流（如金融、医疗、法律或国防领域）的个人和小型团队。

2. 核心功能详解 (Core Features)

• 操作系统级容器隔离与卓越安全性
  NanoClaw 的核心设计理念是“安全至上”。每个 AI 代理组都在独立的 Docker 容器（适用于 Linux/WSL2）或 Apple Container（适用于 macOS）中运行，确保了操作系统级别的隔离。这意味着代理拥有独立的沙盒环境、文件系统和进程空间，只能访问用户明确挂载的目录。用户凭证不会直接存储在容器内部，而是通过 OneCLI 的 Agent Vault 进行路由，在代理发出请求时动态注入，并实施每代理策略和速率限制。这种设计极大地减少了攻击面，并防止了数据泄露和跨代理的交叉污染，使得整个系统易于审计和理解。

• 多渠道消息集成
  NanoClaw 支持与多种主流消息应用和协作平台集成，使用户能够通过日常使用的平台与个人 AI 代理进行交互和管理。这些支持的渠道包括 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、iMessage、Matrix、Google Chat、Webex、Linear、GitHub、微信以及电子邮件。渠道可以按需安装，避免了不必要的臃肿，用户只加载所需功能。

• AI 原生与自扩展能力
  NanoClaw 采用“AI 原生”设计哲学，摒弃了传统的配置文件和仪表盘，转而通过自然语言指令与底层 Claude Code 进行交互。用户可以直接通过聊天命令（例如在 WhatsApp 中）描述所需功能或更改，Claude Code 将直接修改 NanoClaw 的源代码以实现定制。这种方式使得 NanoClaw 具有强大的自扩展能力，代理可以根据用户的需求生成、测试和注册新的技能，从而保持代码库的精简和高度个性化。

• 代理集群 (Agent Swarms) 支持
  NanoClaw 是首个支持代理集群（Agent Swarms）的个人 AI 助手。这意味着用户可以指示其主代理生成一组专业的子代理，这些子代理能够在隔离的内存环境中协同完成一个复杂的任务。这种能力使得复杂的自动化工作流能够被分解成更小、更易于管理的部分，并且每个子代理的隔离性确保了不同功能之间的数据安全和隐私。

• 定时任务与记忆功能
  除了即时交互外，NanoClaw 还支持创建定时任务，允许 AI 代理在预设时间执行重复性工作并向用户反馈，例如每日早间简报、每周回顾等。代理还具备记忆能力，可以存储个人上下文信息（如健身计划、营养目标、职业目标等），以便在后续的对话中更好地理解用户意图并提供个性化帮助，避免重复提供背景信息。

3. 新手使用指南 (How to Use)

以下是一个用户从零开始设置 NanoClaw 并完成一个核心任务的流程：

第一步：准备主机环境

确保您的机器满足 NanoClaw 的基本系统要求：macOS、Linux 或安装了 WSL2 的 Windows 操作系统，并且安装了 Node.js（版本 20 或更高）、Git 以及容器运行时（macOS 上为 Apple Container，Linux/WSL2 上为 Docker）。确保 Docker Desktop 或 Apple Container 正在运行。

第二步：安装并验证 Claude Code

NanoClaw 是围绕 Claude Code 构建的，因此您需要先安装并验证 Claude Code。在终端中运行 claude 命令，确认其正常工作并完成认证（通过 Claude.ai 账户登录或使用 Anthropic API 密钥）。

第三步：克隆 NanoClaw 仓库

打开终端，使用 Git 克隆 NanoClaw 的 GitHub 仓库到您的本地机器：git clone https://github.com/nanocoai/nanoclaw.git。然后进入项目目录：cd nanoclaw。

第四步：启动 Claude Code 并运行引导设置

在 NanoClaw 目录中，启动 Claude Code：claude。进入 Claude Code 环境后，运行引导设置命令：/setup。该脚本将引导您完成安装依赖、注册 Anthropic 凭证、构建代理容器以及配对第一个通讯渠道（如 WhatsApp）的全过程。如果某个步骤失败，Claude Code 会自动诊断并协助您解决问题。

第五步：添加渠道与技能并进行交互

完成基础设置后，您可以根据需求添加更多的消息渠道和特定技能。例如，若要添加 Telegram 支持，您可以在聊天中直接向代理发出指令（例如：“Add support for Telegram”）。代理会通过 Claude Code 修改自身代码以实现该功能。然后，您可以开始通过消息与代理交互，例如发送“what’s my day looking like?”来获取日历和邮件摘要。

4. 市场反响与评价 (Market Review)

行业地位
NanoClaw 在 AI 代理领域迅速崛起，成为 OpenClaw 等大型、复杂框架的领先轻量级和安全替代方案。它因其独特的安全模型、精简的代码库和对个人用户控制的强调而受到广泛关注。该项目在 GitHub 上获得了超过 29,935 颗星，并得到了 AI 开发者社区中知名人士（如 swyx 和 Andrej Karpathy）的推荐。NanoClaw 还与 Docker 建立了合作关系，于 2026 年 3 月 13 日正式宣布集成 Docker Sandboxes，进一步巩固了其在安全 AI 代理领域的地位。

用户口碑

• 正面评价 (Pros)

  • 高安全性与可审计性：NanoClaw 默认采用操作系统级的容器隔离，代码库小巧（核心代码约 500 行，总计约 3900 行），易于安全审计，攻击面小，非常适合处理敏感数据和高风险工作流，满足医疗、金融等受监管行业的安全要求。
  • 轻量级与资源高效：运行时占用资源少，可在中小型 VPS 上运行，运营成本可预测。
  • 高度可定制：通过 AI 原生设计，用户可以轻松地通过自然语言指令定制代理行为和添加功能，而不是修改复杂的配置文件或面对臃肿的预设功能。
  • 稳定且可控：升级迭代稳定，每次发布影响范围小，避免了大型框架升级可能带来的回归问题。
  • 个人控制：专为个人用户设计，提供对 AI 代理的完全所有权和控制，解决了对大型AI系统信任不足的问题。
  • 成本效益：NanoClaw 本身免费开源，虽然使用 Claude API 需付费，但其轻量化设计有助于减少 token 使用量，通过订阅可避免按次计费的高昂成本。

• 负面评价 / 不足 (Cons)

  • 技术门槛：安装和配置需要一定的技术背景，包括熟悉 Git、终端和容器化工作流，不如一些完全托管的工具那样“一键即用”。
  • 集成生态系统较小：相比 OpenClaw 庞大的集成生态和多 LLM 支持，NanoClaw 开箱即用的集成功能较少，默认主要针对 Anthropic Claude 模型。
  • 存在延迟：由于容器隔离机制，发送消息到收到回复之间可能存在 3-5 秒或更长的延迟。
  • 无图形界面：默认不提供传统意义上的仪表板或调试用户界面，主要通过聊天进行交互和管理。

重要信息

• GitHub 星标：截至目前，NanoClaw 在 GitHub 上获得了超过 29,935 颗星。
• 发布时间：该项目于 2026 年 2 月初发布。
• 公司与融资：由 Gavriel Cohen 和 Lazer Cohen 共同创建的 NanoCo 公司支持，已完成“亲友轮”融资，并正在寻求风险投资。
• 重要合作伙伴：于 2026 年 3 月 13 日与 Docker 建立合作伙伴关系，正式宣布集成 Docker Sandboxes，并获得了 TechCrunch 和 ZDNET 等知名媒体的报道。

5. 常见问题解答 (FAQ)

1. NanoClaw 的收费模式是怎样的？
   NanoClaw 本身是完全免费且开源的（MIT 许可）。然而，它运行在 Claude Agent SDK 上，这意味着您需要一个 Claude API 密钥或 Claude Code 订阅来支付底层 AI 模型（Anthropic Claude）的使用费用，具体成本取决于您的使用量。

2. NanoClaw 是否安全？它如何保护我的数据？
   安全性是 NanoClaw 的核心设计原则。每个 AI 代理组都在独立的 Linux 容器（或 Apple Container）中运行，具有自己的文件系统和进程空间，并且只能访问您明确允许挂载的目录。用户凭证不会存储在容器中，而是通过 OneCLI 的 Agent Vault 在代理发出请求时注入。此外，其精简的代码库（约 3900 行）使得用户可以实际审计所有代码行为。

3. NanoClaw 支持哪些消息应用和集成？
   NanoClaw 支持多种消息应用，包括 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、iMessage、Matrix、Google Chat、Webex、Linear、GitHub、微信以及电子邮件。渠道可以按需安装，以避免不必要的臃肿。

4. NanoClaw 与 OpenClaw 有何主要区别？
   NanoClaw 是作为 OpenClaw 的轻量级、安全替代品而设计的。OpenClaw 是一个庞大且复杂的框架（数十万行代码），存在安全漏洞和复杂性问题。NanoClaw 则采取相反的方法，代码库精简（约 3900 行），采用操作系统级别的容器隔离而非应用层沙箱，强调个人所有权、可审计性和高度安全性。

5. NanoClaw 是否支持中文或其他非英语语言？
   作为基于 Claude Agent SDK 的 AI 代理，其处理能力依赖于底层 LLM 模型（Claude），通常支持多语言。功能定制依赖于 Claude Code 的自然语言指令处理能力，因此理论上支持中文交互。具体功能支持情况，请以官网最新信息为准。

6. 运行 NanoClaw 有哪些系统要求？
   您需要一台运行 macOS、Linux 或带有 WSL2 的 Windows 系统的设备。此外，还需要安装 Node.js（版本 20 或更高）、Git、以及容器运行时（macOS 上为 Apple Container，Linux/WSL2 上为 Docker）。同时，需要安装并认证 Anthropic Claude Code。

7. NanoClaw 是否支持多种 AI 模型？
   默认情况下，NanoClaw 使用 Claude Sonnet 模型，并且设计上主要围绕 Anthropic 的堆栈。用户可以通过指令切换到其他 Claude 模型（如 Claude Opus）。如果需要集成来自其他提供商（如 OpenAI）的模型，则需要进行更深度的修改来替换 Claude Agent SDK 运行时。

8. 如何定制 NanoClaw 的功能或行为？
   NanoClaw 的定制方式非常独特。您无需编辑配置文件，而是直接通过聊天（例如在 WhatsApp 中）向您的代理描述您希望进行的更改或添加的功能。Claude Code 将会理解您的意图，并直接修改 NanoClaw 的源代码以实现这些定制。

9. NanoClaw 的部署和设置过程复杂吗？
   相对于完全托管的 AI 助手，NanoClaw 需要一定的技术知识（如使用 Git、终端命令和 Docker）。然而，其提供了详细的引导脚本和 Claude Code 的自动化协助，这使得它在自托管 AI 代理项目中相对更容易上手。

10. NanoClaw 有没有图形用户界面 (GUI) 或仪表盘？
    NanoClaw 的设计哲学是极简主义和 AI 原生。默认安装不提供传统的图形仪表盘或调试用户界面。所有的交互、配置和管理主要通过您连接的消息应用和 Claude Code 终端进行。