【第二篇】OpenClaw安装部署Mac操作系统版 - 打造你的专属AI助理摘要Mac系统是OpenClaw的最佳部署平台之一。本文详细介绍在macOS上安装部署OpenClaw的完整流程包括环境准备、多种安装方式、权限配置等内容让Mac用户轻松搭建AI智能体平台。前言为什么Mac是最佳选择Mac系统在OpenClaw部署上有天然优势优势一完美的Unix环境macOS基于Unix兼容性极佳命令行工具丰富与Linux生态高度兼容优势二原生AppleScript支持可直接控制iMessage、Notes等系统应用深度集成macOS原生功能支持屏幕录制、系统录音等权限优势三优秀的桌面环境图形界面友好文件权限管理清晰开发者工具完善适用场景喜欢在Mac上工作的开发者需要使用iMessage集成的用户希望深度定制AI助理的个人用户一、部署前的准备工作1.1 系统要求检查最低配置要求macOS 10.15 (Catalina) 或更高版本Intel芯片或Apple Silicon (M1/M2/M3)内存4GB以上推荐8GB磁盘空间至少2GB可用空间网络稳定的互联网连接运行时要求Node.js 22或更高版本强制要求Xcode Command Line Toolsnpm或pnpm包管理器1.2 检查系统版本打开终端应用输入sw_vers期望输出示例ProductName: macOS ProductVersion: 15.2 BuildVersion: 24C101确认版本 10.15。1.3 检查Node.js版本node--version期望输出v22.x.x如果版本不符合要求低于22需要升级提示command not found需要安装1.4 安装Xcode Command Line Tools即使不开发OpenClaw也需要这些工具xcode-select--install系统会弹出安装窗口点击安装按钮等待完成。验证安装xcode-select-p期望输出路径例如/Library/Developer/CommandLineTools二、Node.js环境配置2.1 安装Node.js方法一使用Homebrew推荐如果你已经安装了Homebrew# 安装Node.jsbrewinstallnode# 如果已安装但版本低升级brew upgradenode方法二官网安装包下载访问https://nodejs.org下载LTS版本长期支持版双击.pkg安装包按向导完成安装方法三使用nvm推荐给开发者# 安装nvm如果未安装curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh|bash# 重新加载shell配置source~/.zshrc# 或 ~/.bash_profile# 安装Node.js 22nvminstall22# 设置为默认版本nvm use22nvmaliasdefault222.2 验证Node.js安装node--versionnpm--version两个命令都应该返回版本号。常见问题命令找不到如果提示command not found可能需要重启终端打开新的终端窗口检查PATHecho$PATH确认npm全局路径在PATH中通常是/usr/local/bin或/opt/homebrew/bin手动添加PATH如果需要# Intel MacexportPATH/usr/local/bin:$PATH# Apple Silicon MacexportPATH/opt/homebrew/bin:$PATH三、OpenClaw安装方式OpenClaw提供了多种安装方式选择最适合你的即可。3.1 方法一一键安装脚本推荐这是最简单快速的方式curl-fsSLhttps://openclaw.ai/install.sh|bash脚本会自动完成检测系统环境安装Node.js如果缺失安装OpenClaw全局包配置初始设置安装时间通常30秒到2分钟3.2 方法二npm全局安装如果你已经配置好Node.js环境npminstall-gopenclawlatest验证安装openclaw--version期望看到版本号例如2026.3.73.3 方法三Git源码安装开发者适合需要自定义修改的开发者# 克隆仓库gitclone https://github.com/openclaw/openclaw.gitcdopenclaw# 安装依赖pnpminstall# 构建pnpmbuild# 链接到全局pnpmlink3.4 验证安装成功无论使用哪种方法最后都要验证# 查看版本openclaw--version# 运行诊断openclaw doctor如果openclaw doctor没有报错说明安装成功四、初始化配置4.1 运行初始化向导openclaw onboard --install-daemon这个命令会启动交互式向导引导你完成配置。4.2 向导步骤详解步骤1风险确认? I understand this is powerful and inherently risky. Continue? (Y/n)输入Y继续。OpenClaw是一个强大的工具需要谨慎使用。步骤2选择模式? Onboarding mode: ❯ QuickStart - Minimal setup, get running fast Manual - Full control over all settingsQuickStart推荐新手自动配置推荐设置Manual适合有经验的用户完全自定义配置建议第一次选择QuickStart后续可以随时修改配置。步骤3选择模型提供商? Which model provider would you like to use? ❯ KIMI MiniMax GLM OpenAI Anthropic Other (custom endpoint)国内用户推荐KIMI性价比高中文理解好MiniMax多模型支持GLM智谱AI出品国际用户推荐AnthropicClaude系列质量顶尖OpenAIGPT系列功能全面步骤4选择鉴权方式选择模型后会提示鉴权方式? KIMI auth method: ❯ Coding Plan / OAuth API Key国内用户建议选择 “Coding Plan” 对应项步骤5输入API Key? Enter your KIMI API Key: [在此处粘贴你的Key]注意终端不会显示任何字符出于安全考虑直接粘贴后按回车即可。步骤6选择模型? Select model: ❯ kimi-k2.5 kimi-k2.5-lite kimi-k2.5-pro选择你订阅的模型版本。步骤7配置Channel建议先Skip? Select channel (QuickStart): ❯ Skip for now (You can add channels later via openclaw channels add) WhatsApp Telegram ...建议首次选择 “Skip for now”先确保基础环境正常再添加消息渠道。步骤8配置Skills? Configure skills now? (recommended) ❯ Yes No建议选择 Yes现在就把能装的依赖装掉减少后续问题。步骤9配置Hooks? Enable hooks? ❯ Skip for now hook列表建议首次选择 “Skip for now”先跑通主线。步骤10选择Hatch方式? How do you want to hatch your bot? ❯ Hatch in TUI (recommended) Open Web UI Do this later建议选择 “Hatch in TUI”在终端中直接对话。4.3 初始化完成向导完成后你会看到类似输出✓ Configuration complete ✓ Gateway is running ✓ You can now start using OpenClaw! Dashboard URL: http://127.0.0.1:18789/ Gateway Status: Running五、首次对话测试5.1 完成Bootstrap向导完成后建议先完成Bootstrap初始化对话告诉AI你的基本信息。示例对话你好我是你的主人。 关于我 - 称呼China龙 - 地点中国北京UTC8 - 语言中文 - 职业自由职业者 我希望你扮演 - 角色全能助理 - 职责帮助我管理文档、搜索资料、整理任务 我的工作环境 - 工作目录~/Documents/projects - 常用工具VS Code、Notion - 沟通方式通过Terminal对话 我的偏好 - 回答风格先给结论再展开细节 - 回答长度中等不要太简短也不要太冗长 - 执行操作前必须向我确认特别是删除、修改文件 安全边界 - 绝不主动执行删除操作 - 未经允许不发送网络请求 - 不访问我的私人照片、视频等文件5.2 发送测试消息测试1简单任务请给我一个今天就能执行的3条待办清单每条不超过50字并按优先级排序。测试2信息查询请告诉我北京今天的天气并给出穿衣建议。测试3文件操作请查看当前目录有哪些文件并总结文件类型。如果AI能正常回复并执行任务恭喜你配置成功六、安装守护进程6.1 什么是守护进程守护进程Daemon让OpenClaw在后台持续运行即使关闭终端也不会中断。优点开机自启后台运行不占用终端崩溃自动重启6.2 macOS上的守护进程macOS使用launchd管理守护进程。如果你在初始化向导中使用了--install-daemon参数守护进程已经自动安装。检查守护进程状态openclaw gateway status手动启动/停止守护进程# 启动openclaw gateway start# 停止openclaw gateway stop# 重启openclaw gateway restart6.3 查看守护进程日志tail-f~/.openclaw/logs/gateway.log或使用OpenClaw命令openclaw logs--follow6.4 开机自启配置macOS的守护进程默认会开机自启。检查是否启用launchctl list|grepopenclaw如果看到输出说明已启用。手动禁用/启用# 禁用launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist# 启用launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist七、配置Web UI7.1 什么是Web UIWeb UI是OpenClaw的图形化控制界面可以在浏览器中使用。优势图形化界面更友好支持文件拖拽可视化管理配置7.2 打开Web UI方法一命令行openclaw dashboard浏览器会自动打开http://127.0.0.1:18789/或者http://locahost:18789/方法二直接访问在浏览器中输入http://127.0.0.1:18789/ 或者 http://locahost:18789/7.3 Web UI功能对话界面与AI聊天文件管理查看、上传、下载文件配置管理修改配置文件日志查看实时查看运行日志Cron任务管理定时任务Skills管理安装、更新插件7.4 配置Web UI认证默认情况下Web UI不需要密码。为了安全建议设置认证openclaw configsetgateway.controlUi.auth.enabledtrueopenclaw configsetgateway.controlUi.auth.username你的用户名openclaw configsetgateway.controlUi.auth.password你的密码# 重启网关使配置生效openclaw gateway restart八、权限配置重要8.1 为Terminal添加权限OpenClaw需要某些系统权限才能完全功能完全磁盘访问权限打开系统设置 → “隐私与安全性”找到完全磁盘访问点击“号添加终端”Terminal或者添加你的终端应用如 iTerm2屏幕录制权限在隐私与安全性中找到屏幕录制添加终端应用重启终端系统录音权限在隐私与安全性中找到麦克风添加终端应用8.2 验证权限# 测试屏幕截图openclaw browser screenshot--test# 测试录音openclaw browser audio--test如果没有报错说明权限配置正确。8.3 权限问题排查问题提示权限不足解决方案检查Terminal是否在权限列表中如果已添加但仍有问题尝试重启Terminal重启Mac先删除Terminal再重新添加九、常见问题排查9.1 问题命令找不到症状openclaw --version提示command not found原因npm全局路径未加入PATH解决方案检查npm全局路径npmprefix-g临时添加PATH# Intel MacexportPATH/usr/local/bin:$PATH# Apple Silicon MacexportPATH/opt/homebrew/bin:$PATH永久添加PATH编辑~/.zshrc或~/.bash_profile# Intel Macechoexport PATH/usr/local/bin:$PATH~/.zshrc# Apple Silicon Macechoexport PATH/opt/homebrew/bin:$PATH~/.zshrc# 重新加载配置source~/.zshrc9.2 问题端口18789被占用症状启动Gateway时提示端口被占用排查lsof-i:18789解决方案1更改端口openclaw configsetgateway.port18790openclaw gateway start解决方案2结束占用进程# 查看占用进程的PIDlsof-i:18789# 结束进程替换PIDkillPID# 如果无法结束强制结束kill-9PID9.3 问题Gateway启动失败症状openclaw gateway start后立即退出排查步骤查看日志openclaw logs--follow运行诊断openclaw doctor检查配置openclaw config get常见原因端口被占用权限不足配置文件错误API Key无效9.4 问题Web UI无法访问症状浏览器访问 http://127.0.0.1:18789/ 打不开排查确认Gateway运行状态openclaw gateway status检查端口监听lsof-i:18789查看防火墙设置打开系统设置 → “网络” → “防火墙”确保未阻止本地连接9.5 问题守护进程无法启动症状openclaw gateway start提示失败解决方案重新安装守护进程openclaw gateway uninstall openclaw gatewayinstall手动启动测试openclaw gateway--verbose检查launchd错误launchctl print system/com.openclaw.gateway十、API Key配置必做OpenClaw需要AI模型才能工作选择以下任一方案10.1 KIMI Coding Plan推荐申请步骤访问https://www.kimi.com/code登录/注册KIMI账号点击订阅Coding Plan选择套餐49/99/199/699元完成支付支持支付宝/微信进入控制台点击创建API Key复制生成的Key以sk-开头价格参考Lite版49元/月标准版99元/月Pro版199元/月企业版699元/月配置到OpenClaw方法一使用向导openclaw configure按提示选择KIMI并粘贴API Key。方法二命令行配置openclaw models auth setup-token--providerkimi# 输入API Key10.2 MiniMax Coding Plan申请步骤访问https://platform.minimaxi.com/subscribe/coding-plan注册/登录账号完成实名认证需要身份证订阅Coding Plan29/49/119元进入API管理页面创建API Key并复制配置openclaw models auth setup-token--providerminimax10.3 GLM Coding Plan申请步骤访问https://bigmodel.cn/glm-coding注册/登录智谱AI账号进入控制台点击API Keys菜单创建新的API Key复制保存配置openclaw models auth setup-token--providerglm10.4 其他模型提供商Anthropic (Claude):openclaw models auth setup-token--provideranthropic需要访问https://console.anthropic.com获取API Key。OpenAI (GPT):openclaw models auth setup-token--provideropenai需要访问https://platform.openai.com获取API Key。十一、高级配置11.1 配置多模型OpenClaw支持配置主模型和备用模型主模型失败时自动切换openclaw configsetagents.defaults.model.primarykimi/kimi-k2.5openclaw configsetagents.defaults.model.fallbacks.0glm/glm-5openclaw configsetagents.defaults.model.fallbacks.1minimax/minimax-m2.511.2 配置工作目录OpenClaw的工作目录默认是~/.openclaw/workspace你可以自定义openclaw configsetworkspace/path/to/your/workspace11.3 配置日志级别默认日志级别是info可以调整为debug获取更详细日志openclaw configsetlogging.leveldebug11.4 配置超时时间默认会话超时是30分钟可以调整# 设置为1小时openclaw configsetagents.defaults.reply.timeoutSeconds3600# 设置为2小时openclaw configsetagents.defaults.reply.timeoutSeconds7200十二、性能优化12.1 启用缓存缓存可以减少API调用提升响应速度openclaw configsetagents.defaults.cache.enabledtrueopenclaw configsetagents.defaults.cache.ttl3600# 缓存1小时12.2 优化模型选择复杂任务使用高质量模型如KIMI K2.5 Pro简单任务使用经济模型如KIMI K2.5 Lite子代理任务使用更便宜的模型12.3 定期清理定期清理旧会话和缓存释放空间# 清理旧会话保留最近7天openclaw sessions prune--days7# 清理缓存rm-rf~/.openclaw/cache/*十三、安全加固13.1 运行安全审计定期运行安全审计检查潜在风险openclaw security audit如果发现问题可以自动修复openclaw security audit--fix13.2 配置DM策略默认DM策略是pairing陌生人发消息需要你批准openclaw configsetchannels.whatsapp.dmPolicypairingopenclaw configsetchannels.telegram.dmPolicypairing13.3 启用沙盒沙盒可以在Docker容器中运行工具提升安全性openclaw configsetagents.defaults.sandbox.modenon-mainopenclaw configsetagents.defaults.sandbox.scopesession13.4 文件权限确保配置文件权限正确chmod600~/.openclaw/openclaw.jsonchmod700~/.openclaw十四、总结与建议推荐配置清单完成以上所有步骤后你的OpenClaw应该已经配置完成。以下是推荐的配置检查清单✅ 基础配置Node.js 22 已安装OpenClaw 已安装并验证初始化向导已完成API Key 已配置Gateway 正在运行Web UI 可访问✅ 权限配置Terminal 已添加到完全磁盘访问Terminal 已添加到屏幕录制Terminal 已添加到麦克风✅ 安全配置DM策略已设置为pairingWeb UI认证已启用文件权限已设置安全审计已通过✅ 高级配置可选多模型配置缓存已启用沙盒已启用守护进程已安装使用建议从小任务开始先让AI完成简单任务逐步信任定期备份定期备份~/.openclaw目录监控成本注意API调用次数控制成本持续学习探索更多功能和Skills参与社区加入Discord、GitHub分享经验恭喜你完成了OpenClaw在Mac系统上的安装部署下一步学习路径配置消息渠道接入Telegram、WhatsApp、iMessage等学习使用工具浏览器自动化、Web搜索等安装Skills插件扩展AI能力配置定时任务自动化重复工作开发自定义Skill定制专属功能参考资料OpenClaw官方文档: https://docs.openclaw.aiNode.js官网: https://nodejs.orgHomebrew官网: https://brew.sh