本文将从 macOS 用户视角，完整讲解如何在本地部署并使用 Clawdbot， 覆盖环境准备、Docker 安装、配置说明以及 AI 对接与使用建议。
相比 Windows，Mac 是 Clawdbot 最友好的平台之一，几乎无需额外系统适配。
一、Mac 部署 Clawdbot 的整体思路
在 macos 下，clawdbot 的运行方式非常直接：
- macOS 作为宿主系统
- Docker Desktop 提供运行环境
- Clawdbot 以 Linux 容器形式运行
无论是 Intel 芯片还是 Apple Silicon（M1 / M2 / M3）， Clawdbot 都可以正常运行。
Mac 用户不需要 WSL、不需要虚拟机配置，这是最大优势。
二、Mac 安装前的系统与环境要求
1️⃣ 系统要求
| 项目 | 要求 |
|---|---|
| macOS 版本 | macOS 12 及以上 |
| 芯片 | Intel / Apple Silicon 均可 |
| 内存 | 8GB 起步，推荐 16GB+ |
2️⃣ 必备软件
- Docker Desktop for Mac
- Git
- 终端工具（系统自带 Terminal 即可）
三、Step 1：安装 Docker Desktop（核心依赖）
前往 Docker 官网下载安装 Docker Desktop for Mac， 安装时注意选择与你芯片架构对应的版本。
安装完成后，在终端执行：
docker --version
能正常输出版本号，说明 Docker 环境可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
四、Step 2：获取 Clawdbot 源码
在终端中执行：
git clone https://github.com/clawdbot/clawdbot.git cd clawdbot
如果 GitHub 网络不稳定，也可以手动下载 ZIP 解压使用。
五、Step 3：配置 Clawdbot 环境变量
1️⃣ 生成配置文件
cp .env.example .env
2️⃣ 关键配置项说明
| 配置项 | 说明 |
|---|---|
| CLAWS_BOT_NAME | 自定义 AI 名称 |
| CLAWS_SERVER_PORT | 服务端口（默认 8080） |
| CLAWS_DEFAULT_MODEL | 默认 AI 模型 |
| CLAWS_DATA_DIR | 数据存储路径（绝对路径） |
建议将数据目录设置在用户目录下，例如：
/Users/yourname/clawdbot/data
六、Step 4：启动 Clawdbot 服务
docker-compose up -d --build
第一次启动会拉取镜像并构建服务， 通常需要 5～10 分钟。
七、Step 5：访问与验证服务状态
docker ps
docker logs clawdbot
浏览器访问：
http://localhost:8080
若可以看到 Clawdbot 管理界面， 说明核心服务已成功运行。
八、Step 6：对接 Telegram（推荐使用方式）
1️⃣ 创建 Telegram Bot
- 搜索
@BotFather - 发送
/newbot - 获取 Bot Token
2️⃣ 配置并重启服务
TELEGRAM_BOT_TOKEN=你的Token
docker-compose restart
3️⃣ 验证聊天功能
在 Telegram 中向机器人发送 /start，
再发送简单指令进行测试。
九、Mac 使用 Clawdbot 的实践建议
- 避免在主力办公电脑长期开启高权限任务
- 重要数据目录定期备份
- 模型输出设置合理的 Token 上限
- 优先使用国产模型以降低成本
十、总结
在 macOS 上部署 Clawdbot 的流程非常清晰， 本质就是：
- 安装 Docker
- 拉取源码
- 配置环境变量
- 启动服务并对接 AI
对 Mac 用户来说，Clawdbot 是目前体验最接近“即插即用”的本地 AI Agent 方案。
