目录

Mac 部署安装 OpenClaw 教程:从零搭建个人 AI 助手完整指南

目录

写在前面

我折腾了好一阵子才把 OpenClaw 在我的 MacBook 上跑起来。

这中间踩了不少坑——环境版本不对、配置文件格式出错、端口被占用等等,都是些看着不大但能让人卡半天的问题。

所以我把整个过程整理成了这篇教程,尽量写得详细一些,让大家少走弯路。

这篇教程写给完全没有编程经验的普通用户,即使你从来没用过终端(就是那个黑底白字的窗口),跟着做也能顺利装好。

每一步我都会说清楚该点哪里、该输入什么,不会跳过任何"看似简单"的步骤。

这篇文章适合以下几类朋友:

  • 没有技术背景,但想在 Mac 上体验 AI 助手的普通用户
  • 想在 Mac 上部署 OpenClaw 但还没动手的
  • 安装过程中遇到问题想找解决方案的
  • 想了解 OpenClaw 能做什么、值不值得折腾的

接下来我会从最最基础的操作开始,一步一步带你走完整个流程。

OpenClaw 是什么

简单来说,OpenClaw 是一个开源的个人 AI 助手框架。

它本身不提供大语言模型,但可以帮你把 Claude、GPT、DeepSeek、Gemini 这些主流模型串联起来,再对接到 Telegram、WhatsApp、飞书、Discord 等聊天平台上,形成一个真正属于你自己的 AI 助手。

它能做的事情挺多的:

  • 多模型调用:同时接入多个 AI 模型(比如 DeepSeek、GPT、Claude),根据需要灵活切换
  • 聊天平台对接:把 AI 能力接入你日常使用的通讯工具,比如飞书、Telegram、微信等
  • 本地文件管理:让 AI 帮你处理和管理电脑上的文档
  • 浏览器自动化:让 AI 帮你完成一些重复性的网页操作
  • 对话式操控:用聊天的方式让 AI 帮你在电脑上执行各种操作
  • 记忆系统:AI 能记住之前聊过的内容,不会每次都"失忆"

截至 2026 年初,OpenClaw 在 GitHub 上已经有超过 6 万颗星,社区非常活跃。它采用 MIT 开源许可,完全免费使用。

部署前的准备工作

系统和硬件要求

在动手之前,先确认一下你的 Mac 是否满足条件:

项目 最低要求 推荐配置
操作系统 macOS 10.15 及以上 macOS 14 (Sonoma) 及以上
处理器 Intel 或 Apple Silicon 均可 M 系列芯片体验更佳
内存 8 GB 16 GB
硬盘空间 预留 10 GB 20 GB 以上更稳妥
网络 能正常上网即可(国内网络就行) 稳定的宽带连接

如果你用的是 M1、M2、M3 或 M4 芯片的 Mac,体验会特别好——Apple Silicon 的单线程性能很强,跑 Node.js 非常流畅,而且功耗极低。

需要提前准备的东西

  1. 一台 Mac 电脑:能正常开机、能上网就行
  2. AI 模型的 API Key:这个相当于一把"钥匙",用来让 OpenClaw 调用 AI 模型。国内用户推荐先用 DeepSeek、Kimi,注册就送免费额度,网络也不用额外折腾。(后面会详细说怎么获取)
  3. 大约 30 分钟的时间:第一次安装预留半小时比较稳妥,熟练之后十来分钟就够了

不需要你会编程,不需要你懂代码,跟着下面的步骤一步步操作就行。

先认识一下"终端"——你的安装工具

在开始之前,我们需要先认识一个工具——终端(Terminal)

你可以把终端理解为"用打字的方式和电脑对话"。

平时你用鼠标点击图标来打开软件、拷贝文件,而终端是用键盘输入文字命令来完成这些操作。

虽然看起来是个黑底白字的窗口,但其实操作起来并不难,就是把命令复制粘贴进去而已。

