M系列Mac保姆级教程：Clawdbot安装+API配置，30分钟解锁AI自动化！

前言

Clawdbot作为超实用的AI自动化工具，能帮你实现网页自动操控、办公流程自动化、本地文件管理等功能，搭配M系列Mac的低功耗特性，堪称效率神器！
很多Mac用户安装时会遇到「架构不兼容」「API配置失败」「插件加载报错」等问题，这篇教程专为M4/M1-M3芯片MacBook定制，全程ARM原生适配，从环境准备到功能验证一步到位，新手也能轻松上手～

一、安装前准备(必看！避坑核心)

1. 系统与工具要求

系统版本：macOS 13 Ventura 及以上(M4芯片默认满足，低于该版本先升级：系统设置→通用→软件更新)
核心依赖：Node.js ≥ 22(必须ARM架构版，避免转译卡顿)
辅助工具：终端(Launchpad→其他→终端)、Chrome浏览器(ARM原生版)
网络：需访问外网(对接Claude/Gemini)或国内网络(对接DeepSeek)

2. 提前检查并安装Node.js

打开终端，输入以下命令检查Node版本：

Bash 复制代码

node -v

✅ 若显示v22.x.x且标注arm64：直接跳过下一步；
❌ 若版本低于22/无输出/显示 x64：按以下步骤安装ARM版Node.js：
- 访问Node.js官网，下载「macOS Arm64 Installer」；
- 双击安装包，按引导完成安装(默认路径即可)；
- 重启终端后再次执行node -v，确认版本达标。

二、第一步：安装Clawdbot核心程序(CLI)

Clawdbot官方提供M芯片适配的一键安装脚本，全程自动完成，无需手动适配：

1. 执行安装脚本

在终端输入以下命令(复制粘贴即可，避免手输错误)：

Bash 复制代码

curl -fsSL https://clawd.bot/install.sh | bash

执行后会提示输入「Mac管理员密码」(输入时终端无显示，输完按回车即可)，用于授权文件写入；
等待1-2分钟，脚本会自动下载ARM架构的Clawdbot核心文件，耐心等待进度完成。

2. 验证安装成功

输入以下命令，若显示版本号(如 clawdbot v1.8.2)，说明CLI安装成功：

Bash 复制代码

clawdbot --version

3. 初始化后台服务(适配M4低功耗)

执行「入职向导」，自动配置后台守护进程(不占用过多M4芯片资源)：

Bash 复制代码

clawdbot onboard --install-daemon

过程中会弹出「系统权限请求」(如"终端想要控制辅助功能")，必须点击「允许」，否则后续无法操控浏览器/文件；
若弹出「防火墙提醒」，同样选择「允许」，确保Clawdbot正常联网。

三、第二步：配置大模型API密钥(核心！Clawdbot需对接模型)

Clawdbot本身无"思考能力"，需对接大模型才能实现自动化，推荐3款适配M4芯片的模型，按需选择：

1. 模型选择与API密钥获取

|----------|------------|------------------------------------------|------|
| 模型 | 适用人群 | API密钥获取地址 | 配置难度 |
| Claude | 海外用户/有外网权限 | https://console.anthropic.com/ | ⭐⭐ |
| Gemini | 谷歌生态用户 | https://aistudio.google.com/app/apikey | ⭐⭐ |
| DeepSeek | 国内用户(无外网) | https://platform.deepseek.com/ | ⭐ |

2. 启动图形化配置向导

终端输入命令，进入可视化配置界面(M4芯片原生支持，无需额外设置)：

Bash 复制代码

clawdbot setup --wizard

3. 填入API密钥并验证

按向导提示选择你要使用的模型(如国内用户选DeepSeek)；
复制对应平台的API密钥(注意：密钥不要泄露给他人)，粘贴到终端输入框(粘贴后按回车)；
向导会自动测试连接，显示「Connection Success」即配置成功；
1. 若失败：检查API密钥是否正确(有无多余空格)、网络是否能访问模型服务器(国内用户用DeepSeek需确保无网络限制)。

四、第三步：安装浏览器插件(让Clawdbot操控网页)

Clawdbot需通过Chrome插件挂载网页，M4芯片需确保Chrome是ARM原生版：

1. 下载插件到本地

终端输入命令，自动下载插件文件并保存到Clawdbot目录：

Bash 复制代码

clawdbot browser extension install

2. 获取插件路径

执行命令，复制插件所在文件夹路径(后续加载插件需用到)：

Bash 复制代码

clawdbot browser extension path

示例输出：/Users/你的用户名/.clawdbot/browser-extension(复制完整路径，包括/Users/...)

3. Chrome加载本地插件

打开Chrome浏览器，在地址栏输入 chrome://extensions/，右上角开启「开发者模式」(开关按钮滑到右侧)；
点击左上角「加载已解压的扩展程序」，粘贴刚才复制的插件路径，选择文件夹后点击「确定」；
加载成功后，Chrome右上角会出现「红色太空龙虾」图标(Clawdbot标志)，点击图标显示「ON」即代表挂载成功。

五、第四步：验证安装(功能测试，确保能用)

1. 启动本地网关(终端与插件通信)

终端输入命令，启动本地网关(默认端口18789，M4芯片无需修改)：

Bash 复制代码

clawdbot gateway --bind lan --port 18789

终端显示「Gateway running on http://0.0.0.0:18789」即启动成功，不要关闭这个终端窗口。

2. 测试网页自动操控

保持网关运行，打开新的Chrome窗口，访问百度首页(https://www.baidu.com)；
新建一个终端窗口，输入以下指令：
Bash 复制代码
```
clawdbot browser search "Clawdbot M4芯片测试"
```
若Chrome自动在百度搜索框输入关键词并执行搜索，说明安装完成且功能正常！

六、M4芯片专属避坑指南(新手必看)

1. 安装脚本报错「Permission denied」

终端输入以下命令提升权限后，重新执行安装脚本：

Bash 复制代码

sudo curl -fsSL https://clawd.bot/install.sh | bash

2. Chrome插件加载失败

确认Chrome是「ARM原生版」：打开Chrome→关于Google Chrome→显示「Apple M系列」即正确；
若显示「Intel」：卸载Chrome，从官网下载「Mac with Apple chip」版本重新安装。

3. 网关启动失败「端口被占用」

修改端口号重新启动(如改用18790)：

Bash 复制代码

clawdbot gateway --bind lan --port 18790

4. API配置失败「Connection timeout」

国内用户：优先选择DeepSeek模型，无需外网；
有外网权限：检查代理设置，关闭代理后重新测试连接。

七、常用基础指令(安装后快速上手

|--------------|-------------------------------------------------------|
| 功能 | 终端指令 |
| 启动Clawdbot后台 | clawdbot daemon start |
| 停止后台服务 | clawdbot daemon stop |
| 查看插件状态 | clawdbot browser extension status |
| 重新配置API密钥 | clawdbot config set api_key 你的新密钥 |
| 测试网页截图 | clawdbot browser screenshot "https://www.baidu.com" |

结语

M系列Mac安装Clawdbot的核心是「ARM原生依赖+官方适配脚本」，按教程步骤操作，30分钟内就能解锁AI自动化办公！
安装完成后，Clawdbot可帮你自动处理网页数据采集、定时执行办公流程、批量操作文件等重复工作，搭配M4芯片的低功耗特性，长期运行也不耗电～
如果遇到其他问题，可参考 Clawdbot官方文档，或在评论区留言，我会第一时间帮你解答！