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)

claude code 教程

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

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

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

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

1. 执行安装脚本

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

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

2. 验证安装成功

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

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

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

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

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

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

2. 启动图形化配置向导

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

3. 填入API密钥并验证

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

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

1. 下载插件到本地

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

2. 获取插件路径

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

• 示例输出：(复制完整路径，包括)

3. Chrome加载本地插件

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

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

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

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

2. 测试网页自动操控

1. 保持网关运行，打开新的Chrome窗口，访问百度首页(https://www.baidu.com)；
2. 若Chrome自动在百度搜索框输入关键词并执行搜索，说明安装完成且功能正常！

新建一个终端窗口，输入以下指令：

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

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

2. Chrome插件加载失败

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

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

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

4. API配置失败「Connection timeout」

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

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