一、部署准备

在开始安装前，请确保您已准备好以下三项核心要素：

1. 一台运行设备

   1. 推荐配置：CPU 双核以上，内存 4GB 以上，确保网络连接稳定。

   2. 可选设备：您的主力电脑（Mac/Linux/Windows）、云服务器（VPS）或家用服务器。

2. 一个AI模型账号

   1. 用途：作为OpenClaw的“大脑”，提供AI能力支持。

   2. 获取方式：您需要一个主流大模型的API Key，例如DeepSeek、文心一言、讯飞星火、豆包等。

   3. 操作步骤：访问对应模型的官方网站，注册账号后，在控制台中创建并获取您的API Key。

3. 一个通讯软件账号

   1. 用途：作为您与OpenClaw交互的渠道。

   2. 推荐选择：推荐从QQ开始，因其对机器人（Bot）的支持最完善，配置最简单。

   3. 准备工作：提前准备一个QQ账号作为机器人账号。

二、硬件方案选择

您可以根据自身需求和条件，选择以下三种硬件方案之一：

方案	优点	缺点	适用场景
主力电脑	零硬件成本，即装即用。	电脑休眠或关机时，助手会离线，无法提供全天候服务。	初期体验测试
云服务器(VPS)	24小时在线，永不掉线，安全可靠，可在任何地方访问。	每月需支付几十元的费用（如阿里云、腾讯云、华为云等）。	长期稳定使用（推荐）
家用服务器	数据完全留在您家中，隐私性最强，且可实现24小时运行。	需要前期硬件投入（如Mac Mini、树莓派或旧电脑）。	进阶用户，追求极致隐私

重要安全警示：OpenClaw功能强大，能读写文件、执行系统命令。官方强烈建议将其部署在专用服务器或闲置电脑上，而非您的主力设备，以隔离潜在风险。

三、实战部署

3.1 Mac系统安装指南

Mac平台因系统集成度高，是OpenClaw的最优运行环境。

1. 打开终端

   1. 按 Command + 空格 打开Spotlight搜索。

   2. 输入“Terminal”或“终端”，按回车启动。

2. 执行安装命令

在终端中输入以下一键安装脚本，自动完成环境检测、Node.js安装、OpenClaw下载与配置（预计2-5分钟）：

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

若提示权限不足，使用sudo提升权限：

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

1. 验证安装结果

安装完成后，输入以下命令验证版本，显示版本号（如2026.2.9）则说明安装成功：

openclaw --version

注意事项：如果是Apple Silicon芯片（M1/M2/M3）的Mac，终端会自动使用Rosetta 2运行，无需额外操作。

常见问题：如果安装后提示“command not found”，可能是环境变量未生效，尝试重启终端或重新登录。

3.2 Linux系统安装指南 (Ubuntu/Debian)

Linux是服务器部署的首选，稳定高效。

1. 安装Node.js

   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs

     检查node版本，验证是否安装成功：

   node --version

2. 安装OpenClaw

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

3. 验证安装

   openclaw --version

注意事项：确保系统已更新到最新版本，可以先执行 sudo apt update && sudo apt upgrade。

常见问题：如果执行安装脚本时提示网络连接失败，通常是网络问题，可以尝试更换网络环境或使用代理。

3.3 Windows系统安装指南

方案一：基于WSL的Ubuntu安装：

此方法通过在Windows中运行一个完整的Ubuntu Linux子系统来安装OpenClaw，能最大程度避免环境冲突。

安装WSL2：以管理员身份打开PowerShell，运行以下命令后重启电脑：

• 安装WSL2：以管理员身份打开PowerShell，运行以下命令后重启电脑：

wsl --install

• 启动Ubuntu并更新：重启后，从“开始”菜单启动Ubuntu。首次启动需要设置用户名和密码。进入Ubuntu终端后，先更新软件包：

sudo apt update && sudo apt upgrade -y

• 安装Node.js：在Ubuntu终端中执行以下命令安装Node.js 22。

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs

• 安装OpenClaw：继续在Ubuntu终端中运行官方安装脚本。

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

方案二：基于Windows的原生安装：

