本文为 2026 年实测版专为 Mac 用户打造全程无夸大、无违规表述新手按步骤操作即可完成本地部署。一、OpenClaw 简介OpenClaw业内昵称 “小龙虾”是轻量化本地 AI Agent 框架支持一键部署、多渠道集成与 AI 内容生成。2026 最新版v2.6.6对 Mac 系统深度优化Intel 与 Apple SiliconM1/M2/M3/M4芯片通用小白也能快速搭建本地 AI 服务。二、部署前准备必看2.1 系统与硬件要求表格项目最低配置推荐配置操作系统macOS 12.0Monterey 及以上macOS 14Sonoma处理器Intel/Apple SiliconM1/M2/M3/M4同左内存≥4GB8GB运行更流畅存储可用空间≥2GB10GB预留模型空间网络稳定联网带宽≥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_profile3.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 187907.4 权限不足所有命令前加sudo如sudo openclaw gateway7.5 文件类型不支持报错若下载时提示 “当前不支持该文件类型请尝试其他文件”可更换下载渠道或重新发起下载请求。八、总结与后续本文覆盖 Mac 版 OpenClaw 一键安装、初始化配置、权限设置、常见问题全流程2026 最新版流程极简小白 10 分钟内可完成部署。后续可扩展配置本地 / 云端 AI 模型如豆包、GPT集成飞书 / 微信 / 钉钉等聊天渠道安装 AI 漫剧 / 短剧 / 文案生成插件OpenClaw 一键部署包下载https://xiake.yun/api/download/package/6?promoCodeIVABFE0590F8