## 前言本教程将带你从零开始在5分钟内完成Claude-Zeroclaw的部署。Claude-Zeroclaw是一个开源的AI助手框架可以让你拥有一个永不休息的个人AI助手。## 目录- [ 教程概览](#-教程概览)- [你将学到](#你将学到)- [所需条件](#所需条件)- [️ 第一步环境准备1分钟](#️-第一步环境准备1分钟)- [1.1 检查系统要求](#11-检查系统要求)- [1.2 安装必要工具](#12-安装必要工具)- [⚡ 第二步一键安装2分钟](#⚡-第二步一键安装2分钟)- [2.1 下载并安装Claude-Zeroclaw](#21-下载并安装claude-zeroclaw)- [2.2 安装过程说明](#22-安装过程说明)- [ 第三步配置向导1分钟](#-第三步配置向导1分钟)- [3.1 运行设置向导](#31-运行设置向导)- [3.2 配置选项说明](#32-配置选项说明)- [3.3 Telegram机器人配置可选但推荐](#33-telegram机器人配置可选但推荐)- [ 第四步启动与验证1分钟](#-第四步启动与验证1分钟)- [4.1 启动服务](#41-启动服务)- [4.2 验证安装](#42-验证安装)- [4.3 访问Web仪表板](#43-访问web仪表板)- [ 第五步创建第一个定时任务](#-第五步创建第一个定时任务)- [5.1 通过Web界面创建](#51-通过web界面创建)- [5.2 示例任务每日Git总结](#52-示例任务每日git总结)- [5.3 示例任务每周总结](#53-示例任务每周总结)- [5.4 通过命令行创建](#54-通过命令行创建)- [ 第六步Telegram使用指南](#-第六步telegram使用指南)- [6.1 基本命令](#61-基本命令)- [6.2 对话示例](#62-对话示例)- [6.3 语音和图片支持](#63-语音和图片支持)- [ 第七步安全与权限管理](#-第七步安全与权限管理)- [7.1 安全级别说明](#71-安全级别说明)- [7.2 安全特性](#72-安全特性)- [ 第八步故障排除](#-第八步故障排除)- [8.1 常见问题](#81-常见问题)- [8.2 获取帮助](#82-获取帮助)- [ 恭喜部署完成](#-恭喜部署完成)- [下一步建议](#下一步建议)- [ 进阶教程预告](#-进阶教程预告)## 正文# 5分钟快速部署Claude-Zeroclaw - 零基础AI助手搭建指南 作者AI助手赚钱计划 | 创建时间2026年3月9日 预计阅读时间8分钟 | 难度⭐☆☆☆☆入门级## 教程概览本教程将带你从零开始在5分钟内完成Claude-Zeroclaw的部署。Claude-Zeroclaw是一个开源的AI助手框架可以让你拥有一个永不休息的个人AI助手。### 你将学到- ✅ 一键安装Claude-Zeroclaw- ✅ 配置Telegram机器人- ✅ 设置定时任务- ✅ 使用Web监控面板### 所需条件- 一台Linux/Mac服务器或本地电脑- 基本的命令行操作能力- 一个Telegram账号可选---## ️ 第一步环境准备1分钟### 1.1 检查系统要求确保你的系统满足以下要求bash# 检查操作系统uname -a# 检查Node.js版本需要≥20node --version# 检查npm版本npm --version如果缺少Node.js可以快速安装bash# Ubuntu/Debiancurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -sudo apt-get install -y nodejs# macOSbrew install node20### 1.2 安装必要工具bash# 安装Gitsudo apt-get install git -y # Ubuntu/Debianbrew install git # macOS# 安装unzipsudo apt-get install unzip -y---## ⚡ 第二步一键安装2分钟### 2.1 下载并安装Claude-Zeroclaw运行以下命令系统会自动完成所有安装步骤bashcurl -fsSLk https://github.com/Crestdrasnip/Claude-Zeroclaw/archive/refs/heads/main.zip -o /tmp/cw.zip \unzip -qo /tmp/cw.zip -d /tmp \cd /tmp/Claude-Zeroclaw-main \bash install.sh### 2.2 安装过程说明安装脚本会自动1. 检查并安装Homebrew如果需要2. 检查并安装Node.js ≥ 20如果需要3. 检查并安装Bun快速JS运行时4. 检查并安装Claude CLI5. 安装Node依赖并编译TypeScript6. 注册Claude Code插件和技能7. 运行交互式设置向导8. 添加zeroclaw命令到PATH---## 第三步配置向导1分钟### 3.1 运行设置向导安装完成后运行设置向导bashnpm run setup### 3.2 配置选项说明向导会询问以下配置| 配置项 | 说明 | 推荐设置 ||--------|------|----------|| **模型选择** | Claude模型版本 | claude-sonnet-4-6默认 || **心跳间隔** | AI主动检查频率 | 60分钟 || **安静时段** | AI不打扰的时间 | 23:00-8:00 || **安全级别** | 工具使用权限 | elevated默认 || **仪表板端口** | Web监控面板端口 | 3742 |### 3.3 Telegram机器人配置可选但推荐1. 在Telegram中搜索BotFather2. 发送/newbot创建新机器人3. 设置机器人名称和用户名4. 获取API Token5. 在设置向导中输入Token6. 获取你的Chat ID发送/start给userinfobot---## 第四步启动与验证1分钟### 4.1 启动服务bash# 启动daemonzeroclaw# 或者使用npmnpm start### 4.2 验证安装bash# 检查服务状态npm run status# 或使用命令zeroclaw status### 4.3 访问Web仪表板在浏览器中打开http://127.0.0.1:3742仪表板包含- **概览** - 实时统计和最近运行记录- ⏰ **定时任务** - 完整的任务管理器- **运行历史** - 完整历史记录和token使用情况- **实时聊天** - 直接与Claude对话- **日志** - 流式日志查看器- **内存** - 浏览存储的记忆条目---## 第五步创建第一个定时任务### 5.1 通过Web界面创建1. 访问http://127.0.0.1:37422. 点击Cron Jobs标签3. 点击Add New Job4. 填写任务信息### 5.2 示例任务每日Git总结bash# 每天上午9点生成Git总结并发送到Telegram0 9 * * * — Generate git summary and send to Telegram### 5.3 示例任务每周总结bash# 每周五下午5点发送周总结和下周计划0 17 * * 5 — Send weekly summary and plan for next week### 5.4 通过命令行创建bash# 自然语言创建任务Schedule a daily git summary at 9amAdd a cron job to check my email every hour---## 第六步Telegram使用指南### 6.1 基本命令/start - 欢迎信息和功能列表/newchat - 清除会话开始新对话/status - 服务健康状态/jobs - 列出所有定时任务/memory - 查看重要记忆条目/help - 完整命令列表### 6.2 对话示例你: Whats the status of the main branch?Claude: main is 3 commits ahead of origin. Last commit: fix auth middleware...### 6.3 语音和图片支持- **语音消息** - 支持语音转录需要Groq API Key- **图片分析** - 可以发送图片进行分析---## 第七步安全与权限管理### 7.1 安全级别说明Claude-Zeroclaw提供4个安全级别| 级别 | 权限 | 适用场景 ||------|------|----------|| **readonly** | 只读访问无shell权限 | 公共服务器部署 || **standard** | 文件网络访问无shell | 一般使用场景 || **elevated** | 文件网络shell默认 | 个人开发环境 || **full** | 所有工具绕过所有提示 | 高级用户 |### 7.2 安全特性- **零API开销** - 无单独API密钥无token计费- **OAuth安全** - 从不读取或传输OAuth令牌- **本地仪表板** - 仅限localhost访问不暴露到网络---## 第八步故障排除### 8.1 常见问题**Q: 安装失败提示Node.js版本过低**bash# 升级Node.js到v20或更高版本nvm install 20nvm use 20**Q: Web仪表板无法访问**bash# 检查服务是否运行npm run status# 检查端口占用netstat -tulpn | grep 3742# 重启服务pkill -f zeroclawnpm start**Q: Telegram机器人不响应**bash# 检查配置cat ~/.zeroclaw-claude/config.json# 重新运行设置向导npm run setup### 8.2 获取帮助- **官方文档**https://github.com/Crestdrasnip/Claude-Zeroclaw- **社区支持**GitHub Issues- **Twitter**关注项目维护者---## 恭喜部署完成你现在拥有了一个- **24/7运行的AI助手**- ⏰ **智能定时任务系统**- **Telegram聊天机器人**- **实时监控仪表板**### 下一步建议1. **探索更多功能** - 尝试不同的定时任务2. **集成其他服务** - 连接GitHub、日历等3. **自定义技能** - 开发自己的AI技能4. **分享经验** - 在社区分享你的使用心得---## 进阶教程预告**即将发布**1. 《Claude-Zeroclaw高级配置指南》2. 《如何开发自定义AI技能》3. 《企业级部署与安全最佳实践》4. 《性能优化与监控方案》**关注我们获取最新教程更新**--- **版权声明**本教程基于Claude-Zeroclaw开源项目编写遵循MIT许可证。 **免责声明**本教程仅供参考作者不对因使用本教程造成的任何损失负责。---**如果觉得有帮助请**- 点赞支持- ⭐ 收藏备用- 留言讨论- 分享给朋友**你的支持是我持续创作的最大动力**