项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 31091
使用教程
环境要求
- 一台可联网的机器(Linux/macOS 等可运行 shell 的环境)
- Anthropic 凭证(脚本会通过 OneCLI 注册)
- Node、pnpm、Docker(缺失时由 nanoclaw.sh 自动安装)
- 至少一个用于配对的消息渠道账号:Slack、Telegram、Discord、WhatsApp、iMessage,或本地 CLI
安装与启动步骤
-
1克隆仓库
把 nanoclaw 仓库克隆到本地目录 nanoclaw-v2,后续所有操作都在该目录内进行。
git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2 -
2进入项目目录
切换到刚克隆出来的目录,确认里面有 nanoclaw.sh 脚本。
cd nanoclaw-v2 -
3运行一键安装脚本
脚本会自动补齐 Node、pnpm、Docker,注册 Anthropic 凭证,构建 agent 容器,并引导你配对第一个消息渠道。
bash nanoclaw.sh -
4与助手对话
在已配对的渠道里用触发词(默认 @Andy)下达指令,例如让它定时汇总信息。
如何确认成功
脚本跑完后会得到一个可对话的命名 agent;在配对的渠道里发送“@Andy …”并收到回复即表示部署成功。
常见问题
Q:安装脚本中途失败了怎么办?
A:脚本会在某一步失败时自动调用 Claude Code 进行诊断,并从出错的位置继续执行,无需从头重跑。
Q:支持哪些消息平台?
A:Slack、Telegram、Discord、WhatsApp、iMessage,或本地 CLI,安装脚本会让你配对其中一个。
Q:怎么从 NanoClaw v1 迁移过来?
A:在 v1 安装目录旁边克隆一份 v2 检出,然后在该目录运行 bash migrate-v2.sh 完成状态迁移。
Q:迁移脚本该在哪里执行?
A:必须直接在 shell 里运行,不要从 Claude 会话内部执行,因为确定性的部分需要交互式提示和真实 shell I/O。
Q:迁移后 v1 会被替换掉吗?
A:不会。迁移脚本不会切换系统服务,v1 安装保持原样;可以在提示时选择“switch to v2”,或测试后再手动切换。
注意事项
- 默认触发词是 @Andy,用它在渠道中指挥助手管理分组与定时任务。
- 脚本会自动安装缺失的 Node、pnpm 和 Docker,首次运行需要较长时间。
- 迁移脚本会合并 .env、从 registered_groups 初始化 v2 数据库、复制分组目录/会话数据/定时任务,并构建 agent 容器。
- README 未给出端口、配置文件字段等信息,具体配置请参考 docs.nanoclaw.dev。
核心亮点
- 容器化运行,天然隔离安全风险,适合生产环境
- 原生集成 WhatsApp、Telegram、Slack 等主流消息平台
- 基于 Anthropic Agents SDK,具备记忆与定时任务能力
不足之处
- 依赖 Anthropic 生态,迁移到其他 LLM 提供商需额外适配
- 文档/社区待观察
适用场景
- 个人或团队自动化消息处理与通知
- 安全敏感环境中的 AI 助手部署
- 定时任务驱动的日常运营自动化
替代项目
OpenClaw、AutoGPT、Superagent
同类项目推荐
novel-engine
开源
七个AI智能体帮你跑通从创意到完稿的写书流水线
Novel Engine is a desktop app that lets you construct novels. Seven AI agents handle···
fyagent
开源
一次配置个人AI资产,随处带到每个AI工具
For You Agent——AI 时代的个人随身数字人格。把你的模型、AI 账号、技能、提示词和工作方···
Awesome-Self-Improving-Agents
开源
一张图看懂智能体如何自我进化
A curated list for Self-Improvement in Foundation Model Based Agentic Systems.
zer0dex
开源
本地双层记忆,跨项目召回更准,消息前自动查询
A local dual-layer memory pattern for AI agents: a compact, human-readable markdown ···
everyinfra-agent-plugins
开源
给 AI 编程工具一键接入百平台数据采集
EveryInfra MCP server & agent plugin: scraper API for TikTok, Instagram, Amazon, You···
cyber-neo
开源
用 Claude Code 扫描项目,揪出 OWASP 和 CWE 漏洞
Open-source cybersecurity analysis agent for Claude Code. Scans projects for vulnera···
gpt-researcher
开源
给个问题,自动搜全网并写出带引用的研究报告
An autonomous agent that conducts deep research on any data using any LLM providers
agent-toolkit-for-aws
开源
让 AI 智能体直接调用 AWS 官方能力,少踩坑多出活
Official, AWS-supported MCP servers, skills, and plugins to help AI agents build on ···
agent-designer
开源
一套技能,让 Claude、Codex、Gemini 协同干活
Portable SKILLs workspace for Claude Code, Codex, and Gemini — issue-driven workflo···
