NanoClaw 产品需求文档

1. 产品概述

这是什么？

它解决什么问题？

目标用户

技术人员——能自己部署 Docker、配环境变量、改代码的人。这不是给普通消费者用的产品，而是给技术人员自己打造私人助手的工具。

2. 核心功能

2.1 WhatsApp 消息对话

场景：用户在 WhatsApp 里和 AI 对话。

• 支持群聊和私聊两种模式
• 群聊中需要 @Andy（触发词）来唤醒 AI
• 私聊不需要触发词，直接说话就行
• AI 回复会带前缀标识（如 "Andy: 你好"）
• 支持多轮对话，AI 记得上下文

2.2 群组管理

场景：管理不同的 WhatsApp 群，每个群有独立的 AI 人设。

2.3 AI 记忆

每个群有自己的 CLAUDE.md 文件，AI 启动时自动加载。AI 可以主动修改它来"记住"事情。

全局记忆（所有群可见）
 └── "我喜欢用简体中文"
 └── "我的时区是 Asia/Shanghai"

群组记忆（仅本群可见）
 └── main: "我是一名软件工程师"
 └── 家庭群: "家庭成员：爸、妈、妹妹"
 └── 工作群: "我们的项目用 React + Node.js"

2.4 定时任务

用自然语言告诉 AI 你想定时做什么，支持三种方式：

2.5 浏览器自动化

容器内预装 Chromium 浏览器和 agent-browser 工具，AI 可以自主打开网页、点击、填写表单、截图。

2.6 文件系统访问

每个群有自己的读写文件夹。可以通过挂载配置让 AI 访问额外的目录。安全限制：永远不会暴露 .ssh、.aws 等敏感目录。

{
  "containerConfig": {
    "additionalMounts": [
      {
        "hostPath": "~/projects/my-app",
        "containerPath": "my-app",
        "readonly": false
      }
    ]
  }
}

AI 在容器里看到的路径：/workspace/extra/my-app/

2.7 Agent Swarm（Agent 团队）

Claude Agent SDK 支持 Agent Teams 功能。主 Agent 可以派生子 Agent 并行处理子任务，所有子 Agent 共享同一个容器环境。适合需要大量并行处理的复杂任务。

3. 可扩展功能（通过 Skill 添加）

"功能不塞进核心，用 Skill 来加。"

每个 Skill 是一组代码变更的描述，Claude Code 读取后帮你修改代码。好处是：

• 核心代码保持精简
• 你只装你需要的功能
• Skill 之间可以组合叠加
• 卸载就是"不装这个 Skill 重新来过"

4. 安全模型

4.1 信任层级

4.2 安全措施

4.3 密钥管理

.env 文件（宿主机）
  │
  ├── ANTHROPIC_API_KEY      → 通过 stdin 传入容器
  ├── CLAUDE_CODE_OAUTH_TOKEN → 通过 stdin 传入容器
  └── 其他密钥               → 不传入容器

密钥只在内存中存在，不写入容器的磁盘或环境变量。容器内的 Bash 命令执行前，会自动清除环境中的密钥。

5. 用户体验流程

5.1 首次安装

5.2 日常使用

5.3 添加新功能

6. 系统要求

6.1 硬件要求

6.2 软件要求

6.3 账号要求

7. 配置参数

8. 非功能性需求

8.1 性能

8.2 可靠性

8.3 可维护性

9. 与竞品的对比

10. 产品路线图

已完成

• WhatsApp 消息收发
• 容器化 AI 执行
• 群组注册和管理
• 定时任务系统
• 文件系统挂载和安全
• 会话持久化
• 并发控制
• 浏览器自动化
• Agent Teams 支持
• macOS/Linux 服务管理

可扩展（通过 Skill）

• Telegram 支持
• Discord 支持
• Gmail 集成
• 语音转文字
• X/Twitter 集成
• Apple Container 支持

已知待改进

• 修复会话分支过期问题
• 修复超时时序问题
• 修复消息游标提前推进问题
• 改进 Apple Container 网络配置体验

11. 术语表