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 –version

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

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

clawdbot onboard –install-daemon

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

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

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

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

2. 启动图形化配置向导

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

clawdbot setup –wizard

3. 填入API密钥并验证

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

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

1. 下载插件到本地

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

clawdbot browser extension install

2. 获取插件路径

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

clawdbot browser extension path

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

3. Chrome加载本地插件

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

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

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

clawdbot gateway –bind lan –port 18789

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

2. 测试网页自动操控

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

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

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

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)：

clawdbot gateway –bind lan –port 18790

4. API配置失败「Connection timeout」

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

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

结语

M系列Mac安装Clawdbot的核心是「ARM原生依赖+官方适配脚本」，按教程步骤操作，30分钟内就能解锁AI自动化办公！

安装完成后，Clawdbot可帮你自动处理网页数据采集、定时执行办公流程、批量操作文件等重复工作，搭配M4芯片的低功耗特性，长期运行也不耗电～

如果遇到其他问题，可参考
Clawdbot官方文档，或在评论区留言，我会第一时间帮你解答！