怎么打开终端

有两种方式,选一种你顺手的:

方式一:用聚焦搜索(推荐)

  1. 同时按下键盘上的 Command ⌘ 键和空格
  2. 屏幕中央会弹出一个搜索框
  3. 输入 Terminal 或者"终端"
  4. 按回车键,终端就打开了

方式二:从访达打开

  1. 打开"访达"(就是你 Dock 栏上那个笑脸图标)
  2. 点击顶部菜单栏的"前往" → “实用工具”
  3. 在里面找到"终端",双击打开

打开后你会看到一个窗口,里面可能显示类似这样的文字:

你的用户名@你的电脑名 ~ %

这就是终端的"命令行",光标在闪烁,等着你输入命令。

大概长这样子:

/img/mac-deploy-install-openclaw-tutorial/0101.png
终端

在终端里怎么输入命令

非常简单,就三步:

  1. 复制命令:用鼠标选中本文中灰色方框里的命令文字,按 Command + C 复制
  2. 粘贴到终端:点击终端窗口,按 Command + V 粘贴
  3. 执行命令:按一下回车键(Enter)

就这么简单!后面所有步骤都是这样操作:复制 → 粘贴 → 回车。

温馨提示:终端里输入密码时,屏幕上不会显示任何字符(连星号都没有),这是正常的安全机制。

只管输入你的 Mac 开机密码,输完按回车就行。

安装基础环境

OpenClaw 需要一个叫做 Node.js 的运行环境才能工作。

你可以把 Node.js 理解成 OpenClaw 的"地基"——没有它,OpenClaw 就跑不起来。

别担心,安装过程就是在终端里复制粘贴几条命令而已。

第一步:安装 Homebrew(Mac 的软件管家)

Homebrew 是 macOS 上的一个"软件安装管家",有了它,后面安装 Node.js 只需要一条命令就能搞定。

很多 Mac 上的开发工具都通过它来安装,装一次以后会经常用到。

如果你之前已经装过 Homebrew 了,可以直接跳到下一步。

不确定有没有装?在终端里输入 brew -v 然后回车,如果显示版本号就说明已经装了。

安装方法(推荐国内镜像,不用访问外网)

由于 Homebrew 官方安装脚本的服务器在国外,国内直接装可能会很慢甚至失败。这里推荐使用国内镜像源安装,速度快、不需要任何特殊网络环境。

打开终端,复制下面这行命令,粘贴进去,按回车:

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

如图:

/img/mac-deploy-install-openclaw-tutorial/0102.png
粘贴命令

执行后会出现一个菜单让你选镜像源,输入数字 1(中科大源)然后回车即可。

过程中可能会让你输入 Mac 的开机密码(输入时屏幕上不显示任何字符,这是正常的),输完按回车。

安装可能需要几分钟,耐心等一下。完成后关闭终端,重新打开一个新的终端窗口,然后验证一下:

brew -v

看到类似 Homebrew 4.x.x 的输出就说明没问题了。

备选方案:如果你的网络条件比较好,也可以用 Homebrew 官方安装命令:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

第二步:安装 Node.js

有了 Homebrew,安装 Node.js 就非常简单了。在终端里执行:

brew install node

等它自动下载安装完成(大概 1-3 分钟),然后确认一下版本是否正确:

node -v

在终端回车后,应该显示 v22.x.x 或者更高的数字(比如 v22.11.0)。再检查一下附带的包管理工具:

npm -v

显示 10.x.x 就行。

如果 node -v 显示的版本号低于 22(比如 v18.x.x),说明你之前装过旧版本。在终端执行 brew upgrade node 来升级到最新版。

第三步:配置 npm 全局路径(强烈建议做)

这一步是为了避免后面安装 OpenClaw 时碰到"权限不够"的报错。只需要执行下面 4 条命令,每条都是复制粘贴然后回车:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

