简介

NanoClaw是一个开源的个人AI助手平台，由开发者gavrielc创建。该项目采用极简设计理念，将Claude AI助手运行在安全的容器环境中，提供轻量级、高安全性的个人AI助手解决方案。与功能复杂的OpenClaw项目（包含52+模块、45+依赖）不同，NanoClaw强调代码的简洁性和可理解性，整个代码库可在8分钟内完全理解。

核心价值：

• 极简架构：单一进程，少量源文件，无微服务复杂架构

• 安全隔离：基于Linux/Apple容器实现真正的进程隔离

• AI原生体验：通过Claude Code引导安装和配置，无需传统安装向导

• 技能优先：通过技能扩展功能，避免代码膨胀

设计哲学：NanoClaw遵循"小而美"的设计理念，不追求功能堆砌，而是专注于为单个用户提供精准满足需求的解决方案。用户可以通过fork项目并让Claude Code根据具体需求进行定制化修改。

主要功能

1. 安全容器化架构

代理运行在真正的Linux容器（macOS使用Apple Container，Linux使用Docker）中，具有文件系统隔离能力。每个容器只能访问显式挂载的目录，确保系统安全性。Bash命令在容器内安全执行，不会影响主机系统。

2. 多通道通信支持

原生支持WhatsApp集成，可通过手机与助手交互。隔离的群组上下文，每个群组拥有独立的CLAUDE.md记忆和文件系统。主通道用于管理控制，支持自我对话进行管理员操作。可扩展架构，支持通过技能添加其他通信平台。

3. 智能任务调度

支持定时任务功能，可按计划运行Claude并返回结果。灵活的任务配置，支持按日、周、月等周期设置。任务状态管理，可暂停、恢复和监控计划任务。结果回调机制，任务完成后可通过消息通知用户。

4. 网络访问能力

集成网络搜索功能，可获取最新网络信息。内容抓取能力，支持从网页提取相关信息。安全网络隔离，网络访问在受控环境中进行。信息过滤机制，确保获取内容的准确性和相关性。

5. 技能扩展系统

基于技能的扩展机制，通过.claude/skills/目录添加新功能。社区技能贡献，用户可分享自定义技能。安全技能审核，确保添加的功能不会破坏系统稳定性。技能组合使用，多个技能可协同工作。

安装与配置

环境要求

基础环境：

• 操作系统：macOS或Linux系统

• Node.js版本：20.0及以上

• 容器运行时：Apple Container（macOS）或Docker（Linux）

• 内存：建议4GB以上可用内存

• 存储：至少2GB可用空间

可选组件：

• Claude API访问权限

• WhatsApp账号（用于消息交互）

• 网络连接（API调用和消息接收需要）

安装步骤

快速安装：

克隆项目仓库到本地环境：git clone https://github.com/gavrielc/nanoclaw.git。进入项目目录：cd nanoclaw。运行Claude Code设置命令：claude /setup。系统自动处理依赖安装、认证配置、容器设置和服务配置。

容器运行时选择：

在安装过程中选择容器运行时，macOS用户可选择Apple Container或Docker。Linux系统自动使用Docker运行时。验证容器运行状态，确保环境正常。测试基础功能，确认安装成功。

网络配置：

配置网络代理设置（如需要）。设置API访问权限，确保Claude服务可用。配置消息通道，测试消息收发功能。调整安全策略，平衡功能与安全性。

配置说明

基础配置：

设置触发词，默认为@Andy，可根据喜好修改。配置时区设置，确保任务调度准确。设置日志级别，控制输出详细程度。配置存储路径，管理数据持久化。

安全配置：

容器隔离策略，定义文件系统访问权限。网络访问控制，限制不必要的网络连接。API调用限制，防止过度使用。备份策略配置，定期保存重要数据。

功能配置：

消息处理规则，定义响应策略。任务调度参数，优化执行时间。内存管理设置，控制资源使用。集成服务配置，连接外部系统。

如何使用

基础使用流程

系统初始化：

完成安装后，通过WhatsApp与助手建立连接。在主通道（自我对话）中进行初始设置。配置个人信息和偏好设置。测试基本功能，确保系统正常运行。

日常交互：

在群组中使用触发词（如@Andy）唤醒助手。发送自然语言指令，描述需要执行的任务。等待助手处理并返回结果。根据需要进行后续交互或调整。

任务管理：

通过主通道管理所有定时任务。查看任务状态和执行历史。调整任务计划或参数设置。监控任务执行结果，及时处理异常。

高级功能使用

群组隔离管理：

创建不同的群组用于不同用途（如工作、家庭、项目）。每个群组拥有独立的记忆和文件系统。设置群组间访问权限，控制信息流转。监控各群组活动状态，优化资源分配。

技能扩展应用：

通过技能命令添加新功能，如/add-gmail添加邮件集成。定制个性化技能，满足特定需求。分享自定义技能，促进社区贡献。管理技能生命周期，定期更新优化。

