mac下安装openclaw

复制代码

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

或者选择国内镜像源
# 从阿里云下载安装脚本并安装 Homebrew 
git clone https://mirrors.aliyun.com/homebrew/install.git brew-install
/bin/bash brew-install/install.sh
rm -rf brew-install

确认homebrew版本
brew --version

输入以下命令，如果显示 Your system is ready to brew.，说明环境配置完美
brew doctor

安装后brew提示 command not found 怎么办？
通常是因为 Homebrew 默认安装路径（/opt/homebrew，Apple Silicon 芯片）或 /usr/local 不在系统的默认搜索路径中。并且是因为Homebrew安装的环境变量没有生效，

绝大多数现代 Mac 用户使用的是 Zsh，但为了保险起见，可以先确认一下：
echo $SHELL
如果显示 /bin/zsh 或 /bin/bash，请继续看下面的步骤

情况 A：Apple Silicon 芯片 (M1, M2, M3 等)
如果你的 Mac 是近几年的机型，大概率是这种芯片。Homebrew 会被安装在 /opt/homebrew 目录下
编辑 ~/.zshrc
在文件末尾添加：
export PATH="/opt/homebrew/bin:$PATH"

情况 B：Intel 芯片
如果你的 Mac 是 Intel 处理器，Homebrew 默认安装在 /usr/local。
编辑 ~/.zshrc
在文件末尾添加：
export PATH="/usr/local/bin:$PATH"

在终端中运行以下命令：
source ~/.zprofile
brew --version

复制代码

# 下载并安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 代替重启 shell
\. "$HOME/.nvm/nvm.sh"
# 下载并安装 Node.js：
nvm install 24
nvm use 24
# 验证 Node.js 版本：
node -v
# 验证 npm 版本：
npm -v


该脚本将 nvm 仓库克隆到 ~/.nvm，并尝试将以下代码片段中的源代码行添加到正确的配置文件（~/.bashrc、~/.bash_profile、~/.zshrc 或 ~/.profile），mac一般是~/.zshrc。如果你发现安装脚本更新了错误的配置文件，请将 $PROFILE 的环境变量设置为配置文件的路径，然后重新运行安装脚本。


export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

复制代码

brew install git

git version

复制代码

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

确认安装
openclaw --version

复制代码

运行初始化向导
openclaw onboard --install-daemon

--install-daemon 参数会将 OpenClaw 注册为系统服务，确保开机自启

配置完成后，建议运行健康检查命令，确保所有服务正常
openclaw doctor

如果显示全绿或通过，说明配置成功。
如果提示 Gateway 未启动，可以手动启动服务
openclaw gateway start

开始使用
直接在终端输入 openclaw 即可进入聊天界面
输入 openclaw dashboard ，浏览器会自动打开管理面板


检查开机自动启动
cat ~/Library/LaunchAgents/ai.openclaw.gateway.plist
文件存在即可
<array>
    <!-- 这里必须是你所使用的node的绝对路径，如果是nvm就要事nvm装的node的绝对路径 -->
    <string>/Users/lianchuan/.nvm/versions/node/v22.x.x/bin/node</string>
    <string>.../bin/openclaw</string>
    <string>gateway</string>
    <string>start</string>
</array>

复制代码

如果初始化时没有配置web搜索工具，可以在之后再配置
openclaw configure --section web
可选项也比初始化时多了，可以根据自己情况选择

如果初始化提示
Shell completion 
Failed to generate completion cache. Run `openclaw completion --install` later.
可以在之后运行
openclaw completion --write-state
openclaw completion --install

复制代码

所有命令帮助
openclaw --help

cli向导式核心配置逐项可配
openclaw configure

查看当前配置
openclaw config get gateway.port
修改端口配置
openclaw config set gateway.port 18790

查看网关状态
openclaw gateway status
重启网关
openclaw gateway restart

查看模型状态
openclaw models status
查看可用模型列表
openclaw models list
设置模型
openclaw models set qwen/qwen3.5-plus

