OpenClaw for Mac:全套部署实录,含配置模板

给自己电脑装一个 AI 代理，这件事值得做，而且值得做好。

不是每个 AI 工具都配叫「代理」。 ChatGPT 是聊天窗口， Claude 是对话助手——它们都跑在别人的服务器上。OpenClaw 不一样，它装在你的电脑里，能调用本地文件、搜索网页、连微信群定时发消息、接上几十种模型。

听起来复杂？实际走一遍， 5 步搞定。

第一步：装好 Node.js

OpenClaw 依赖 Node.js 22.14 以上，推荐 24.x 。 macOS 自带版本太旧，需要单独装。

brewinstallnode 

验证版本：

node-v# → v22.x.x 或 v24.x.x npm-v# → >= 10

⚠️ 如果之前装了 nvm 或 fnm 管理 Node 版本，确认 shell 启动文件已经加载了版本管理器的初始化脚本。很多人卡在这一步——node 装了但 shell 不认。

macOS 自带的 Node 不要用。 Homebrew 版或 nodejs.org^[1] 的 LTS 版最稳。

第二步：安装 OpenClaw

两条路，看你的场景选。

快速上手（推荐）：

curl-fsSLhttps://openclaw.ai/install.sh|bash 

一条命令搞定——自动检测系统 → 安装 Node → 装 OpenClaw → 启动初始化。全程 2-3 分钟。

跳过引导流程的话：

curl-fsSLhttps://openclaw.ai/install.sh|bash-s----no-onboard 

已有 Node 环境：

npminstall-gopenclaw@latest openclawonboard--install-daemon 

--install-daemon 会在 macOS 注册 LaunchAgent，确保后台持续运行、开机自启。

权限报错就加 --user：npm install -g openclaw@latest --user

🐌 国内 curl 脚本偶尔 SSL 超时，直接切 npm 安装就能绕过，不用硬扛。

第三步：验证服务状态

三条命令确认一切正常：

openclaw--version# CLI 是否可用 openclawdoctor# 配置有无问题 openclawgatewaystatus# 服务是否在跑

正常输出长这样——端口 18789，Runtime: running。

控制面板在这：👉 http://127.0.0.1:18789/^[2]

❓ openclaw 命令找不到？

99% 是 PATH 问题：

bash npm prefix -g      # 查全局安装目录 echo $PATH         # 看在不在搜索路径里

把 <npm-prefix>/bin 加到 ~/.zshrc 里，重启终端。

第四步：配置模型接入

配置文件在 ~/.openclaw/openclaw.json。安装脚本会自动生成一份基础配置，但模型需要你自己填。

以 DeepSeek 为例，在 models.providers 里加上：

{models:{providers:{deepseek:{baseUrl:"https://api.deepseek.com",api:"openai-completions",models:[{id:"deepseek-chat",name:"DeepSeek V3",input:["text"],contextWindow:64000,maxTokens:4096,}]}}}}

支持的服务商覆盖了主流选项：OpenAI、Anthropic、DeepSeek、Google Gemini、阿里通义千问、百度文心、Moonshot。每个模型可单独配置上下文窗口和成本。

💰 模型差价很大——DeepSeek V3 输入约 0.14 元/M tokens， GPT-4o 约 2-3 元。选对了每月省不少。

配置格式是 JSON5，支持注释和尾随逗号，比纯 JSON 顺手。改完即生效——不用重启 Gateway。

第五步：开启工具能力

想让 AI 能搜索网页、读取链接？在配置里加上：

{tools:{web:{search:{enabled:true},fetch:{enabled:true}}}}

🔑 没有工具能力的 AI 是「聊天机器人」，开了工具才是 代理。区别：前者给你建议，后者帮你执行。

装完能做什么

OpenClaw 是个 框架。你装什么 skill ，它就变成什么。有人做自动化客服，有人做内容工厂，有人做个人知识管家。

技术工具的价值不在安装这一步。但这几步走错了后续全是坑——PATH 不对报错、模型配错白花钱、工具没开等于装了个哑巴。

本文覆盖了从零到 gateway 跑通的全过程，每步都经过实操验证。建议收藏，换台机器时直接照着来。

OpenClaw 的能力边界远不止这些。关于模型路由策略、渠道接入、定时任务编排、企业系统集成——后续逐篇展开。

📌 关于作者

我是李宏阳， AIGC 培训讲师、 AI 自媒体博主

人社部+阿里达摩院认证人工智能训练师（高级）

前 CIO/CDO ， 20 年企业数智化实战经验

2025 年完成 AIGC 培训 50 场，覆盖 5000+ 人

专注 AIGC 培训及数智化解决方案落地

公众号/视频号/小红书：李宏阳讲 AI

参考链接

[1] nodejs.org: https://nodejs.org

[2] http://127.0.0.1:18789/: http://127.0.0.1:18789/