系统监控调试：

使用Claude Code进行系统状态查询。查看运行日志和性能指标。诊断问题并获取修复建议。优化系统配置，提升运行效率。

最佳实践

安全使用建议：

定期审查容器安全策略，确保隔离有效性。监控API使用情况，防止未授权访问。备份重要配置和数据，防止意外丢失。及时更新系统和技能，修复已知漏洞。

性能优化技巧：

根据使用频率调整资源分配。优化任务调度策略，避免资源冲突。合理设置缓存策略，提升响应速度。监控系统负载，及时扩展容量。

使用效率提升：

建立标准化指令模板，减少重复输入。利用定时任务自动化常规工作。组合使用多个技能，实现复杂功能。定期整理对话记录，保持系统整洁。

应用场景实例

实例1：个人生产力助手

场景描述：自由职业者需要管理多个项目、处理日常事务，传统工具分散且效率低下。需要统一的智能助手协调工作流。

解决方案：部署NanoClaw作为个人生产力中心。配置项目群组，分别管理不同客户工作。设置定时任务，自动生成日报和周报。集成日历和邮件，统一管理日程安排。使用文件管理功能，整理项目文档。

实施效果：

• 工作效率提升40%，任务完成更加及时

• 信息整合度提高，减少工具切换时间

• 工作压力减轻，专注重要事务

• 客户满意度提升，响应速度加快

实例2：家庭智能管理中心

场景描述：现代家庭需要管理日程、购物、账单等事务，传统方式协调困难。需要智能系统统一管理家庭事务。

解决方案：建立家庭群组，所有家庭成员共同使用。设置家庭日程提醒，协调各方时间。配置购物清单管理，自动同步需求。集成账单提醒，避免逾期缴费。设置家庭相册整理，自动分类照片。

实施效果：

• 家庭事务协调效率提升3倍，减少沟通成本

• 生活品质提高，琐事处理自动化

• 家庭成员参与度增加，责任分担更均衡

• 家庭记忆保存更完整，重要时刻不错过

实例3：小型团队协作平台

场景描述：创业团队需要高效的内部协作工具，传统系统功能过剩且成本高昂。需要轻量级智能协作方案。

解决方案：为团队配置NanoClaw实例。创建项目群组，隔离不同项目讨论。设置任务分配和跟踪功能。集成文档管理，支持团队知识共享。配置自动报告生成，减少会议时间。

实施效果：

• 团队协作效率提升50%，沟通更加顺畅

• 项目管理透明度提高，进度可控

• 运营成本降低80%，性价比显著

• 团队凝聚力增强，协作更加紧密

实例4：个人学习助手

场景描述：终身学习者需要系统化管理学习进度和资料，传统方法难以坚持。需要智能学习伴侣。

解决方案：配置学习专用群组和管理功能。设置学习计划提醒，保持学习节奏。集成知识管理，整理学习笔记和资料。配置进度跟踪，可视化学习成果。添加测试功能，巩固学习效果。

实施效果：

• 学习坚持性提高，完成率提升60%

• 学习效率优化，知识掌握更牢固

• 学习兴趣增强，成就感提升

• 学习成果量化，进步可视可见

实例5：个人健康管理

场景描述：健康意识强的个人需要系统化健康管理，传统方式难以持续。需要智能健康伴侣。

解决方案：设置健康管理群组和监测功能。配置运动提醒，保持锻炼习惯。集成健康数据记录，跟踪身体指标。设置饮食建议，提供营养指导。添加心情跟踪，关注心理健康。

实施效果：

• 健康习惯养成率提高70%，生活方式改善

• 健康数据系统化，身体状况全面掌握

• 医疗资源使用优化，预防性保健增强

• 生活质量提升，身心状态改善

GitHub地址

项目地址：https://github.com/gavrielc/nanoclaw

项目信息：

• ⭐ Stars：持续增长中

• 📄 许可证：MIT开源许可证

• 💻 主要语言：TypeScript

• 📅 最新版本：活跃维护中

资源内容：

• 完整源码：核心平台全部源代码

• 技能库：社区贡献的功能扩展技能

• 文档：安装指南、使用教程、开发文档

• 示例配置：各种使用场景的参考配置

快速开始：

1. 准备符合要求的Node.js环境

2. 克隆项目代码到本地

3. 运行claude /setup完成自动化安装

4. 按照引导配置基本参数

5. 开始使用个人AI助手

项目特色：

NanoClaw通过其创新的容器化架构和极简设计理念，为个人AI助手领域带来了新的思路。其强调代码可读性和安全隔离的特性，使得用户可以完全信任并理解系统运行机制。技能扩展机制确保了系统的灵活性和可持续进化能力。无论是技术爱好者还是普通用户，都能从这个项目中获得安全、可控的AI助手体验。