说明:上面 4 条命令的作用是告诉电脑"以后安装的全局软件放到你自己的目录里",这样安装时就不会碰到权限问题了。

验证一下配置是否成功:

npm config get prefix

输出里包含 .npm-global 就对了。

第四步:配置 npm 国内镜像源(推荐做)

npm 默认从国外服务器下载软件包,国内可能会比较慢。配置成国内镜像源后,下载速度会快很多。在终端执行:

npm config set registry https://registry.npmmirror.com

这条命令把 npm 的下载源切换到了淘宝镜像(npmmirror),国内访问速度很快,后面安装 OpenClaw 就不用担心下载慢的问题了。

安装 OpenClaw

基础环境搭好了,接下来正式安装 OpenClaw。这里提供两种方式,普通用户直接看方式一就行

方式一:一键脚本安装(推荐所有人)

这是官方推荐的方式,也是最省事的。把下面这条命令复制到终端,回车执行:

curl -fsSL https://openclaw.ai/install.sh | bash

这条命令在做什么? 它会自动从 OpenClaw 官网下载安装程序,然后自动帮你完成安装。就像你在 App Store 里点"获取"一样,只不过这里是用命令的方式。

国内网络提示:如果这条命令执行后一直卡着不动(等了超过 2 分钟),可以按 Ctrl + C 中断,然后改用下面的方式二(npm 安装),效果是一样的。

脚本会自动完成以下操作:

  1. 检测你的系统环境
  2. 确认 Node.js 版本是否达标(不够的话会尝试自动安装)
  3. 下载并安装最新版 OpenClaw
  4. 在你的电脑上创建默认配置
  5. 启动初始化引导

整个过程大概 2-5 分钟。安装结束后,验证一下是否装好了:

openclaw --version

能看到版本号(比如 v2026.2.6)输出就说明安装成功了!

方式二:npm 安装(国内网络更友好)

如果方式一因为网络原因失败了,或者下载太慢,用 npm 安装反而更顺畅(因为前面已经配好了国内镜像源)。在终端执行:

npm install -g openclaw@latest

安装完成后手动执行引导:

openclaw onboard --install-daemon

如果安装报错了怎么办? 如果看到包含 sharp 或者 EACCES 字样的错误,试试这个命令:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

如果还是不行,往后翻到"常见问题"部分,那里有更详细的解决方案。

方式三:从源码构建(仅开发者需要)

如果你是开发者,想深入研究 OpenClaw 的代码或者参与贡献,可以从源码构建。普通用户可以跳过这部分。

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm link --global
openclaw onboard --install-daemon

这种方式需要提前装好 pnpm。如果没有的话,先执行 npm install -g pnpm

初始化与配置

运行初始化向导

如果你用的是一键脚本安装,引导流程会自动启动。如果没有自动启动,或者你用的是 npm 安装,在终端执行:

openclaw onboard

接下来屏幕上会出现一个交互式向导,用键盘上的方向键选择选项,按回车键确认。它会依次问你几个问题:

  1. 启动模式:用方向键选择 QuickStart(快速开始),然后按回车
  2. AI 模型选择:这里选你打算用的 AI 模型。如果你还没注册任何模型账号,可以先选 Qwen(通义千问)——它可以扫码直接使用,不需要填 Key
  3. API Key 输入:如果选了需要 Key 的模型(比如 DeepSeek),把你的密钥粘贴进去。没有的话暂时跳过,后面可以再配
  4. 聊天平台:选你想对接的通讯工具(飞书、Telegram 等),也可以先跳过

什么是 API Key? 简单说就是一个"通行证"。你注册了 AI 模型的账号后,在它的后台可以生成一串字符(通常以 sk- 开头),有了这串字符,OpenClaw 才能调用这个 AI 模型。就像你有了门卡才能刷卡进小区一样。

完成后,OpenClaw 会在你的电脑上生成核心配置文件,准备工作就算做好了。

