Clawdbot 是一款开源、自托管的个人 AI 助手，可以运行在你自己的电脑（例如 Mac mini）上，并连接到你常用的聊天平台如 WhatsApp、Telegram、Discord 等。它不仅能对话，还能执行任务、主动提醒、管理文件和自动化工作流程——可以理解为“你自己的私人 AI 员工”。
Clawdbot 是什么？理解核心
Clawdbot 是：
🛠️ 自托管的 AI 助手：运行在自己的机器上，不依赖云端服务。
📱 跨通讯平台：可以让 AI 出现在 Whatsapp、Telegram、Discord、Slack、Signal、iMessage 等聊天程序里。
🤖 具备实际操作能力：不仅回答问题，还可以执行系统命令、浏览器操控、自动化任务等。
🧠 保持上下文记忆：可持续记住对话和用户偏好，从而更加智能。
所以，Clawdbot 不只是聊天机器人，它是新一代的“个人 AI 助手/智能体”。
准备你的Mac mini
在开始部署之前，确保你的 Mac mini 满足以下基本要求：
✔ macOS 系统（最新版更稳定）
✔ 已安装 Node.js（>=22） 和 pnpm 或 npm（Clawdbot 依赖）
也可以使用 Homebrew 安装：
brew install node
brew install pnpm
在 Mac mini 上安装 Clawdbot
1) 使用一行命令快速安装
在终端执行：
curl -fsSL https://clawd.bot/install.sh | bash这个脚本会安装 Clawdbot 所需的依赖并设置环境。
2) 启动 Clawdbot
安装完成后，你可以运行 Clawdbot 的命令行界面：
clawdbot建议首先运行引导式设置（推荐）：
clawdbot onboard这个引导会帮你自动配置：
选择模型、授权方式
设置消息渠道（如 Telegram/WhatsApp）
初始化工作空间和技能
如果你不想使用 CLI 引导，可以手动运行：
clawdbot setup
clawdbot gateway启动本地 Gateway 后，Clawdbot 的本地控制面板通常会在浏览器打开：
http://127.0.0.1:18789接入 AI 模型（使用 Claude via 神马中转 API）
默认 Clawdbot 并不自带 AI 模型，它需要调用外部 LLM 提供者。我们用 Claude Code + 神马中转 API 做接力。
🎯为什么要这样做？
直连 Anthropic 官方 API 有时受限网络或额度影响。
使用神马中转 API可以统一代理请求，更稳定使用模型。
Claude Code 本身支持通过 ANTHROPIC_BASE_URL 指向中转 API。
1) 安装 Claude Code
在 Mac mini 上运行：
npm install -g @anthropic-ai/claude-code2) 配置神马中转 API
在终端设置两个环境变量：
export ANTHROPIC_AUTH_TOKEN="sk-你的神马中转 Token"
export ANTHROPIC_BASE_URL="https://api.whatai.cc"解释：
ANTHROPIC_AUTH_TOKEN：你的神马 API 密钥
ANTHROPIC_BASE_URL：神马中转的 Base URL（代替官方 Anthropic 接口）
3) 验证 Claude Code 是否可用
运行简单命令测试：
claude "Hello, this is a test"如果返回了正常的回应，就说明已经正确配置成功。
在 Clawdbot 中指定使用 Claude 模型
Clawdbot 支持通过 CLI 管理模型：
clawdbot models list
clawdbot models set anthropic/claude-opus-4-5然后就可以让 Clawdbot 把 Claude（通过神马中转 API 调用）作为主模型来处理智能对话和执行任务。
常见使用场景
✅ 在 WhatsApp 里发送消息让 Clawdbot 帮你安排日程
✅ 在 Telegram 上让它检索邮箱并生成总结
✅ 通过 Discord 让 Clawdbot 执行脚本或代码
✅ 自动清理收件箱或安排会议提醒
…这些都可以从 Clawdbot 本地运行并由 Claude 提供智能能力完成。
常见问题与排查建议
👉 如果 Clawdbot 卡在“Gateway 启动失败”，检查端口是否被占用，或尝试重启 Gateway。
👉 如果 Claude 返回错误（Network / 429），确认神马中转 API Token 和环境变量是否正确。
👉 如果某个消息渠道未连接（如 Telegram），重新运行：
clawdbot channels login通过以上步骤，你已经实现：
✅ 在 Mac mini 上部署了 Clawdbot
✅ 配置了 Claude Code 并通过神马中转 API 调用模型
✅ 让 Clawdbot 成为一个能在 Telegram/WhatsApp 上自动执行任务的私人 AI 助手
这套组合不仅提升了 AI 助手的实用性，还充分保障了你数据的隐私和控制权。
