核心内容摘要
从零实现SimpleCNN：Fashion-MNIST图像分类实战指南
Clawdbot 完整安装教程打造你的 24/7 私人 AI 助手 目录什么是 Clawdbot核心特性系统要求安装前准备安装步骤Windows 安装macOS 安装Linux 安装Docker 安装初始化配置连接聊天平台MCP 工具集成
常见问题解决最佳实践
总结什么是 ClawdbotClawdbot 是一个开源的自托管 AI 助手由 PSPDFKit 创始人 Peter Steinberger 创建。
它可以 24/7 运行在您自己的硬件上作为个人数字助理通过 WhatsApp、Telegram、Slack、Discord 等聊天应用访问。
与 ChatGPT、Siri、Alexa 等商业助手不同Clawdbot 的最大优势在于✅完全自托管所有数据保留在您的基础设施中✅隐私保护对话、记忆和集成都存储在本地✅无限记忆持久化记忆功能跨对话和时间✅开源免费MIT 许可证完全免费使用✅多平台支持原生支持 WhatsApp、Telegram 等主流聊天工具✅50 集成支持 Google Calendar、Gmail、Notion、Spotify 等核心特性 隐私与控制完全自托管所有数据保留在您的基础设施中数据安全对话、记忆和集成都存储在本地可选本地模型支持使用本地 AI 模型以获得最大隐私 AI 模型支持Anthropic Claude推荐最新的 Claude
5 SonnetOpenAI GPT-4 和 GPT-
5其他兼容 OpenAI API 的模型可在不同提供商之间灵活切换 通讯渠道集成WhatsApp原生集成无需 Business APITelegramSlackDiscord其他消息平台️ MCP 工具集成50 种日程管理Google Calendar、Apple Calendar、Fantastical邮件管理Gmail、Outlook、IMAP任务管理Todoist、Things
Apple Reminders笔记文档Notion、Obsidian、Apple Notes智能家居Philips Hue、HomeKit、Home Assistant媒体控制Spotify、Apple Music⚡ 高级功能持久化记忆跨对话和时间计划任务和自动化主动通知文件和文档访问每日简报系统要求硬件要求CPU任何现代处理器x86_64 或 ARM64内存最低 2GB RAM推荐 4GB特别是使用浏览器自动化时存储约 500MB 磁盘空间用于程序和数据网络稳定的互联网连接访问 AI API软件要求Node.jsv
22.
0 或更高版本严格要求操作系统Windows 10/11需要 WSL2macOS 11 或更高版本Linux任何现代发行版成本预估Clawdbot 软件免费MIT 开源许可证AI API 使用Claude API约 $
003/1K 输入 tokens$
015/1K 输出 tokens预计月成本$
取决于使用频率服务器成本如在自己的 Mac/PC 上运行则无额外成本安装前准备
获取 AI API 密钥推荐Anthropic Claude API访问 Anthropic Console注册账号并登录进入 API Keys 页面点击 Create Key 创建新密钥复制并保存密钥格式sk-ant-...备选OpenAI API访问 OpenAI Platform注册账号并登录进入 API Keys 页面创建新密钥并保存
检查 Node.js 版本打开终端执行node --version如果版本低于 v
22.
0需要先升级 Node.js。
升级 Node.js推荐使用 nvm# 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v
0.
3
0/install.sh | bash # 安装 Node.js 22 nvm install 22 nvm use 22安装步骤Windows 安装由于 Clawdbot 依赖 Unix 环境Windows 用户需要通过 WSL2Windows Subsystem for Linux安装。
步骤 1启用 WSL2打开PowerShell管理员模式执行wsl --install -d Ubuntu安装完成后重启计算机。
步骤 2验证 WSL2重启后打开 PowerShell执行wsl --list --verbose确保输出中VERSION列显示为2。
步骤 3进入 Ubuntu 环境在开始菜单中搜索 Ubuntu 并打开首次启动会要求设置用户名和密码。
步骤 4安装 Node.js在 Ubuntu 终端中执行# 添加 NodeSource 仓库 curl -fsSL https://deb.nodesource.com/setup_
x | sudo -E bash - # 安装 Node.js sudo apt-get install -y nodejs # 验证安装 node --version npm --version步骤 5安装 Clawdbot# 下载并执行安装脚本 curl -fsSL https://clawd.bot/install.sh | bash # 启动初始化向导 clawdbot onboard --install-daemon步骤 6访问 Web 界面安装完成后在Windows 浏览器中访问http://localhost:18789macOS 安装macOS 用户有两种安装方式Homebrew推荐和通用脚本。
方法 1Homebrew 安装推荐适用于 macOS 15 或更高版本# 安装 Clawdbot brew install --cask clawdbot这将安装 macOS 原生应用包含菜单栏集成自动更新图形化配置界面方法 2通用脚本安装适用于 macOS 11 或更高版本# 下载并执行安装脚本 curl -fsSL https://clawd.bot/install.sh | bash # 启动初始化向导 clawdbot onboard --install-daemon验证安装# 检查版本 clawdbot --version # 检查运行状态 clawdbot status # 运行诊断 clawdbot doctorLinux 安装Linux 安装最为简单支持所有现代发行版。
步骤 1安装 Clawdbot# 下载并执行安装脚本 curl -fsSL https://clawd.bot/install.sh | bash步骤 2配置 24/7 运行可选如果希望 Clawdbot 在服务器上 24/7 运行执行# 启用用户级 systemd 服务持久化 loginctl enable-linger $USER步骤 3启动初始化向导clawdbot onboard --install-daemon验证安装# 检查版本 clawdbot --version # 检查运行状态 clawdbot status # 测试对话 clawdbot chat Hello, can you confirm youre working?Docker 安装Docker 方式适合容器化部署和云服务器。
步骤 1创建配置目录mkdir -p ~/.clawdbot步骤 2创建 docker-compose.ymlversion:
8 services: clawdbot: image: clawdbot/clawdbot:latest container_name: clawdbot restart: unless-stopped ports: - 18789:18789 volumes: - ~/.clawdbot:/root/.clawdbot environment: - ANTHROPIC_API_KEYyour_api_key_here # 或使用 OpenAI # - OPENAI_API_KEYyour_api_key_here步骤 3启动容器docker-compose up -d步骤 4查看日志docker logs -f clawdbot初始化配置安装完成后需要进行初始化配置。
运行初始化向导clawdbot onboard向导会引导您完成以下配置选择 AI 提供商Claude 或 OpenAI输入 API 密钥选择默认模型claude-
-sonnet-20241022推荐配置聊天渠道WhatsApp、Telegram 等设置记忆功能启用持久化记忆
手动配置高级配置文件位于~/.clawdbot/clawdbot.json可以手动编辑{ aiProvider: anthropic, apiKey: sk-ant-..., model: claude-
-sonnet-20241022, port: 18789, memory: { enabled: true, maxTokens: 100000 }, channels: [] }
启动服务# 启动 Clawdbot clawdbot start # 检查状态 clawdbot status连接聊天平台Clawdbot 支持多种聊天平台以下是详细配置步骤。
WhatsApp 集成WhatsApp 是最受欢迎的集成方式无需 Business API。
步骤 1启动 WhatsApp 登录clawdbot channels login whatsapp步骤 2扫描二维码终端会显示一个二维码使用 WhatsApp 扫描打开 WhatsApp点击右上角菜单 → 已连接的设备点击 连接设备扫描终端中的二维码注意必须在 60 秒内完成扫描。
步骤 3验证连接clawdbot channels list应该看到 WhatsApp 已连接。
Telegram 集成步骤 1创建 Telegram Bot在 Telegram 中搜索BotFather发送/newbot命令按提示设置 Bot 名称和用户名复制 Bot Token格式123456:ABC-DEF...步骤 2添加到 Clawdbotclawdbot channels add telegram按提示输入 Bot Token。
步骤 3开始对话在 Telegram 中搜索您的 Bot发送/start开始对话。
Discord 集成步骤 1创建 Discord 应用访问 Discord Developer Portal点击 New Application进入 Bot 页面点击 Add Bot复制 Bot Token步骤 2启用权限在 Bot 设置页面启用 MESSAGE CONTENT INTENT启用 SERVER MEMBERS INTENT步骤 3添加到 Clawdbotclawdbot channels add discord按提示输入 Bot Token。
步骤 4邀请 Bot 到服务器在 Discord Developer Portal 的 OAuth2 → URL Generator 页面勾选botscope勾选必要的权限Send Messages、Read Message History复制生成的 URL 并在浏览器中打开选择要添加 Bot 的服务器MCP 工具集成MCPModel Context Protocol工具让 Clawdbot 能够访问外部服务。
查看可用工具clawdbot mcp list添加 Google Calendarclawdbot mcp add google-calendar按提示完成 OAuth 授权。
添加 Gmailclawdbot mcp add gmail添加 Notionclawdbot mcp add notion需要提供 Notion Integration Token。
添加 Spotifyclawdbot mcp add spotify配置文件位置MCP 工具配置存储在~/.clawdbot/mcp.json。
常见问题解决问题 1命令未找到Command not found症状执行clawdbot命令时提示 command not found解决方案# 添加 npm bin 目录到 PATH export PATH$(npm config get prefix)/bin:$PATH # 永久生效添加到 ~/.bashrc 或 ~/.zshrc echo export PATH$(npm config get prefix)/bin:$PATH ~/.bashrc source ~/.bashrc问题 2端口冲突症状启动时提示端口 18789 已被占用解决方案 1检查占用端口的进程# macOS/Linux lsof -i :18789 # 杀死进程 kill -9 PID解决方案 2更改端口编辑~/.clawdbot/clawdbot.json{ port: 18790 }问题 3权限错误症状安装时提示权限不足解决方案配置 npm 用户目录# 创建全局目录 mkdir ~/.npm-global # 配置 npm npm config set prefix ~/.npm-global # 添加到 PATH export PATH~/.npm-global/bin:$PATH echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc问题 4API 密钥无效症状对话时提示 API 错误解决方案检查 API 密钥是否正确确认 API 账户有余额重新配置clawdbot config set apiKey your_new_api_key问题 5WhatsApp 二维码过期症状扫描二维码时提示已过期解决方案# 重新生成二维码 clawdbot channels logout whatsapp clawdbot channels login whatsapp必须在 60 秒内完成扫描。
问题 6Docker 容器重启后数据丢失症状重启容器后记忆和配置丢失解决方案确保正确挂载数据卷volumes: - ~/.clawdbot:/root/.clawdbot # 确保路径正确检查目录权限ls -la ~/.clawdbot问题 7响应速度慢症状对话响应时间过长解决方案检查网络连接检查服务器资源CPU、内存切换到更快的 AI 模型clawdbot config set model claude-
-sonnet-20241022问题 8MCP 工具未显示症状添加 MCP 工具后无法使用解决方案# 验证配置 clawdbot mcp list # 重启服务 clawdbot restart # 检查日志 clawdbot logs最佳实践
安全建议✅保护 API 密钥不要将密钥提交到 Git 仓库✅定期更新保持 Clawdbot 和依赖项最新✅限制访问如果部署在服务器上配置防火墙规则✅备份数据定期备份~/.clawdbot目录
性能优化✅选择合适的模型Claude
5 Sonnet 平衡了速度和质量✅限制记忆大小避免记忆过大导致响应变慢✅使用本地缓存启用记忆功能减少重复查询
成本控制✅监控 API 使用定期检查 API 使用量✅设置预算警报在 Anthropic/OpenAI 控制台设置预算限制✅优化提示词避免过长的对话历史
日常使用技巧设置每日简报clawdbot schedule add 每天早上 8 点
总结我的日程和待办事项快速访问# 创建别名添加到 ~/.bashrc alias cbclawdbot chat # 使用 cb 今天天气如何批量操作# 批量添加 MCP 工具 clawdbot mcp add google-calendar gmail notion todoist
故障排查流程遇到问题时按以下顺序排查检查状态clawdbot status运行诊断clawdbot doctor查看日志clawdbot logs重启服务clawdbot restart重新配置clawdbot onboard
总结Clawdbot 是一个功能强大的自托管 AI 助手通过本教程您应该已经成功✅ 理解了 Clawdbot 的核心特性和优势 ✅ 完成了适合您操作系统的安装 ✅ 配置了 AI 提供商和 API 密钥 ✅ 连接了至少一个聊天平台WhatsApp/Telegram/Discord ✅ 了解了如何添加 MCP 工具集成 ✅ 掌握了
常见问题的解决方法下一步建议探索 MCP 工具根据需求添加更多集成日历、邮件、笔记等设置自动化配置定时任务和主动通知优化记忆调整记忆设置以适应您的使用习惯加入社区访问 GitHub 参与讨论官方资源官方网站clawd.bot完整文档docs.clawd.botGitHub 仓库github.com/clawdbot/clawdbot社区讨论GitHub Discussions成本参考软件成本免费MIT 开源API 成本$
/月取决于使用频率服务器成本$0本地运行或 $
/月云服务器祝您使用愉快如果遇到问题欢迎在评论区讨论。
参考资料本文参考了以下官方资源和社区教程Clawdbot Official DocumentationClawdbot GitHub RepositoryHow to Install Clawdbot on Windows, Mac, and LinuxClawdbot Complete Setup Guide关键词Clawdbot, AI 助手, 自托管, WhatsApp AI, Telegram Bot, Claude API, 开源 AI, 私人助手, MCP 工具, 安装教程