手动编辑配置文件(一般不需要)

大部分情况下,通过上面的向导就能完成配置。但如果你后续需要修改设置(比如换一个 AI 模型、改端口号等),可以手动编辑配置文件。

配置文件的位置在:~/.openclaw/openclaw.json

~ 是什么意思? 在 Mac 里,~ 代表你的"个人文件夹",也就是 /Users/你的用户名/ 这个目录。~/.openclaw/ 就是你个人文件夹下面一个叫 .openclaw 的隐藏文件夹(文件夹名前面有个点就表示是隐藏的)。

修改前先备份一下(好习惯,万一改坏了还能恢复):

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

然后用你喜欢的编辑器打开修改。不知道用什么编辑器?最简单的方式是在终端输入:

open -e ~/.openclaw/openclaw.json

这样会用 Mac 自带的"文本编辑"应用打开配置文件。

这里给一个接入 DeepSeek 模型的基础配置示例,你可以参考:

{
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "sk-替换成你自己的Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 8192,
            "reasoning": false
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "maxConcurrent": 4,
      "model": {
        "primary": "deepseek/deepseek-chat"
      }
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local"
  }
}

如果你想用 Kimi(月之暗面)模型,把 providers 里的内容换成下面这样就行。

Kimi 最大的优势是支持 200 万字的超长上下文,特别适合处理长文档,而且 Kimi 注册有送免费额度,可以试一下:

{
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "apiKey": "sk-替换成你的Kimi Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "moonshot-v1-8k",
            "name": "Kimi 8K",
            "input": ["text"],
            "contextWindow": 8000,
            "maxTokens": 4096,
            "reasoning": false
          },
          {
            "id": "moonshot-v1-128k",
            "name": "Kimi 128K",
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 4096,
            "reasoning": false
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "maxConcurrent": 4,
      "model": {
        "primary": "moonshot/moonshot-v1-8k"
      }
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local"
  }
}

提示:Kimi 的 API Key 可以在 Moonshot AI 开放平台 注册获取。日常对话用 moonshot-v1-8k 就够了(更省 Token),需要分析长文档时再切换到 moonshot-v1-128k

修改时的注意事项(很重要,不注意就会报错):

  • apiKey 后面的值一定要替换成你自己的真实 Key
  • 所有标点符号都必须是英文半角的。最容易出错的是引号 " 和冒号 :,中文输入法下打出来的是 " ",这些都会导致报错
  • 不要在文件里加注释或者多余的文字

验证配置是否正确

改完配置后,建议验证一下格式是否正确。在终端执行:

openclaw doctor

这个命令会做一次全面检查,包括配置文件格式、Node.js 版本、API Key 是否可用等。如果一切正常,你会看到一连串的绿色对勾。如果有问题,它会告诉你具体哪里出了错。

接入 AI 模型

选择适合你的模型

OpenClaw 本身不自带 AI 大脑,你需要接入至少一个第三方 AI 服务,让它"有脑子"。

打个比方:OpenClaw 像是一台收音机,AI 模型是电台。收音机本身不产生节目,但调好频道就能听到精彩内容了。

下面是几个主流选项的对比:

模型 优势 适合谁 国内能直接用吗
DeepSeek 便宜好用,中文理解强 大部分国内用户(推荐) ✅ 可以
Qwen(通义千问) 扫码就能用,零门槛 完全不想折腾的新手 ✅ 可以
Kimi 200 万字超长上下文 需要处理长文档的人 ✅ 可以
智谱 GLM 中文能力强,免费额度多 注重中文场景的用户 ✅ 可以
Claude 对话质量最顶级 追求最佳体验的用户 ❌ 需要特殊网络
GPT 功能最全面 有国际网络条件的用户 ❌ 需要特殊网络

我的建议:如果你在国内,直接用 DeepSeek 就好。注册简单、价格便宜、国内网络直连没有任何问题,而且中文对话效果很不错。

