NanoClaw

轻量级容器隔离个人 AI 助手框架，通过 Claude Code 代理对接 WhatsApp、Telegram、Discord 等多种消息平台，支持定时任务、多通道隔离与多模型切换。

核心定位#

NanoClaw 是 OpenClaw 的极简替代品，以约 3,900 行代码（15 个源文件）实现完整的个人 AI 助手能力，面向个人或小团队场景，不提供 Web UI 或管理后台，所有交互通过消息通道或 Claude Code 完成。

安全与隔离模型#

容器隔离：代理在 Docker 容器中运行，实现文件系统级 OS 隔离，非应用层权限检查
可选隔离方案：Docker Sandboxes micro-VM 隔离、macOS 原生 Apple Container（技术细节待确认）
凭证安全：代理不持有原始 API 密钥，出站请求通过 OneCLI Agent Vault 注入，支持按代理策略和速率限制

多通道消息#

支持 13+ 消息通道按需安装：WhatsApp、Telegram、Discord、Slack、Microsoft Teams、iMessage、Matrix、Google Chat、Webex、Linear、GitHub、WeChat、邮件（Resend）。通过 /add-<channel> 技能安装适配器。

V2 灵活隔离模型：每通道可连接独立代理（完全隐私）、共享代理（统一记忆）、或折叠为单一共享会话。

代理与工作区#

每 agent group 拥有独立工作区：CLAUDE.md、记忆、容器和挂载点
多模型支持：原生 Claude Code（Anthropic Agent SDK）；可选 /add-codex（OpenAI Codex）、/add-opencode（OpenRouter/Google/DeepSeek）、/add-ollama-provider（本地开源模型），Provider 可按 agent group 配置
定时任务：设定定期执行的 Claude 任务，自动通过消息通道回复结果
网络访问：代理可搜索和抓取网页内容

技能体系#

trunk 仅发布注册表和基础设施，通道适配器和替代提供商通过 /add-<name> 技能按需安装到用户 fork 中，启动时自注册。

架构设计#

数据流：

消息应用 → 宿主进程（路由器） → inbound.db → 容器（Bun, Claude Agent SDK） → outbound.db → 宿主进程（投递） → 消息应用

核心决策：

单进程宿主：一个 Node.js 进程编排所有 session 的代理容器，无微服务、无消息队列
双 SQLite 模型：每个 session 两个 SQLite 文件（inbound.db / outbound.db），各仅一个写入者，避免跨挂载争用和 IPC 开销
实体模型：用户 → 消息群组 → 代理群组 → 会话
60 秒 sweep：宿主进程每 60 秒检测过期、唤醒到期消息、处理循环任务

关键模块：

文件	职责
`src/index.ts`	入口：DB 初始化、通道适配器加载、投递轮询、sweep
`src/router.ts`	入站路由：消息群组 → 代理群组 → session → inbound.db
`src/delivery.ts`	轮询 outbound.db、投递消息、处理系统动作
`src/host-sweep.ts`	60s sweep：过期检测、到期唤醒、循环任务
`src/container-runner.ts`	生成 agent group 容器、注入 OneCLI 凭证
`container/agent-runner/`	Bun agent-runner：轮询循环、MCP 工具、provider 抽象