一、前置准备

1. 确认系统环境

• 确保macOS版本为Sonoma或更新（推荐使用Apple Silicon M1及以上芯片，性能更佳）

• 确认Mac配置：M1芯片、16寸、32GB内存、1TB存储（您的配置完全满足要求）

2. 安装Node.js（关键步骤！）

步骤：

1. 访问Node.js官网下载LTS版本（推荐给大多数用户的版本）
• 选择"Download" → "LTS (Long Term Support)" → "macOS ARM64 Installer"
• 这是必须选择的安装包，因为您的Mac是M1芯片（ARM架构）

2. 安装Node.js
• 双击下载的.pkg文件，按照向导完成安装
• 系统会自动安装ARM64版本的Node.js

3. 验证Node.js架构
• 正确输出：arm64
• 错误输出：x64（表示安装了错误架构的Node.js，需要重新安装）

4. 验证Node.js版本
• 确保版本为v16.0.0或更高（推荐v22.0.0+）

📌 重要提示：如果您已经安装了Node.js但架构是x64（Intel版本），必须卸载并重新安装ARM64版本。否则OpenClaw无法正常运行。

二、安装OpenClaw

1. 设置国内镜像源（推荐，加快安装速度）

2. 安装OpenClaw

• 系统会提示输入密码（输入时屏幕不显示字符，输入完成后按回车）

• 安装过程需要1-3分钟，耐心等待

3. 验证安装

• 正确输出示例：2026.2.6-3（版本号可能不同，但应显示版本号）

三、运行Onboard向导（配置核心步骤）

详细配置步骤：

1. 安全警告确认

• 向导会显示安全警告，提醒OpenClaw可以读取文件和执行操作

• 选择Yes确认

2. 选择Onboarding模式

• 选择QuickStart（最简单配置方式）

3. 配置模型认证（关键步骤！）

• 选择Model/auth provider → 选择您要使用的AI服务提供商
• 推荐：如果您使用DeepSeek，选择OpenAI（DeepSeek兼容OpenAI API协议）
• 如果您有API Key，选择对应的提供商

• 配置示例（DeepSeek）：

📌 重要提示：如果您使用MiniMax，选择MiniMax，然后选择MiniMax M2.1，不要选择OAuth。

4. 配置聊天渠道（可跳过，后续添加）

• 选择Skip for now（可以先跳过，后续通过openclaw channels add添加）

5. 配置Skills（可跳过，后续添加）

• 选择No（可以先跳过，后续通过UI界面配置）

6. 安装Gateway服务

• 向导会自动安装macOS LaunchAgent服务

• 确认输出：Installed LaunchAgent: ~/Library/LaunchAgents/ai.openclaw.gateway.plist

7. 配置Shell补全（推荐）

• 选择Yes启用命令补全

• 然后重新加载配置：

四、启动Gateway服务

验证Gateway状态：

• 成功状态应显示：

📌 重要提示：如果显示Gateway: status=stopped，请运行openclaw gateway start。

五、访问OpenClaw控制面板

1. 获取带Token的URL

• 该命令会输出一个完整的URL，例如：

2. 在浏览器中打开

• 将上述URL复制到浏览器地址栏中打开

• 不要直接访问http://127.0.0.1:18789，这会显示无权限错误

📌 重要提示：Token首次加载后会保存在浏览器的localStorage中，之后访问无需重复输入。

六、特别注意事项（M1 Mac专属）

1. Node.js架构问题（最容易出错）

• M1 Mac必须使用ARM64版本的Node.js

• 错误配置：安装x64版本的Node.js → OpenClaw安装失败或运行异常

• 如何检查：
• 正确输出：Mach-O 64-bit executable arm64
• 错误输出：Mach-O 64-bit executable x86_64

2. Mac本地监听问题

• 默认情况下，OpenClaw只监听127.0.0.1（本地回环地址）

• 如果您需要从其他设备访问，需修改绑定地址：

• 验证是否成功：openclaw gateway status应显示Listening: *:18789

3. 飞书/企业微信等国内渠道配置

• 如果您需要接入飞书或企业微信，参考以下步骤：
1. 安装飞书插件：
2. 配置飞书：
• 按照提示完成配置（需要飞书App ID和App Secret）

4. 常见问题解决

问题：访问控制面板时提示"没有带Token认证"

• 解决方案：使用openclaw dashboard --no-open获取带Token的URL

问题：Gateway服务没有启动

• 解决方案：

问题：安装过程中出现权限错误

• 解决方案：使用sudo命令，但确保输入正确的管理员密码

七、安装后常用命令

八、总结

1. 确保Node.js是ARM64版本（M1 Mac的关键）

2. 使用openclaw onboard --install-daemon完成配置

3. 访问控制面板必须使用带Token的URL

4. 如需接入国内渠道（飞书/企业微信），需单独安装插件并配置