1. github地址：https://github.com/openclaw/openclaw#

2. 快速安装：

国内：

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

Windows (PowerShell)：

【win+s】,搜索powershell然后选择管理员身份打开终端，接着执行下面的命令，等着他自己跑就行了，等待时间比较长，不是卡住了，不用担心。最主要的是这里直接用国内的网络就可以了

iwr -useb https://clawd.org.cn/install.ps1 | iex

海外：

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

git源码安装

# 国内做的一个镜像
git clone git@gitee.com:OpenClaw-CN/openclaw-cn.git  

OpenClaw CN 引入了最新的底层安全机制与构建工具，请确保环境满足以下要求：

Node.js：必须 >= v22.0.0 (下载 Node.js v22)
包管理器：强制推荐使用 pnpm (npm 在处理依赖树时可能会卡死)
Git：用于下载代码 (下载 Git)
0. 安装 pnpm (如果你还没有)#
bash
npm install -g pnpm
1. 下载代码与版本选择#
为了确保国内访问速度，请从 Gitee 镜像仓库下载。 为了获得最稳定的体验，推荐切换到最新的稳定版分支：

bash
# 1. 克隆仓库
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn
2. 配置国内加速 (关键！)#
在安装依赖前，务必设置 pnpm 镜像源，否则下载速度会很慢：

bash
pnpm config set registry https://registry.npmmirror.com/
3. 安装与构建#
OpenClaw 是一个现代化的全栈应用，首次运行需要编译前端 UI 和后端核心：

bash
# 安装依赖 (飞快 🚀)
pnpm install

# 构建前端界面，首次运行时自动安装 UI 依赖
pnpm ui:build

# 构建核心服务
pnpm build
 

源码安装配置全局命令

一、前置准备（安装依赖）

首先确保系统已安装必备工具，未安装则执行以下命令：

# 1. 安装 Python 3.8+（推荐 3.10）、pip、git
# macOS（通过 brew）
brew install python3 git

# Linux（Ubuntu/Debian）
sudo apt update && sudo apt install -y python3 python3-pip python3-venv git

# 2. 验证安装
python3 --version  # 需显示 3.8+
pip3 --version
git --version

二、源码克隆与虚拟环境创建

1. 克隆 OpenClaw 源码

# 克隆官方仓库（或你的自定义分支）
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# （可选）切换到稳定版本（避免开发版bug）
git checkout v1.0.0  # 替换为最新稳定版本号

2. 创建并激活 Python 虚拟环境

# 创建虚拟环境（推荐放在源码目录下）
python3 -m venv venv

# 激活虚拟环境
# macOS/Linux
source venv/bin/activate

# 激活后终端前缀会显示 (venv)，表示进入虚拟环境

三、源码安装（核心步骤）

在虚拟环境中执行源码安装，将 OpenClaw 安装到环境中：

# 安装依赖（先装 setup 依赖）
pip install -r requirements.txt

# 源码安装（editable 模式，修改源码后无需重新安装）
pip install -e .

# 验证安装
openclaw --version
# 输出版本号（如 openclaw 1.0.0）则安装成功

四、配置 openclaw 命令全局可用（关键）

源码安装后，openclaw 命令仅在虚拟环境中可用，配置全局可用有两种方式：

方式 1：创建软链接（推荐，简单稳定）

bash

运行

# 1. 先查看虚拟环境中 openclaw 可执行文件路径
which openclaw
# 示例输出：/xxx/openclaw/venv/bin/openclaw

# 2. 创建软链接到系统全局目录（如 /usr/local/bin）
sudo ln -s /xxx/openclaw/venv/bin/openclaw /usr/local/bin/openclaw

# 3. 验证全局可用（退出虚拟环境后测试）
deactivate  # 退出虚拟环境
openclaw --version  # 能输出版本号则成功

方式 2：配置环境变量（适合多版本管理）

bash

运行

# 1. 编辑终端配置文件（macOS zsh 为例）
open ~/.zshrc

# 2. 在文件末尾添加以下内容（替换为你的源码路径）
export PATH="/xxx/openclaw/venv/bin:$PATH"

# 3. 生效配置
source ~/.zshrc

# 4. 验证
openclaw --version

五、初始化 OpenClaw 配置（首次安装必做）

# 初始化配置文件（生成 ~/.openclaw/config.yaml）
openclaw init

# 编辑配置文件（添加 API Key、平台配置等）
open ~/.openclaw/config.yaml

# 示例：配置 OpenAI API Key
# 在 config.yaml 中添加：
openai:
  api_key: "sk-你的OpenAI密钥"

# 启动网关（验证配置）
openclaw gateway start

六、常见问题与解决

问题 1：执行 pip install -e . 报错「缺少 setuptools」

解决：

pip install --upgrade setuptools wheel

问题 2：创建软链接后提示「Permission denied」

解决：

# 给可执行文件添加执行权限
chmod +x /xxx/openclaw/venv/bin/openclaw
# 重新创建软链接
sudo ln -sf /xxx/openclaw/venv/bin/openclaw /usr/local/bin/openclaw

问题 3：全局命令仍提示 command not found

解决：

# 检查 /usr/local/bin 是否在系统 PATH 中
echo $PATH | grep /usr/local/bin

# 若不在，添加到配置文件（~/.zshrc 或 ~/.bashrc）
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

总结

1. 源码安装核心步骤：克隆源码 → 创建虚拟环境 → 激活环境 → pip install -e . 安装；
2. 全局可用配置：优先用软链接方式，简单且不污染系统环境；
3. 首次安装需执行 openclaw init 生成配置文件，填写 API Key 等关键信息后启动网关。
4. 验证成功的关键：退出虚拟环境后，执行 openclaw --version 能输出版本号，openclaw gateway start 能正常启动服务。

#不是全局安装，请通过 pnpm openclaw ... 运行仓库命令。

启动初始化向导#

openclaw onboard --install-daemon

安装后#
快速检查：openclaw doctor
检查 Gateway 网关健康状态：openclaw status + openclaw health
打开仪表板：

openclaw dashboard