## 1. 概述

一键部署脚本是我自己编写的自动化安装工具，可以帮助新手快速完成 OpenClaw 的完整部署。脚本会自动检测操作系统、安装必要的依赖、配置 GPUNexus 模型，并生成配置文件。

**为什么使用一键部署脚本？**

- **简单快捷**：一行命令完成全部部署流程
- **自动检测**：智能识别操作系统，自动选择合适的安装方式
- **依赖完备**：自动安装 Node.js 及编译所需的系统依赖
- **配置完善**：自动生成配置文件，支持多种模型选择

**前置要求：**

- 拥有一个 GPUNexus 平台的 API Key
- 能够执行 Shell 脚本（Linux/macOS/WSL）或 PowerShell 脚本（Windows）

---

## 2. 快速开始

### 2.1 Linux/macOS/WSL 用户

```bash
# 方式一：交互模式（推荐）
curl -fsSL https://raw.githubusercontent.com/mengbin92/openclaw/main/scripts/install-openclaw.sh | bash

# 方式二：使用参数直接部署
curl -fsSL https://raw.githubusercontent.com/mengbin92/openclaw/main/scripts/install-openclaw.sh | bash -s -- -k "sk-xxxxxxxxxxxxx" -m 2
```

**或者下载脚本到本地执行：**

```bash
# 下载脚本
curl -fsSL -o install-openclaw.sh https://raw.githubusercontent.com/mengbin92/openclaw/main/scripts/install-openclaw.sh

# 添加执行权限
chmod +x install-openclaw.sh

# 运行脚本
./install-openclaw.sh
```

### 2.2 Windows 用户

```powershell
# 方式一：下载脚本到本地执行
# 1. 访问 https://raw.githubusercontent.com/mengbin92/openclaw/main/scripts/install-openclaw.ps1
# 2. 保存为 install-openclaw.ps1
# 3. 以管理员身份打开 PowerShell

# 运行脚本
.\install-openclaw.ps1

# 方式二：使用参数直接部署
.\install-openclaw.ps1 -ApiKey "sk-xxxxxxxxxxxxx" -ModelChoice 2
```

> **注意：** Windows 用户需要先安装 Node.js（https://nodejs.org）和 Git（https://git-scm.com）。如果未安装，脚本会尝试通过 Chocolatey 自动安装。

---

## 3. 脚本功能

### 3.1 支持的操作系统

| 脚本 | 支持的系统 |
| ---- | ---------- |
| `install-openclaw.sh` | macOS、Linux (Ubuntu/Debian、CentOS/RHEL、Arch)、WSL、Git Bash |
| `install-openclaw.ps1` | Windows 10/11 |

**Linux 发行版支持：**

- **Debian 系列**：Ubuntu、Debian、Linux Mint、Pop!_OS
- **RHEL 系列**：CentOS、RHEL、Fedora、Rocky Linux、AlmaLinux
- **Arch 系列**：Arch Linux、Manjaro、EndeavourOS

### 3.2 自动安装内容

脚本会自动完成以下内容的安装和配置：

1. **系统依赖**
   - build-essential、cmake、gcc、g++、make（Linux 编译依赖）
   - git、jq、curl、python3

2. **Node.js**
   - 自动检测 Node.js 是否已安装
   - 未安装时自动安装 LTS 版本
   - 支持通过 nvm 管理 Node.js 版本

3. **OpenClaw**
   - 全局安装 `openclaw` npm 包
   - 自动配置 npm 镜像源（使用 npmmirror）
   - 配置 Git 使用 HTTPS 协议（解决 SSH 密钥问题）

4. **配置文件**
   - 自动生成 `~/.openclaw/openclaw.json`
   - 自动配置 GPUNexus 模型提供方
   - 自动设置默认模型

### 3.3 支持的模型

| 序号 | 模型名称 | API 接口 | 说明 |
| ---- | -------- | -------- | ---- |
| 1 | MiniMax-M2.1 | OpenAI 兼容接口 | 使用 OpenAI 格式调用 |
| 2 | GPUNexus | Claude Code 接口 | 使用 Anthropic 消息格式 |

