Brand LogoBrand Logo (Dark)
首页智能体广场工具包广场GitHub 精选提交智能体博客

分类

  • AI 绘画
  • AI 音频
  • 自动化工具
  • 聊天机器人
  • 编程工具
  • 金融工具

分类

  • 大语言模型
  • 营销工具
  • 零代码/低代码
  • 研究与搜索
  • 视频与动画
  • 视频编辑

GitHub 精选

  • DeerFlow — 字节跳动开源超级智能体框架

最新博客

  • OpenClaw vs Composer 2 Which AI Assistant Delivers More Value
  • Google AI Studio vs Anthropic Console
  • Stitch 2.0 vs Lovable Which AI Design Tool Wins in 2026
  • Monetizing AI for Solopreneurs and Small Teams in 2026
  • OpenClaw vs MiniMax Which AI Assistant Wins in 2026

最新博客

  • OpenClaw vs KiloClaw Is Self-Hosting Still Better
  • OpenClaw vs Kimi Claw
  • GPT-5.4 vs Gemini 3.1 Pro
  • Farewell to Bloomberg Terminal as Perplexity Computer AI Redefines Finance
  • Best Practices for OpenClaw
LinkStartAI© 2026 LinkstartAI. 版权所有。
联系我们关于
  1. 首页
  2. GitHub 精选
  3. NanoClaw
NanoClaw logo

NanoClaw

一个用容器做安全边界的个人 Claude 助手:TypeScript/Node.js 单进程编排,WhatsApp 入口,SQLite 记忆与定时任务。
8.6kTypeScriptMIT
typescriptnodejsclaudeanthropicclaude-codeclaude-agent-sdk
ai-assistant
self-hosted
container-sandbox
docker
apple-container
secure-by-isolation
whatsapp-bot
baileys
scheduled-jobs
task-scheduler
sqlite
memory
group-isolation
agent-swarms
multi-agent
tool-execution
web-fetch
skill-system
ai-native-setup
audit-friendly-codebase
single-process
personal-assistant
alternative-to-openclaw
openclaw-like

项目简介

NanoClaw 是一个“为单个用户打造、能被彻底看懂”的个人 AI 助手实现:它把智能体执行环境放进真正的 Linux 容器里,把文件系统与进程权限交给内核隔离,而不是靠应用层的权限开关赌提示词不越界。系统以 TypeScript + Node.js 的单进程编排为骨架,通过 WhatsApp 作为主入口,把对话触发、调度任务、工具执行与记忆写入串成一个可维护的循环。记忆与状态走本地优先路线:用 SQLite 记录消息、会话与组状态;每个群组拥有独立的工作目录与记忆文件,天然隔离上下文。安装与运维强调 AI-native:让 Claude Code 在交互里完成依赖、认证与容器运行时设置,适合把“私人助理 + 轻量自动化”落在你自己的机器或小云主机上。

痛点 vs 创新

✕传统痛点✓创新方案
把智能体跑在宿主机上时,命令执行与文件访问很难做到“默认安全”,一旦提示词越界就会直接伤到真实环境。NanoClaw 把容器当作第一层安全边界:优先用 Docker 或 Apple Container 做文件系统隔离,让工具执行落在可控沙箱里。
大型通用助手往往把功能塞进核心,模块与依赖膨胀后,个人用户很难审计、定制与长期维护。用“少文件、单进程、可读性优先”的实现把定时任务、消息循环、记忆存储与容器运行器串成最短路径,并把扩展能力外置为 skills,避免核心膨胀。

架构深度解析

单进程消息循环 + 组队列
用单一 Node 进程驱动轮询与路由:消息进入后按“群组”分发到独立队列,队列再通过全局并发上限做节流,保证每个群的上下文与执行节奏可预测。
容器化执行器(OS 级隔离)
工具与智能体执行不直接触碰宿主机:把可访问目录显式挂载进容器,命令在容器内运行,隔离边界由容器运行时提供,从而把权限收敛到文件系统与进程级别。
SQLite 状态机 + 记忆存储
把消息、群组、会话与运行状态写入 SQLite,既能做可靠的断点续跑,也能让每个群持有自己的记忆文件与隔离工作区;在此之上叠加定时任务,形成“对话触发 + 调度触发”的双入口自动化。

部署指南

1. 准备运行环境(macOS/Linux,Node 20,与容器运行时)

bash
1node --version  # 需要 v20.x;docker --version  # Linux/macOS 可用;macOS 可选 Apple Container

2. 克隆仓库并进入目录

bash
1git clone https://github.com/qwibitai/nanoclaw.git && cd nanoclaw

3. 用 Claude Code 启动引导式安装与认证(会完成依赖与容器配置)

bash
1claude

4. 完成初始化后运行交互式自检/调试流程

bash
1# 在 Claude Code 提示下运行:setup / debug,并按输出验证 WhatsApp 连接与任务调度

落地场景

核心场景目标人群解决方案最终收益
安全优先的私人 WhatsApp 助手个人与独立开发者用 WhatsApp 触发查询、总结与自动化指令,工具执行在容器中隔离把私人自动化落到自托管环境,降低“提示词越权触碰宿主机”的风险
群组隔离的家庭/团队小助理家庭群或小团队每个群独立记忆与目录,定时推送日报/提醒/清单上下文不串线,任务可长期运行且易复盘
最小可审计的 AI 运维脚本代理想把重复操作交给 AI 的工程师把常见运维/仓库维护任务做成 scheduled jobs用可读代码与容器边界获得可控的自动执行

避坑指南

避坑指南
  • 依赖特定运行时与工具链:需要 Node 20、Claude Code,以及 Docker/Apple Container;在受限环境里需要先打通这些基础设施。
  • 这是面向单用户的实现而非通用框架:扩展新渠道/新功能更鼓励通过 skills 改造你的 fork,而不是期待上游覆盖所有场景。

常见问题

为什么必须用容器,而不是在宿主机上做权限检查?▾
NanoClaw 把容器当作信任边界:命令在隔离进程里执行、文件系统只暴露显式挂载目录。相比“应用层 allowlist”,这更接近操作系统级最小权限。
WhatsApp 通道是怎么实现的?▾
它走 WhatsApp Web 生态,常见实现会基于 Baileys 之类的库建立会话、收发消息与轮询循环;你可以在 fork 里把通道替换成别的入口。
记忆与定时任务如何避免串线?▾
每个群组拥有独立目录与记忆文件,消息进入后按组进入队列,队列再受全局并发限制;状态持久化在本地数据库里,重启后也能继续按组恢复执行节奏。
在 GitHub 上查看

项目指标

Star 数8.6 k
编程语言TypeScript
开源协议MIT
部署难度中等

Table of Contents

  1. 01项目简介
  2. 02痛点 vs 创新
  3. 03架构深度解析
  4. 04部署指南
  5. 05落地场景
  6. 06避坑指南
  7. 07常见问题

相关项目

DeerFlow — 字节跳动开源超级智能体框架
DeerFlow — 字节跳动开源超级智能体框架
26.1 k·Python
OpenMAIC
OpenMAIC
0·TypeScript
gstack
gstack
0·TypeScript
Pi Monorepo
Pi Monorepo
14.1 k·TypeScript