单进程消息循环 + 组队列
用单一 Node 进程驱动轮询与路由:消息进入后按“群组”分发到独立队列,队列再通过全局并发上限做节流,保证每个群的上下文与执行节奏可预测。
NanoClaw 是一个“为单个用户打造、能被彻底看懂”的个人 AI 助手实现:它把智能体执行环境放进真正的 Linux 容器里,把文件系统与进程权限交给内核隔离,而不是靠应用层的权限开关赌提示词不越界。系统以 TypeScript + Node.js 的单进程编排为骨架,通过 WhatsApp 作为主入口,把对话触发、调度任务、工具执行与记忆写入串成一个可维护的循环。记忆与状态走本地优先路线:用 SQLite 记录消息、会话与组状态;每个群组拥有独立的工作目录与记忆文件,天然隔离上下文。安装与运维强调 AI-native:让 Claude Code 在交互里完成依赖、认证与容器运行时设置,适合把“私人助理 + 轻量自动化”落在你自己的机器或小云主机上。
| ✕传统痛点 | ✓创新方案 |
|---|---|
| 把智能体跑在宿主机上时,命令执行与文件访问很难做到“默认安全”,一旦提示词越界就会直接伤到真实环境。 | NanoClaw 把容器当作第一层安全边界:优先用 Docker 或 Apple Container 做文件系统隔离,让工具执行落在可控沙箱里。 |
| 大型通用助手往往把功能塞进核心,模块与依赖膨胀后,个人用户很难审计、定制与长期维护。 | 用“少文件、单进程、可读性优先”的实现把定时任务、消息循环、记忆存储与容器运行器串成最短路径,并把扩展能力外置为 skills,避免核心膨胀。 |
1node --version # 需要 v20.x;docker --version # Linux/macOS 可用;macOS 可选 Apple Container1git clone https://github.com/qwibitai/nanoclaw.git && cd nanoclaw1claude1# 在 Claude Code 提示下运行:setup / debug,并按输出验证 WhatsApp 连接与任务调度| 核心场景 | 目标人群 | 解决方案 | 最终收益 |
|---|---|---|---|
| 安全优先的私人 WhatsApp 助手 | 个人与独立开发者 | 用 WhatsApp 触发查询、总结与自动化指令,工具执行在容器中隔离 | 把私人自动化落到自托管环境,降低“提示词越权触碰宿主机”的风险 |
| 群组隔离的家庭/团队小助理 | 家庭群或小团队 | 每个群独立记忆与目录,定时推送日报/提醒/清单 | 上下文不串线,任务可长期运行且易复盘 |
| 最小可审计的 AI 运维脚本代理 | 想把重复操作交给 AI 的工程师 | 把常见运维/仓库维护任务做成 scheduled jobs | 用可读代码与容器边界获得可控的自动执行 |