基于 Mac 的 OpenClaw 安装部署文档

基于 Mac 的 OpenClaw 安装部署文档

一、前置准备

1. 环境要求

· 操作系统:macOS(Intel / Apple 芯片均可)

· 已预装工具:git(macOS 系统自带,无需额外安装)

· 网络环境:可访问国内镜像源(避免 GitHub 连接超时)

2. 模型推荐

· 推荐:阿里云百炼 Coding Plan API Key(用于高性能代码开发模型)

二、第一步:安装 Homebrew(macOS 包管理器)

1、配置清华镜像源(解决 GitHub 卡顿问题)

# 清华镜像源(推荐)

bash

HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"

export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"

export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"

export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"

2、执行清华镜像安装脚本

bash

# 清华镜像安装脚本(推荐)

git clone --depth=1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git brew-install

/bin/bash brew-install/install.sh

rm -rf brew-install

3、让brew命令生效

· Intel 芯片:

bash

echo 'eval "$(/usr/local/bin/brew shellenv zsh)"' >> ~/.zprofileeval "$(/usr/local/bin/brew shellenv zsh)"

· Apple 芯片 (M1/M2/M3):

bash

echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofileeval "$(/opt/homebrew/bin/brew shellenv zsh)"

1-geaQ.png

4、验证安装成功

bash

brew --version

输出版本号(如 Homebrew 4.3.0)即代表安装成功。

三、第二步:安装 OpenClaw

1. 执行官方安装脚本

bash

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

2. 安装过程关键节点

脚本自动检测系统为 macos,选择 npm 安装方式

自动安装 Node.js(若未安装),提示 Node.js installed

自动安装 OpenClaw 最新版本(如 v2026.3.24)

3. 验证 OpenClaw 安装

bash

openclaw --version

输出版本号即代表安装成功。

四、第三步:初始化配置(onboard 向导)

1. 启动配置向导

bash

openclaw onboard

2. 安全基线确认

界面提示:I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?

操作:选择 Yes → 回车(个人使用场景)

微信图片_2026-04-03_142315_294.png

3. 选择设置模式

界面:Setup mode

推荐:QuickStart(快速初始化,后续可精细调整)→ 回车

4. 选择模型 / 认证提供商

界面:Model/auth provider

Coding Plan 推荐选择(这里以阿里云百炼为例,大家按需选择即可):

选择 Aliyun DashScope(阿里云百炼)→ 回车

输入 Coding Plan API Key(以 sk-sp- 开头)

选择编程模型:qwen3.5-plus / qwen3-coder

5. 选择交互通道

界面:Select channel (QuickStart)

推荐选择:

这里先跳过:Skip for now

6. 配置 Web 搜索与技能

Web search:选择 Skip for now

Configure skills now?:选择 Yes → 回车

7. 跳过无关技能依赖安装

界面:Install missing skill dependencies

操作步骤:

方向键选中 Skip for now

按 空格键 勾选

按 回车 确认

后续第三方技能配置:均选择 No → 回车

8. 激活 Bot

界面:How do you want to hatch your bot?

推荐:Hatch in TUI (recommended) → 回车

五、第四步:启动服务与功能验证

1. 启动 OpenClaw 服务

bash

openclaw start

2. 进入终端交互界面(TUI)

服务启动后自动进入 TUI 界面,显示:

plaintext

openclaw tui - ws://127.0.0.1:18789 - agent main - session main

Wake up, my friend!

3. 开始使用OpenClaw

给 OpenClaw 发送消息即可获得回复

 4.网页版地址获取

向 OpenClaw 直接获取网页地址和 Gateway Token 即可

OpenClaw命令大全 2026-04-03
OpenClaw Web UI 快捷命令大全 2026-04-03

评论区