---

## 4. 命令行参数

### 4.1 Bash 脚本参数

```bash
用法: ./install-openclaw.sh [选项]

选项:
    -k, --api-key <key>     GPUNexus API Key（必填）
    -m, --model <model>     选择模型: 1=MiniMax-M2.1, 2=GPUNexus（默认: 2）
    -h, --help              显示帮助信息

示例:
    ./install-openclaw.sh -k sk-xxxxxxxxxxxxx -m 1
    ./install-openclaw.sh --api-key sk-xxxxxxxxxxxxx
```

### 4.2 PowerShell 脚本参数

```powershell
用法: .\install-openclaw.ps1 [-ApiKey <string>] [-ModelChoice <int>]

参数:
    -ApiKey        GPUNexus API Key（必填）
    -ModelChoice   选择模型: 1=MiniMax-M2.1, 2=GPUNexus（默认: 2）

示例:
    .\install-openclaw.ps1 -ApiKey "sk-xxxxxxxxxxxxx" -ModelChoice 1
    .\install-openclaw.ps1 -ApiKey "sk-xxxxxxxxxxxxx"
```

---

## 5. 交互模式

如果不使用命令行参数，脚本会以交互模式运行，引导用户完成配置。

### 5.1 输入 API Key

```
============================================
         OpenClaw 一键部署脚本
============================================

[INFO] 检测到操作系统: macos

[INFO] 请输入您的 GPUNexus API Key
[INFO] 获取方式: 访问 https://gpunexus.com 注册并创建 API Key
API Key: sk-xxxxxxxxxxxxx
```

> **提示：** API Key 相当于您的账号密码，请勿泄露。

### 5.2 选择模型

```
[INFO] 请选择要使用的模型:
  1. MiniMax-M2.1 (OpenAI兼容接口)
  2. GPUNexus (Claude Code接口)
请选择 [1/2]: 2
[INFO] 已选择模型: GPUNexus
```

---

## 6. 部署步骤详解

### 6.1 步骤一：环境检测与 Node.js 安装

脚本首先检测操作系统类型，然后检查 Node.js 是否已安装。

**检测结果示例：**

```
[INFO] 检测操作系统: macos
[INFO] Node.js 已安装: v20.11.0
```

**如果 Node.js 未安装：**

- **macOS**：使用 Homebrew 安装
- **Linux Debian 系列**：使用 apt-get 或 NodeSource
- **Linux RHEL 系列**：使用 yum 或 NodeSource
- **Linux Arch 系列**：使用 pacman

### 6.2 步骤二：安装 OpenClaw

```
>>> 步骤 2/4: 安装 OpenClaw

[INFO] 已设置 npm 镜像源: https://registry.npmmirror.com/
[INFO] 配置 npm 使用 HTTPS 协议克隆 git 依赖...
[SUCCESS] OpenClaw 安装成功
```

### 6.3 步骤三：创建配置文件

```
>>> 步骤 3/4: 创建配置文件

[INFO] 正在运行 openclaw setup...
[INFO] 正在更新配置文件...
[SUCCESS] 配置文件已更新: /Users/username/.openclaw/openclaw.json
```

### 6.4 步骤四：初始化配置

```
>>> 步骤 4/4: 启动服务

[SUCCESS] 部署完成!

============================================

[INFO] 配置文件位置: /Users/username/.openclaw/openclaw.json
[INFO] 访问地址: http://127.0.0.1:18789/
[INFO] Token: 查看配置文件中的 gateway.auth.token 字段

[WARNING] 即将运行 openclaw onboard 进行初始化配置...
[INFO] 提示: onboard 会重置并重新配置服务，按 Ctrl+C 可中断
```

---

## 7. 验证部署

### 7.1 查看配置文件

部署完成后，配置文件位于 `~/.openclaw/openclaw.json`。

