nanocoai/nanoclaw

项目概览

NanoClaw 提供操作系统级别的文件系统隔离运行代理，并通过按需技能模块扩展功能。它致力于解决复杂软件广泛获取个人数据的安全隐忧，为需要高度隔离和可控定制的用户提供了一种易于理解的方案。

项目类型

AI Agent · AI 工作流

应用场景

自动化执行

部署方式

查看项目说明

License

MIT

适合谁

• 希望通过阅读小型代码库来确切了解系统运作方式，且需要为代理提供操作系统级别文件系统隔离的用户。
• 愿意通过修改代码或分支来定制频道和提供者模块，以满足特定功能需求的开发者或高级用户。

核心能力

• 在具有文件系统隔离的独立 Linux 或 Docker 容器中运行代理，并显式控制挂载点。
• 在频道适配器、代理组、会话和容器化代理之间路由消息；频道适配器通过技能单独安装。
• 支持由代理执行的周期性任务，并带有可选的脚本门控，以在没有工作时避免唤醒代理。
• 为每个代理组提供单独的指令、记忆、容器和明确允许的挂载点。
• 从包含指令、MCP 工具和不含机密信息的技能的可重用捆绑包中创建即可运行的代理。
• 通过技能将请求的频道、提供者或其他模块复制到标准路径中，从而扩展代码库。

限制与风险

• 项目明确指出，更改系统行为需要修改代码，而不是仅仅编辑配置文件。
• 主干仓库仅包含频道注册表和基础设施，具体的频道适配器必须按需通过技能安装。
• 用户需自行审查正在运行的容器内容以及明确挂载的目录，以防范潜在风险。

如何开始

• 项目提供脚本化安装程序（运行 bash nanoclaw.sh），可自动引导 Node、pnpm 和 Docker，注册凭证，构建代理容器并配对初始频道。成功路径包括克隆仓库、运行脚本、配对频道和对指定代理发送消息。

核验依据

• GitHub 项目简介: A lightweight alternative to OpenClaw that runs in containers for security.
• README: I wouldn't have been able to sleep if I had given complex software I didn't understand full access to my life.
• README: An AI assistant that runs agents securely in their own containers. Lightweight, built to be easily understood and completely customized for your needs.
• README: Agents run in their own Linux containers with filesystem isolation, not merely behind permission checks.
• README: It installs Node, pnpm, and Docker if missing, registers your Anthropic credential with OneCLI, builds the agent container, and pairs your first channel (iMessage, Telegram, Disco…

来源更新时间：2026-08-01T18:16:37Z