更新OpenClaw
openclaw update

查看日志
openclaw logs --follow

复制代码

检查浏览器支持是否就绪
openclaw browser doctor

启动一个浏览器
openclaw browser start
打开网址
openclaw browser open https://www.baidu.com

复制代码

下载地址https://github.com/openclaw/openclaw/releases
下面找最新版本的dmg文件下载，然后自行安装即可

之后到应用程序中，或者访达-应用程序中即可看到，名字就叫"OpenClaw"
要卸载，就在访达-应用程序中，对OpenClaw应用右键"移到废纸篓"即可

复制代码

openclaw的mac客户端，默认找了系统的node，而不是nvm的node

这是一个在 macOS 上非常经典的问题。OpenClaw（以及很多基于 Node.js 的应用）在作为系统服务（Daemon）后台运行时，无法读取到你在终端里通过 nvm 设置的环境变量。
简单来说：你的终端知道 Node 在哪，但后台服务不知道。

💡 避坑建议
如果你不想每次升级 Node 版本都遇到这个问题，可以考虑使用 Homebrew 安装一个固定版本的 Node 供 OpenClaw 专用，或者在 .zshrc 中设置 nvm use --default，但这通常不如直接使用 方案二 来得直接有效。

可以先尝试一下在系统node环境下只安装一下，而不用配置，也许可以让系统node环境的openclaw命令读取到你已经初始化好的openclaw配置
npm i -g openclaw

这里有三种解决方案，按推荐程度排序：

🛠️ 方案一：使用 OpenClaw 自带修复命令（最快）
OpenClaw 官方已经预判到了这个问题，并提供了一个自动修复命令。它会尝试自动定位你当前的 Node 路径并更新服务配置。

在终端执行：
openclaw doctor --repair

如果提示修复成功，重启网关服务：
openclaw gateway restart

检查状态：
openclaw gateway status

🔄 方案二：重新安装守护进程（最彻底）
如果方案一无效，或者你刚刚升级了 Node 版本，最彻底的方法是重新注册服务。这会强制 OpenClaw 重新读取当前的系统环境，生成新的启动脚本。
确保当前终端使用的是正确的 Node 版本：
nvm use 22  # 或者你安装的最新版，如 nvm use 24
which node  # 记下这个路径，备用
重新运行安装向导的守护进程部分：
openclaw onboard --install-daemon
注意：这会覆盖旧的 .plist 启动文件，将其指向当前 nvm 下的 Node 路径。
openclaw gateway restart

🔧 方案三：手动修改启动配置文件（高阶）
如果上述方法都失败，说明 launchctl 缓存了旧路径，你需要手动修改 macOS 的启动代理文件。
找到你的 Node 路径：
在终端输入 which node，假设输出是 /Users/lianchuan/.nvm/versions/node/v22.x/bin/node。
编辑配置文件：
使用编辑器打开 OpenClaw 的启动配置文件：
nano ~/Library/LaunchAgents/ai.openclaw.gateway.plist
修改路径：
找到 <key>ProgramArguments</key> 下面的 <string> 标签。
你会看到类似 /usr/local/bin/node 或旧版的路径。
将其修改为你第 1 步中查到的 nvm 路径（例如 /Users/lianchuan/.nvm/versions/node/v22.x/bin/node）。
保存并重载：
按 Ctrl + O 保存，回车，然后 Ctrl + X 退出。
执行以下命令重载配置：
launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist
launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist
openclaw gateway restart

复制代码

先登录，以便安装插件时不被限流
token要在官网https://clawhub.ai/settings下的API tokens里生成
npx clawhub@latest login --token <token>

安装插件
npx clawhub@latest install sonoscli --registry=https://cn.clawhub-mirror.com

复制代码

openclaw uninstall --all --yes

uninstall：执行卸载操作
--all：彻底删除所有组件，包括网关服务、本地数据库、配置文件等
--yes：自动确认所有删除操作，无需手动输入

官方卸载命令执行后，还需删除CLI工具

npm uninstall -g openclaw