简介NanoClaw是一个开源的个人AI助手平台由开发者gavrielc创建。该项目采用极简设计理念将Claude AI助手运行在安全的容器环境中提供轻量级、高安全性的个人AI助手解决方案。与功能复杂的OpenClaw项目包含52模块、45依赖不同NanoClaw强调代码的简洁性和可理解性整个代码库可在8分钟内完全理解。核心价值极简架构单一进程少量源文件无微服务复杂架构安全隔离基于Linux/Apple容器实现真正的进程隔离AI原生体验通过Claude Code引导安装和配置无需传统安装向导技能优先通过技能扩展功能避免代码膨胀设计哲学NanoClaw遵循小而美的设计理念不追求功能堆砌而是专注于为单个用户提供精准满足需求的解决方案。用户可以通过fork项目并让Claude Code根据具体需求进行定制化修改。主要功能1. 安全容器化架构代理运行在真正的Linux容器macOS使用Apple ContainerLinux使用Docker中具有文件系统隔离能力。每个容器只能访问显式挂载的目录确保系统安全性。Bash命令在容器内安全执行不会影响主机系统。2. 多通道通信支持原生支持WhatsApp集成可通过手机与助手交互。隔离的群组上下文每个群组拥有独立的CLAUDE.md记忆和文件系统。主通道用于管理控制支持自我对话进行管理员操作。可扩展架构支持通过技能添加其他通信平台。3. 智能任务调度支持定时任务功能可按计划运行Claude并返回结果。灵活的任务配置支持按日、周、月等周期设置。任务状态管理可暂停、恢复和监控计划任务。结果回调机制任务完成后可通过消息通知用户。4. 网络访问能力集成网络搜索功能可获取最新网络信息。内容抓取能力支持从网页提取相关信息。安全网络隔离网络访问在受控环境中进行。信息过滤机制确保获取内容的准确性和相关性。5. 技能扩展系统基于技能的扩展机制通过.claude/skills/目录添加新功能。社区技能贡献用户可分享自定义技能。安全技能审核确保添加的功能不会破坏系统稳定性。技能组合使用多个技能可协同工作。安装与配置环境要求基础环境操作系统macOS或Linux系统Node.js版本20.0及以上容器运行时Apple ContainermacOS或DockerLinux内存建议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 最新版本活跃维护中资源内容完整源码核心平台全部源代码技能库社区贡献的功能扩展技能文档安装指南、使用教程、开发文档示例配置各种使用场景的参考配置快速开始准备符合要求的Node.js环境克隆项目代码到本地运行claude /setup完成自动化安装按照引导配置基本参数开始使用个人AI助手项目特色NanoClaw通过其创新的容器化架构和极简设计理念为个人AI助手领域带来了新的思路。其强调代码可读性和安全隔离的特性使得用户可以完全信任并理解系统运行机制。技能扩展机制确保了系统的灵活性和可持续进化能力。无论是技术爱好者还是普通用户都能从这个项目中获得安全、可控的AI助手体验。