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版本：
node -v- ✅ 若显示
v22.x.x且标注arm64：直接跳过下一步； - ❌ 若版本低于22/无输出/显示
x64：按以下步骤安装ARM版Node.js：- 访问Node.js官网，下载「macOS Arm64 Installer」；
- 双击安装包，按引导完成安装(默认路径即可)；
- 重启终端后再次执行
node -v，确认版本达标。
二、第一步：安装Clawdbot核心程序(CLI)
Clawdbot官方提供M芯片适配的一键安装脚本，全程自动完成，无需手动适配：
1. 执行安装脚本
在终端输入以下命令(复制粘贴即可，避免手输错误)：
curl -fsSL https://clawd.bot/install.sh | bash- 执行后会提示输入「Mac管理员密码」(输入时终端无显示，输完按回车即可)，用于授权文件写入；
- 等待1-2分钟，脚本会自动下载ARM架构的Clawdbot核心文件，耐心等待进度完成。
2. 验证安装成功
输入以下命令，若显示版本号(如 clawdbot v1.8.2)，说明CLI安装成功：
clawdbot --version3. 初始化后台服务(适配M4低功耗)
执行「入职向导」，自动配置后台守护进程(不占用过多M4芯片资源)：
clawdbot onboard --install-daemon- 过程中会弹出「系统权限请求」(如“终端想要控制辅助功能”)，必须点击「允许」，否则后续无法操控浏览器/文件；
- 若弹出「防火墙提醒」，同样选择「允许」，确保Clawdbot正常联网。
三、第二步：配置大模型API密钥(核心！Clawdbot需对接模型)
Clawdbot本身无“思考能力”，需对接大模型才能实现自动化，推荐3款适配M4芯片的模型，按需选择：
1. 模型选择与API密钥获取
模型 | 适用人群 | API密钥获取地址 | 配置难度 |
Claude | 海外用户/有外网权限 | ⭐⭐ | |
Gemini | 谷歌生态用户 | ⭐⭐ | |
DeepSeek | 国内用户(无外网) | ⭐ |
2. 启动图形化配置向导
终端输入命令，进入可视化配置界面(M4芯片原生支持，无需额外设置)：
clawdbot setup --wizard3. 填入API密钥并验证
- 按向导提示选择你要使用的模型(如国内用户选DeepSeek)；
- 复制对应平台的API密钥(注意：密钥不要泄露给他人)，粘贴到终端输入框(粘贴后按回车)；
- 向导会自动测试连接，显示「Connection Success」即配置成功；
- 若失败：检查API密钥是否正确(有无多余空格)、网络是否能访问模型服务器(国内用户用DeepSeek需确保无网络限制)。
四、第三步：安装浏览器插件(让Clawdbot操控网页)
Clawdbot需通过Chrome插件挂载网页，M4芯片需确保Chrome是ARM原生版：
1. 下载插件到本地
终端输入命令，自动下载插件文件并保存到Clawdbot目录：
clawdbot browser extension install2. 获取插件路径
执行命令，复制插件所在文件夹路径(后续加载插件需用到)：
clawdbot browser extension path- 示例输出：
/Users/你的用户名/.clawdbot/browser-extension(复制完整路径，包括/Users/...)
3. Chrome加载本地插件
- 打开Chrome浏览器，在地址栏输入
chrome://extensions/，右上角开启「开发者模式」(开关按钮滑到右侧)； - 点击左上角「加载已解压的扩展程序」，粘贴刚才复制的插件路径，选择文件夹后点击「确定」；
- 加载成功后，Chrome右上角会出现「红色太空龙虾」图标(Clawdbot标志)，点击图标显示「ON」即代表挂载成功。
五、第四步：验证安装(功能测试，确保能用)
1. 启动本地网关(终端与插件通信)
终端输入命令，启动本地网关(默认端口18789，M4芯片无需修改)：
clawdbot gateway --bind lan --port 18789- 终端显示「Gateway running on http://0.0.0.0:18789」即启动成功，不要关闭这个终端窗口。
2. 测试网页自动操控
- 保持网关运行，打开新的Chrome窗口，访问百度首页(https://www.baidu.com)；
- 若Chrome自动在百度搜索框输入关键词并执行搜索，说明安装完成且功能正常！
新建一个终端窗口，输入以下指令：
clawdbot browser search "Clawdbot M4芯片测试"六、M4芯片专属避坑指南(新手必看)
1. 安装脚本报错「Permission denied」
终端输入以下命令提升权限后，重新执行安装脚本：
sudo curl -fsSL https://clawd.bot/install.sh | bash2. Chrome插件加载失败
- 确认Chrome是「ARM原生版」：打开Chrome→关于Google Chrome→显示「Apple M系列」即正确；
- 若显示「Intel」：卸载Chrome，从官网下载「Mac with Apple chip」版本重新安装。
3. 网关启动失败「端口被占用」
修改端口号重新启动(如改用18790)：
clawdbot gateway --bind lan --port 187904. 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官方文档，或在评论区留言，我会第一时间帮你解答！
