本文为 2026 年实测版，专为 Mac 用户打造，全程无夸大、无违规表述，新手按步骤操作即可完成本地部署。
一、OpenClaw 简介
OpenClaw（业内昵称 “小龙虾”）是轻量化本地 AI Agent 框架，支持一键部署、多渠道集成与 AI 内容生成。2026 最新版（v2.6.6）对 Mac 系统深度优化，Intel 与 Apple Silicon（M1/M2/M3/M4）芯片通用，小白也能快速搭建本地 AI 服务。
二、部署前准备（必看）
2.1 系统与硬件要求
表格
| 项目 | 最低配置 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 12.0+（Monterey 及以上） | macOS 14+（Sonoma） |
| 处理器 | Intel/Apple Silicon（M1/M2/M3/M4） | 同左 |
| 内存 | ≥4GB | 8GB+，运行更流畅 |
| 存储 | 可用空间≥2GB | 10GB+，预留模型空间 |
| 网络 | 稳定联网 | 带宽≥10Mbps，加速依赖下载 |
| 权限 | 需 Mac 管理员密码 | 同左 |
2.2 工具准备
打开终端：快捷键Command + 空格，搜索「终端」并打开关闭防火墙 / 杀毒软件：避免拦截安装脚本
三、一键部署（新手首选，5 分钟搞定）
3.1 执行官方安装脚本
复制以下命令，粘贴到终端并回车，输入 Mac 管理员密码（输入不显示字符，直接回车）：
bash
运行
# 官方原版（推荐，网络好时使用） curl -fsSL https://openclaw.ai/install.sh | bash # 国内加速版（网络慢/下载失败时使用） # curl -fsSL https://open-claw.org.cn/install-cn.sh | bash脚本自动完成：系统检测、Node.js ≥v22 安装、OpenClaw 核心程序部署、环境变量配置
3.2 加载环境变量（必做）
Mac 默认 Zsh 终端，执行以下命令使配置生效：
bash
运行
source ~/.zshrc若为老版 Bash 终端，执行：source ~/.bash_profile
3.3 验证安装成功
输入以下命令，输出版本号（如OpenClaw 2.6.6）即安装成功：
bash
运行
openclaw --version四、初始化配置（3 分钟完成）
4.1 启动初始化向导
执行命令，进入文字交互配置界面：
bash
运行
openclaw onboard4.2 按提示配置（新手直接默认回车）
Security warning：输入Yes并回车（个人使用默认安全）Onboarding mode：选择QuickStart（快速启动）Gateway port：默认18789，直接回车Model/auth provider：新手选Skip for now，后续再配置模型设置管理员密码：输入并确认密码（务必记录，登录控制台使用）
五、启动服务与访问控制台
5.1 启动网关服务（保持终端运行）
bash
运行
openclaw gateway终端显示「Gateway started on port 18789」即启动成功
5.2 访问 Web 控制台
浏览器自动跳转至http://localhost:18789，输入管理员密码即可登录使用
六、Mac 专属权限配置（必做，否则功能受限）
Mac 系统安全限制，需手动授权 OpenClaw 权限：打开「系统设置」→「隐私与安全性」依次开启以下权限：辅助功能：开启 OpenClaw（用于键鼠模拟）屏幕录制：开启 OpenClaw（用于视觉识别）文件与文件夹：开启「完全磁盘访问权限」重启终端与 OpenClaw 网关，权限生效
七、常见问题解决
7.1 命令找不到（command not found）
执行以下命令配置环境变量：
bash
运行
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc7.2 安装超时 / 下载失败
切换国内加速脚本：curl -fsSL https://open-claw.org.cn/install-cn.sh | bash检查网络，或切换手机热点重试
7.3 端口占用（18789）
执行命令查看占用程序：
bash
运行
lsof -i :18789关闭占用程序，或启动时换端口：openclaw gateway --port 18790
7.4 权限不足
所有命令前加sudo，如：sudo openclaw gateway
7.5 文件类型不支持报错
若下载时提示 “当前不支持该文件类型，请尝试其他文件”，可更换下载渠道或重新发起下载请求。
八、总结与后续
本文覆盖 Mac 版 OpenClaw 一键安装、初始化配置、权限设置、常见问题全流程，2026 最新版流程极简，小白 10 分钟内可完成部署。后续可扩展：配置本地 / 云端 AI 模型（如豆包、GPT）集成飞书 / 微信 / 钉钉等聊天渠道安装 AI 漫剧 / 短剧 / 文案生成插件