**查看配置：**

```bash
# Linux/macOS
cat ~/.openclaw/openclaw.json

# Windows
type %USERPROFILE%\.openclaw\openclaw.json
```

**关键配置项：**

| 字段 | 说明 |
| ---- | ---- |
| `models.providers` | 模型提供方配置 |
| `agents.defaults.model.primary` | 默认使用的模型 |
| `gateway.port` | 服务端口（默认 18789） |
| `gateway.auth.token` | 访问令牌 |

### 7.2 启动服务

```bash
# 启动服务
openclaw start

# 查看服务状态
openclaw status

# 重启服务
openclaw restart
```

### 7.3 访问 WebUI

服务启动后，在浏览器中访问：

```
http://127.0.0.1:18789/?token=YOUR_TOKEN
```

> **注意：** 将 `YOUR_TOKEN` 替换为配置文件中的 `gateway.auth.token` 值。

---

## 8. 常见问题

### Q1: 脚本执行失败怎么办？

1. 确认网络连接正常
2. 检查是否有足够的磁盘空间
3. Linux 用户确保有 sudo 权限
4. 查看终端输出的错误信息

### Q2: Node.js 安装失败怎么办？

**macOS 用户：**

```bash
# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 使用 Homebrew 安装 Node.js
brew install node
```

**Linux 用户：**

```bash
# 手动安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
```

### Q3: 安装过程中断如何恢复？

```bash
# 重新运行脚本即可，脚本会自动检测已安装的组件并跳过
./install-openclaw.sh
```

### Q4: 如何更新 API Key？

直接编辑配置文件中的 `apiKey` 字段，然后重启服务：

```bash
# 编辑配置
nano ~/.openclaw/openclaw.json

# 重启服务
openclaw restart
```

### Q5: 内存不足导致安装失败？

Linux 脚本会自动检测内存情况，如果内存小于 2GB 且 swap 小于 2GB，会自动添加 4GB swap 空间。

如需手动添加：

```bash
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
```

### Q6: Windows PowerShell 无法运行脚本？

1. 确保以管理员身份运行 PowerShell
2. 检查是否启用了脚本执行策略：

```powershell
# 查看执行策略
Get-ExecutionPolicy

# 如果受限，设置为允许
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

### Q7: 如何卸载 OpenClaw？

```bash
# 卸载 npm 包
npm uninstall -g openclaw

# 删除配置文件（可选）
rm -rf ~/.openclaw
```

---

## 附录：完整配置示例

```json
{
  "meta": {
    "lastTouchedVersion": "2026.2.1",
    "lastTouchedAt": "2026-03-09T00:00:00.000Z"
  },
  "models": {
    "providers": {
      "GPUNexus": {
        "baseUrl": "https://coding.gpunexus.com",
        "apiKey": "sk-xxxxxxxxxxxxx",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "GPUNexus",
            "name": "GPUNexus"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "GPUNexus/GPUNexus"
      },
      "models": {
        "GPUNexus/GPUNexus": {}
      },
      "workspace": "/Users/username/.openclaw/workspace"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "your-token-here"
    }
  }
}
```

---


一键部署脚本是我自己编写的自动化安装工具，可以帮助新手快速完成 OpenClaw 的完整部署。脚本会自动检测操作系统、安装必要的依赖、配置 GPUNexus 模型，并生成配置文件。

OpenClaw 本地一键部署指南

人工智能

一键部署脚本快速安装OpenClaw，自动检测系统、安装依赖、配置GPUNexus模型。支持Linux/macOS/WSL/Windows，提供交互模式和命令行参数，简化部署流程。包含Node.js自动安装、配置文件生成、多模型选择功能，适合新手快速搭建AI开发环境。

智能识别

Windows

Manjaro

Pop!_OS

CentOS

Ubuntu

Fedora

Debian

Linux

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw 本地一键部署指南-腾讯云开发者社区-腾讯云

OpenClaw 本地一键部署指南

OpenClaw 本地一键部署指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