macOS 安装部署 OpenClaw 详细教程（含常用命令速查表）

3小时前 1

OpenClaw 是一个强大的自托管 AI 助手运行环境，在 macOS 上运行体验非常好。本文详细介绍在 Mac 上安装部署 OpenClaw 的完整方法。

一、资源下载

1.1 官方资源

官网：https://openclaw.ai
官方文档：https://docs.openclaw.ai
GitHub 仓库：https://github.com/openclaw/openclaw
ClawHub 技能市场：https://clawhub.ai

1.2 安装方式对比

安装方式	命令	适用场景
官方安装脚本（推荐）	`curl -fsSL https://openclaw.ai/install.sh \| bash`	大多数用户首选
本地安装脚本	`curl -fsSL https://openclaw.ai/install-cli.sh \| bash`	不需要 root 权限
npm 全局安装	`npm install -g openclaw`	已有 Node.js 环境
Homebrew 安装	`brew install openclaw`	习惯使用 Homebrew

二、系统要求

系统版本：macOS Ventura 或更高版本（推荐 Sequoia）
内存：最低 4GB（推荐 8GB 以上）
磁盘空间：至少 10GB 可用空间
Node.js：18 或更高版本（安装脚本会自动安装）
网络：需要互联网连接以下载和更新

三、安装步骤

3.1 方法一：官方安装脚本（推荐）

打开终端，执行以下命令：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

安装脚本会自动完成以下步骤：

检测操作系统（macOS 或 Linux）
自动安装 Homebrew（如果未安装）
安装 Node.js 24（如果未安装）
安装 Git（如果未安装）
通过 npm 或 git 安装 OpenClaw
运行安装后检查和配置

3.2 方法二：npm 全局安装

如果你已经安装了 Node.js，可以直接使用 npm 安装：

npm install -g openclaw

3.3 方法三：Homebrew 安装

如果你习惯使用 Homebrew：

brew install openclaw

3.4 方法四：手动下载安装

从 GitHub 下载最新版本：

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

四、初始化配置

4.1 首次配置

安装完成后，执行初始化命令：

openclaw setup

或者使用交互式配置向导：

openclaw configure

4.2 配置文件位置

配置文件：~/.openclaw/openclaw.json
工作空间：~/.openclaw/workspace
日志文件：~/.openclaw/logs/

4.3 配置 LLM 提供商

编辑配置文件添加你的 AI 模型 API：

openclaw config set models.providers.openai.apiKey "your-api-key"

五、配置频道（可选）

5.1 Telegram Bot 配置

创建 Telegram Bot 获取 Token：

在 Telegram 中搜索 @BotFather
发送 /newbot 创建新 Bot
复制获得的 Token
配置 OpenClaw：

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.botToken "你的Telegram_Bot_Token"

5.2 其他频道选项

OpenClaw 支持多种聊天频道，包括：

Telegram
Discord
WhatsApp
Line
Slack
Signal
iMessage

六、常用命令速查表

命令	功能说明
`openclaw --version`	查看 OpenClaw 版本
`openclaw setup`	初始化本地配置和工作空间
`openclaw configure`	交互式配置（频道、网关、默认设置）
`openclaw gateway`	启动 WebSocket 网关服务
`openclaw gateway --force`	强制重启网关
`openclaw dashboard`	在浏览器打开控制台界面
`openclaw status`	查看频道健康状态和最近会话
`openclaw health`	获取网关健康状态
`openclaw doctor`	健康检查和快速修复
`openclaw models list`	列出可用的 AI 模型
`openclaw channels list`	列出已配置的聊天频道
`openclaw skills list`	列出已安装的技能
`openclaw skills install <name>`	安装新技能（从 ClawHub）
`openclaw logs`	实时查看网关日志
`openclaw update`	更新 OpenClaw 到最新版本
`openclaw help`	显示帮助信息

七、常见问题与解决

问题一：安装后命令找不到

如果安装成功但在新终端中找不到 openclaw 命令，需要刷新环境变量：

source ~/.zshrc

或者重新打开终端窗口。

问题二：权限错误

遇到 npm 权限问题时，不要使用 sudo：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

问题三：端口被占用

如果端口 18789 被占用，可以指定其他端口：

openclaw gateway --port 18790

问题四：Homebrew 安装慢

使用国内镜像加速（可选）：

git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git

八、Mac Mini 24小时运行优化

8.1 电源设置

系统设置 → 电池 → 将"防止自动进入睡眠"设置为"始终"。同时启用"断电后自动重启"。

8.2 使用 launchd 管理自启

创建 ~/Library/LaunchAgents/com.openclaw.agent.plist：

mkdir -p ~/Library/LaunchAgents
cat > ~/Library/LaunchAgents/com.openclaw.agent.plist <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.openclaw.agent</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/bin/node</string>
<string>/Users/YOUR_USER/openclaw/src/index.js</string>
</array>
<key>WorkingDirectory</key>
<string>/Users/YOUR_USER/openclaw</string>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>StandardOutPath</key>
<string>/tmp/openclaw.log</string>
<key>StandardErrorPath</key>
<string>/tmp/openclaw-error.log</string>
</dict>
</plist>
EOF

加载服务：

launchctl load ~/Library/LaunchAgents/com.openclaw.agent.plist

九、总结

本文详细介绍了在 macOS 上安装部署 OpenClaw 的完整方法，包括官方安装脚本、npm、Homebrew 等多种安装方式，以及初始化配置、常用命令和常见问题解决方案。

推荐大多数用户使用官方安装脚本一键安装，简单快捷。安装完成后使用 openclaw setup 初始化配置，openclaw gateway 启动服务，openclaw dashboard 打开控制台。