本教程后面的配置也以 DeepSeek 为例来演示,全程不需要访问外网。

关于 Claude 和 GPT:这两个模型的 API 服务器在海外,国内普通网络无法直接访问。如果你没有特殊的网络环境,不用考虑它们——上面列的国产模型(DeepSeek、Qwen、Kimi、智谱)完全够用,而且在中文场景下表现甚至更好。

配置 DeepSeek(国内推荐)

下面手把手教你获取 DeepSeek 的 API Key:

第 1 步:注册账号

  1. 打开浏览器,访问 DeepSeek 开放平台
  2. 点击"注册",用手机号注册一个账号
  3. 注册完成后登录

第 2 步:获取 API Key

  1. 登录后,在左侧菜单找到"API Keys"(或"密钥管理")
  2. 点击"创建新密钥"
  3. 系统会生成一串以 sk- 开头的字符串,立刻复制保存好!这个密钥只会显示一次,关掉页面就看不到了
  4. 建议把它存到备忘录或者记事本里备用

关于费用:DeepSeek 注册后一般会送免费额度,日常个人使用很长时间都用不完。后续不够了再充值也很便宜。

第 3 步:把 Key 填进 OpenClaw

在终端执行下面的命令(把 sk-你的密钥 替换成你刚才复制的那串字符):

openclaw config set models.providers.deepseek.apiKey "sk-你的密钥"

配置其他国产模型(同样不需要外网)

除了 DeepSeek,你还可以同时接入其他国产模型。比如 Kimi 擅长处理超长文档,智谱 GLM 的中文理解很强,多配几个模型就能根据不同场景灵活切换:

# Kimi(月之暗面)
openclaw config set moonshot.apiKey "你的Kimi密钥"

# 智谱 GLM
openclaw config set zhipu.apiKey "你的智谱密钥"

进阶用户补充:如果你有访问海外服务的网络条件,也可以额外接入 Claude 或 GPT 等国际模型:

openclaw config set anthropic.apiKey "sk-ant-你的密钥"
openclaw config set openai.apiKey "sk-你的密钥"

但这些模型的 API 在国内无法直连,普通用户可以忽略。

配置多个模型的好处是可以随时切换。比如简单的日常聊天用便宜的 DeepSeek,遇到需要深度分析的任务切换到 Claude,这样既省钱又能保证效果。

启动与验证

启动网关服务

一切配置就绪后,就可以启动 OpenClaw 了!在终端执行:

openclaw gateway start

启动成功后,运行以下命令确认状态:

openclaw status

看到 Gateway reachable 或类似的正常状态提示,就说明服务已经跑起来了。

启动失败怎么办? 如果提示端口被占用(包含 already in use 字样),先执行下面的命令清理一下,然后重新启动:

lsof -i :18789 | grep -v PID | awk '{print $2}' | xargs kill -9 2>/dev/null

访问 Web 界面

现在到了最激动人心的时刻——打开浏览器(Safari、Chrome 都行),在地址栏输入:

http://127.0.0.1:18789

这个地址是什么意思? 127.0.0.1 是"本机"的意思,也就是你自己的电脑。18789 是 OpenClaw 使用的端口号。所以这个地址的意思是"访问自己电脑上的 OpenClaw 服务"。

你应该能看到 OpenClaw 的控制台界面。试着在输入框里发一条消息,比如"你好"或者"帮我写一首诗"。

如果几秒钟内收到了 AI 的回复,恭喜你——部署成功了! 🎉

也可以通过终端命令直接打开控制台:

openclaw dashboard

设置开机自启

每次重启电脑都要手动启动 OpenClaw 肯定很麻烦。你可以设置成开机自动启动:

openclaw gateway install

这样你的 Mac 每次开机,OpenClaw 都会在后台自动运行,不需要你手动操作。

如果以后想取消开机自启:

openclaw gateway uninstall