方式1：一键安装（简单）

以管理员权限启动PowerShell，执行以下命令即可完成自动部署：

iwr -useb https://openclaw.ai/install.ps1 | iex

解决权限问题：

Set-ExecutionPolicy -ExecutionPolicy Remotesigned -ScopeCurrentUser

方式2：手动安装（推荐）

如果一键安装失败，可以尝试手动安装：

1. 安装Node.js

   1. 前往Node.js官网下载≥22.0.0版本的安装包。

   2. 双击运行安装包，务必勾选“Add to PATH”选项，然后按照向导完成安装。

   3. 打开命令行，输入 node -v 验证安装成功。

2. 安装Git

   1. 前往Git官网下载安装包。

   2. 双击运行安装包，按照向导完成安装（建议选择默认选项）。

   3. 打开命令行，输入 git -v 验证安装成功。

3. 安装OpenClaw

在命令行中执行：

npm install -g openclaw@latest

检查node版本;

openclaw --version

常见问题：

（1）如果提示“npm不是内部或外部命令”，说明Node.js的环境变量未配置成功，需要手动将Node.js的安装目录添加到系统的PATH环境变量中。

（2）提示Git权限SSH秘钥存在问题

#方法一:配置Gt 全局替换 
git config --global url."https://github.com/".insteadof git@github.com: 
#方法二:使用NPM 强制HTTPS 协议 
npm config set git-protocol https 
#方法三:直接安装HTTPS版本 
npm install -g openclaw@latest --registry-https://registry.npmmirror.com/

（3）提高下载速度，切换国内镜像源

# 查看当前镜像源 
npm config get registry 
# 设置为淘宝镜像 
npm config set registry https://registry.npmmirror.com 
# 恢复为官方源 
npm config set registry https://registry.npmjs.org 
# 切换后建议清除旧缓存 
npm cache clean --force

1. 创建OpenClaw项目

在命令行中执行：

openclaw onboard --install-daemon

整个流程可分为以下关键步骤，每个环节均需按顺序操作以确保配置正确：

• （1）风险提示确认：界面将显示“OpenClaw具有系统访问权限，存在一定风险”，选择“Yes”继续；

• （2）启动模式选择：推荐选择“QuickStart”（快速启动，后续可通过配置文件调整细节），新手不建议选择“Manual”（手动配置难度较高）；

• （3）AI模型选择：支持国内外多个模型提供商，国内用户推荐选择以下三者之一（性价比高、国内访问稳定）：

  • Moonshot AI（Kimi）：长文本处理专家，支持200万字上下文，适合论文/长文档分析；

  • DeepSeek：性价比之王，输入0.001元/千tokens，推理能力强，适合日常任务；

  • 智谱GLM（Z.AI）：中文理解能力出色，多模态支持完善，适合中文场景；

  • API Key输入：根据所选模型，粘贴提前准备的API Key（格式为sk-xxx，需完整复制，不含多余空格）；

  • 若暂时未获取API Key，可选择“Skip for now”，后续通过openclaw models auth add补充配置；

• （4）聊天平台选择：推荐国内用户选择“Feishu”（飞书），国际用户选择“Telegram”，暂时不接入可选择“None”（后续可通过openclaw channels add 配置）；

• （5）Gateway端口设置：默认端口为18789，若该端口被占用（如其他服务正在使用），可修改为18790等未占用端口，直接回车使用默认值即可；

• （6）Skills选择：使用空格键勾选所需技能（新手推荐勾选“file-search”、“calendar-sync”、“web-clipper”三大核心技能），或选择“Skip for now”（后续通过ClawHub 安装）；

• 额外API Key配置：部分Skills需单独配置 API Key（如Google Places），无相关需求可选择“No”跳过；

• （7）Hooks启用：推荐启用“boot-md”（内容引导）、“command-logger”（命令日志）、“session-memory”（会话记忆）三个核心钩子，提升使用体验；

• 配置完成：系统将自动启动Gateway服务，并打开Web UI（http://127.0.0.1:18789/chat），配置文件自动保存至～/.openclaw/openclaw.json。