本文为 2026 年 4 月实测版,专为 Mac 用户打造,全程无夸大、无违规表述,新手按步骤操作即可完成本地部署。
OpenClaw(业内昵称 “小龙虾”)是轻量化本地 AI Agent 框架,支持一键部署、多渠道集成与 AI 内容生成。2026 最新版(v2026.3.2)对 Mac 系统深度优化,Intel 与 Apple Silicon(M1/M2/M3/M4)芯片通用,小白也能快速搭建本地 AI 服务。
2.1 系统与硬件要求
表格
2.2 工具准备
- 打开终端:快捷键
Command + 空格,搜索「终端」并打开 - 关闭防火墙 / 杀毒软件:避免拦截安装脚本
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 2026.3.2)即安装成功:
bash
运行
openclaw –version
4.1 启动初始化向导
执行命令,进入文字交互配置界面:
bash
运行
openclaw onboard
4.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 系统安全限制,需手动授权 OpenClaw 权限:
- 打开「系统设置」→「隐私与安全性」
- 依次开启以下权限:
- 辅助功能:开启 OpenClaw(用于键鼠模拟)
- 屏幕录制:开启 OpenClaw(用于视觉识别)
- 文件与文件夹:开启「完全磁盘访问权限」
- 重启终端与 OpenClaw 网关,权限生效
7.1 命令找不到(command not found)
执行以下命令配置环境变量:
bash
运行
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
7.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
本文覆盖 Mac 版 OpenClaw一键安装、初始化配置、权限设置、常见问题全流程,2026 最新版流程极简,小白 10 分钟内可完成部署。后续可扩展:
- 配置本地 / 云端 AI 模型(如豆包、GPT)
- 集成飞书 / 微信 / 钉钉等聊天渠道
- 安装 AI 漫剧 / 短剧 / 文案生成插件
最后再次附上官方部署包下载地址,方便大家自取:OpenClaw Windows 11 一键部署包 v2.3.12
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/263531.html