接入聊天工具(可选)

到这里 OpenClaw 已经可以用了,你可以在浏览器的 Web 界面里和 AI 聊天。

如果你还想更进一步,把 AI 接入到你日常用的聊天工具里(比如飞书、Telegram),这样就能直接在聊天软件里跟你的 AI 助手对话。这一步不是必须的,感兴趣的话可以试试。

以飞书为例,大致流程是这样的:

  1. 先安装飞书插件:
openclaw plugins install @m1heng-clawd/feishu
  1. 飞书开放平台 注册一个开发者账号,创建一个应用,拿到 App ID 和 App Secret

  2. 在终端里配置飞书的连接信息(把 cli_你的AppID你的AppSecret 替换成真实的值):

openclaw config set channels.feishu '{"enabled":true,"appId":"cli_你的AppID","appSecret":"你的AppSecret"}' --json
  1. 重启 OpenClaw 让配置生效:
openclaw gateway restart

配置完成后,你就可以在飞书里直接和你的 AI 助手对话了。

Telegram 用户:Telegram 的配置更简单。在 Telegram 里找到 @BotFather 创建一个机器人,它会给你一个 Bot Token,把这个 Token 填到 OpenClaw 配置里就行。

日常运维管理

部署完成后,日常用到的命令不多,这里列一份"速查表",建议收藏一下:

你想做什么 在终端输入的命令
启动 OpenClaw openclaw gateway start
停止 OpenClaw openclaw gateway stop
重启 OpenClaw openclaw gateway restart
查看是否在运行 openclaw status
做一次全面检查 openclaw doctor
查看运行日志 openclaw gateway logs
更新到最新版 openclaw update
打开 Web 控制台 openclaw dashboard

关于更新:OpenClaw 的更新频率挺高的,建议隔一两周更新一次。更新前先备份一下配置,以防万一:

cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)

然后执行更新:

openclaw update

完整卸载与重置

如果你想彻底移除 OpenClaw 重新来过,在终端依次执行下面的命令。每条命令复制粘贴后按回车:

openclaw gateway stop
pkill -f openclaw
npm uninstall -g openclaw
rm -rf ~/.openclaw
rm -rf /tmp/openclaw

执行完后,检查一下是否清理干净:

ps -ef | grep openclaw | grep -v grep

如果这条命令没有输出任何内容,说明已经彻底清理干净了。

常见问题

Q1:安装时提示 “command not found: openclaw” 怎么办?

这是最常见的问题,意思是电脑"找不到"你刚装好的 OpenClaw。原因通常是安装路径没有告诉系统。

在终端依次执行下面两条命令:

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

然后再试试 openclaw --version,应该就能正常识别了。

Q2:安装 Homebrew 时一直卡住不动怎么办?

这通常是网络问题。Homebrew 的安装源在国外,国内访问可能比较慢。你可以尝试使用国内镜像源安装。在终端执行:

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

这个脚本会引导你选择镜像源(推荐选中科大或清华源),然后自动完成安装。

Q3:Node.js 版本不够怎么升级?

在终端执行:

brew upgrade node

升级完后用 node -v 确认版本号是否达到 22 以上。

Q4:终端里输入密码时屏幕没反应,是不是坏了?

没坏!这是 Mac 终端的安全设计。当你输入密码时,屏幕上故意不显示任何字符(连星号 * 都没有),目的是防止旁边的人看到你密码有几位。

直接输入你的 Mac 开机密码,输完按回车就行。即使看不到任何东西,其实已经在输入了。

Q5:配置文件报 JSON 语法错误怎么排查?

最常见的原因:

  • 用了中文标点:比如中文的冒号 、逗号 、引号 ""。必须全部使用英文标点
  • 字符串没有用英文双引号 " 包裹
  • 最后一个字段后面多了一个逗号
  • 在配置文件里面写了中文注释

