在 macOS 上安装 OpenClaw：打造你的私人 AI 助手

适用系统：macOS 12+
OpenClaw 版本：2026.3.8

什么是 OpenClaw？

OpenClaw 是一个可以运行在你自己设备上的个人 AI 助手。它能够：

通过你常用的渠道与你沟通（WhatsApp、Telegram、Discord、飞书等）
在 macOS/iOS/Android 上进行语音对话
渲染实时 Canvas 界面
完全本地部署，数据私密可控

如果你想要一个本地化、快速响应、全天候在线的个人助手，OpenClaw 就是理想选择。

环境准备

1. 检查系统要求

操作系统：macOS 12.0 或更高版本
Node.js：版本 ≥ 22（必需）
npm：随 Node.js 一起安装

2. 安装 Node.js

打开终端，检查是否已安装 Node.js：

node --version

如果未安装或版本低于 22，请访问 Node.js 官网下载最新版本。

我的环境：

macOS 12.7.6 (Intel x86_64)

Node.js v24.14.0

npm 11.9.0

我是从官网https://nodejs.org/en/download下载的最新版本进行的安装：

微信图片_20260312084541_101_172.jpg

安装步骤

步骤 1：配置 npm 全局安装路径（可选但推荐）

为了避免权限问题，建议配置 npm 全局包安装到用户目录：

# 创建全局安装目录
mkdir -p ~/.npm-global

# 配置 npm 使用新目录
npm config set prefix '~/.npm-global'

# 将全局目录添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc

# 使配置生效
source ~/.zshrc

步骤 2：安装 OpenClaw

使用 npm 全局安装 OpenClaw：

npm install -g openclaw@latest

或者使用 pnpm（如果已安装）：

pnpm add -g openclaw@latest

步骤 3：验证安装

安装完成后，验证 OpenClaw 是否正确安装：

openclaw --version

预期输出：

(base) MacRL:~ ruiliu$ openclaw --version
OpenClaw 2026.3.8 (3caab92)

初始化配置

运行向导

OpenClaw 提供了友好的交互式向导，帮助完成初始配置：

openclaw onboard --install-daemon

向导会引导你完成以下步骤：

设置 Gateway 网关：配置控制平面
配置工作区：创建隔离的工作环境
连接通信渠道：绑定 Telegram、Discord 等
安装技能：扩展 AI 能力

手动配置（高级用户）

如果需要手动配置，可以编辑配置文件：

# 配置文件位置
~/.openclaw/openclaw.json

配置示例：

