Clawdbot安装教程：在Mac mini上部署AI Agent并接入Claude Code

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-code

2) 配置神马中转 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 助手的实用性，还充分保障了你数据的隐私和控制权。