最简单的排查方法:把配置文件的内容复制到 jsonlint.com 这个网站上,点"Validate JSON"按钮,它会告诉你具体哪一行出了问题。

Q6:端口 18789 被占用了怎么办?

在终端执行:

lsof -i :18789

这条命令会显示是哪个程序占用了这个端口。找到对应的 PID 号(一串数字),然后执行:

kill -9 这里替换成PID号

如果这个端口确实被其他程序长期使用,你可以让 OpenClaw 换一个端口:

openclaw gateway --port 18790

Q7:Web 界面能打开但 AI 不回复消息?

按以下顺序排查:

  1. API Key 是否有效:有可能过期了或者余额用完了。去你注册的 AI 模型网站(比如 DeepSeek 的控制台)检查一下
  2. 运行诊断:在终端执行 openclaw doctor,看看哪里报红
  3. 查看日志:执行 openclaw gateway logs,看最后几行有没有包含 error 的信息
  4. 网络问题:如果用的是 DeepSeek 等国产模型,国内网络正常就能用。如果用的是 Claude 或 GPT 等海外模型,需要确认你的网络能正常访问对应的 API 服务器

Q8:macOS 弹出"是否允许网络连接"怎么处理?

直接点"允许"就好。OpenClaw 需要联网才能调用 AI 模型,这是正常的网络请求。

Q9:安装时遇到 EACCES 权限错误怎么解决?

这是因为 npm 安装时权限不够。如果你之前跳过了"配置 npm 全局路径"那一步,现在回去做一下就能解决。

或者临时解决:在安装命令前面加上 sudo,比如 sudo npm install -g openclaw@latest,然后输入你的 Mac 密码。

Q10:我什么都不懂,能不能更简单地用上 AI?

如果你觉得上面的步骤还是太复杂,有一个更简单的临时方案:在初始化向导中选择 Qwen(通义千问) 作为 AI 模型。它不需要你去注册账号、不需要获取 API Key,只需要用手机扫个码就能直接用了。等你熟悉了 OpenClaw 之后,再切换到 DeepSeek 等其他模型也来得及。

总结

回顾一下,整个安装过程其实就是在终端里复制粘贴命令,核心就四步:

  1. 装地基:安装 Homebrew 和 Node.js(就像装 App 前先装应用商店)
  2. 装 OpenClaw:一条命令搞定
  3. 填密钥:告诉 OpenClaw 用哪个 AI 模型、填上 API Key
  4. 启动验证:打开浏览器看看能不能和 AI 聊天

整个过程顺利的话二十分钟就能搞定。而且全程使用国内镜像源和国产 AI 模型(比如 DeepSeek),不需要任何特殊网络环境,普通家庭宽带就够了。即使你是第一次用终端,跟着本文的步骤一步步操作,也不会有什么大问题。遇到报错不要慌,往上翻翻常见问题部分,大部分坑都覆盖到了。

OpenClaw 这个项目目前还在非常活跃地迭代,社区也很友好。如果你想要一个灵活、可控、支持多模型多平台的本地 AI 助手,它是目前开源方案里非常值得尝试的一个。


如果大家在 Mac 上部署安装 OpenClaw 的过程中还有哪些没弄明白的地方,或者遇到了文中没提到的问题,欢迎在评论区交流讨论~~~ 我看到都会尽量回复的。特别是零基础的朋友,不要怕问"傻问题",每个人都是从不会开始的。也欢迎已经部署成功的朋友分享一下你们的使用体验和玩法!

版权声明

未经授权,禁止转载本文章。
如需转载请保留原文链接并注明出处。即视为默认获得授权。
未保留原文链接未注明出处或删除链接将视为侵权,必追究法律责任!

本文原文链接: https://fiveyoboy.com/articles/mac-deploy-install-openclaw-tutorial/

备用原文链接: https://blog.fiveyoboy.com/articles/mac-deploy-install-openclaw-tutorial/