OpenClaw 跨平台安装指南：Windows、macOS 与 Linux

npm install -g openclaw

国内加速建议：

npm config set registry https://registry.npmmirror.com
npm install -g openclaw
npm config set registry https://registry.npmjs.org

macOS 平台安装

方法一：官方脚本

1. 打开终端 使用 Spotlight (Cmd + Space) 搜索'终端'并启动。

2. 运行安装命令

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

   国内镜像：

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

3. 验证

   openclaw --version
   

方法二：Homebrew 手动安装

1. 安装 Homebrew（未安装时）

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
   eval "$(/opt/homebrew/bin/brew shellenv)"
   

2. 安装依赖

   brew install node git
   

3. 安装 OpenClaw

   npm install -g openclaw
   

Linux 平台安装

方法一：官方脚本

1. 更新系统包管理器 Ubuntu/Debian:

   sudo apt update && sudo apt upgrade -y
   

   Fedora:

   sudo dnf update -y
   

   Arch Linux:

   sudo pacman -Syu
   

2. 安装依赖 Ubuntu/Debian:

   sudo apt install -y curl git build-essential
   

   Fedora:

   sudo dnf install -y curl git gcc-c++ make
   

3. 执行安装

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

方法二：NVM 管理 Node.js

推荐使用 NVM 避免版本冲突：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
npm install -g openclaw

初始化配置

安装完成后，首次运行需要初始化：

openclaw onboard --install-daemon

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

1. 选择模型提供商：OpenAI、Anthropic、Ollama 等。
2. 配置 API Key：输入密钥并选择默认模型。
3. 设置工作目录：默认为 ~/openclaw。
4. 技能仓库：决定是否启用 ClawHub 社区技能。

测试运行：

openclaw ask "你好，请介绍一下你自己"

常见问题排查

Windows

• 执行策略错误：重新运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
• 找不到命令：重启终端，检查环境变量 PATH 是否包含 npm 全局路径。
• 安装慢：切换 npm 镜像源 https://registry.npmmirror.com

macOS / Linux

• 权限拒绝：使用 sudo npm install -g openclaw 或调整 npm 目录权限。
• 命令找不到：检查 Shell 配置文件（.zshrc 或 .bashrc），确保 PATH 正确。
• 依赖编译失败：安装编译工具链（如 build-essential 或 gcc-c++）。

进阶配置

本地模型支持

配置 Ollama 实现完全离线运行：

ollama pull llama2
openclaw config set model.provider ollama
openclaw config set model.url http://localhost:11434
openclaw config set model.name llama2

技能管理

通过 ClawHub 扩展能力：

# 搜索技能
openclaw skill search feishu
# 安装技能
openclaw skill install feishu-integration
# 列出已装
openclaw skill list

卸载

如需移除，请执行：

npm uninstall -g openclaw
rm -rf ~/openclaw ~/.openclaw

资源链接

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