{
  "meta": {
    "lastTouchedVersion": "2026.3.7",
    "lastTouchedAt": "2026-03-09T06:14:48.681Z"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "qwen3.5-plus",
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

启动与使用

启动 Gateway

# 默认端口启动
(base) MacRL:~ ruiliu$ openclaw gateway --port 18789 --verbose

🦞 OpenClaw 2026.3.8 (3caab92) — Somewhere between 'hello world' and 'oh god what have I built.'

08:49:34 Registered plugin command: /pair (plugin: device-pair)
08:49:34 Registered plugin command: /phone (plugin: phone-control)
08:49:34 Registered plugin command: /voice (plugin: talk-voice)
08:49:34 [canvas] host mounted at http://127.0.0.1:18789/__openclaw__/canvas/ (root /Users/ruiliu/.openclaw/canvas)
08:49:34 bonjour: starting (hostname=openclaw, instance="MacRL (OpenClaw)", gatewayPort=18789, minimal=true)
08:49:34 [heartbeat] started
08:49:34 [health-monitor] started (interval: 300s, startup-grace: 60s, channel-connect-grace: 120s)
08:49:34 [gateway] agent model: bailian/qwen3.5-plus
08:49:34 [gateway] listening on ws://127.0.0.1:18789, ws://[::1]:18789 (PID 2805)
08:49:34 [gateway] log file: /tmp/openclaw/openclaw-2026-03-12.log
08:49:34 [browser/server] Browser control listening on http://127.0.0.1:18791/ (auth=token)
08:49:48 [ws] ← open remoteAddr=127.0.0.1 conn=6aac40fb…533b
08:49:48 [ws] ← connect client=openclaw-control-ui version=2026.3.8 mode=webchat clientId=openclaw-control-ui platform=MacIntel auth=device-token
08:49:49 [ws] webchat connected conn=6aac40fb-b976-4240-a0bd-50875bba533b remote=127.0.0.1 client=openclaw-control-ui webchat v2026.3.8
08:49:49 [ws] → hello-ok methods=97 events=19 presence=2 stateVersion=2
08:49:49 [ws] → event health seq=1 clients=1 presenceVersion=2 healthVersion=3
08:49:49 [ws] ⇄ res ✓ agent.identity.get 3ms id=09cfcee7…92b6
08:49:49 [ws] ⇄ res ✓ agents.list 1ms id=db58f456…8e65
08:49:49 [ws] ⇄ res ✓ tools.catalog 3ms id=03cf984f…62b9
08:49:49 [ws] ⇄ res ✓ sessions.list 5ms id=3fd03bef…2b35
08:49:49 [ws] ⇄ res ✓ device.pair.list 24ms id=879d1764…abaf
08:49:49 [ws] ⇄ res ✓ node.list 30ms id=a195bd92…23e2
08:49:49 [ws] ⇄ res ✓ chat.history 52ms id=8b7c550b…5d59
08:49:51 [ws] ⇄ res ✓ node.list 2ms id=36eea866…f4c3
08:49:56 [ws] ⇄ res ✓ node.list 2ms id=e0511155…bbcc

# 使用开发模式（端口 19001）
openclaw --dev gateway

服务启动界面地址 http://127.0.0.1:18789

image.png

中英文切换

image.png

修改大模型的页面操作位置

image.png

常用命令参考

命令	说明
`openclaw --version`	查看版本
`openclaw --help`	查看帮助
`openclaw onboard`	运行安装向导
`openclaw gateway`	启动网关服务
`openclaw agent`	运行 AI 助手
`openclaw browser`	管理浏览器
`openclaw channels`	管理通信渠道
`openclaw update`	更新 OpenClaw
`openclaw doctor`	诊断问题

开发频道说明

OpenClaw 提供三个发布频道：

频道	说明	适用场景
stable	稳定版本（标签 `vYYYY.M.D`）	生产环境
beta	测试版本（标签 `vYYYY.M.D-beta.N`）	尝鲜体验
dev	开发分支（`main` 分支最新）	开发测试

切换频道：

openclaw update --channel stable|beta|dev

常见问题

Q1：权限错误 "EACCES: permission denied"

解决方案：按照步骤 1 配置 npm 全局安装到用户目录，或使用 sudo：

sudo npm install -g openclaw@latest

Q2：Node.js 版本过低

OpenClaw 需要 Node.js ≥ 22。使用 nvm 升级：

nvm install 22
nvm use 22

Q3：如何更新 OpenClaw？

# 更新到最新版本
openclaw update

# 更新后运行诊断
openclaw doctor

Q4：配置文件在哪里？

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

卸载

如需卸载 OpenClaw：

# 卸载 npm 包
npm uninstall -g openclaw

# 删除配置目录（可选，会丢失所有数据）
rm -rf ~/.openclaw

总结

OpenClaw 是一个功能强大的个人 AI 助手，通过简单的几步安装即可在 Mac 上运行。它的优势在于：

完全本地部署，数据隐私可控
支持多渠道通信，随时随地访问
丰富的扩展能力，按需安装技能
开源免费，社区活跃

如果你也想拥有一个专属的 AI 助手，不妨试试 OpenClaw！

如果本文对你有帮助，欢迎点赞收藏 🌟

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成，浏览时请结合常识与多方信息审慎甄别。
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。

在 macOS 上安装 OpenClaw：打造你的私人 AI 助手