OpenClaw 完整部署图文教程:三平台安装 + 第三方中转 API站点接入指南(含图文指导)
type
status
date
slug
summary
tags
category
icon
password
网址
OpenClaw 是一款开源 AI 个人助手,可部署在个人设备或服务器上,通过 Slack、Telegram、WhatsApp、Discord 等聊天应用或 Web 控制面板交互。它能实现邮件处理、日历管理、代码编写、智能家居控制、网页数据抓取等功能,堪称 24 小时在线的私人 AI 打工人。

本文将从零开始,详解 Windows、Linux、1Panel 面板三种安装方式,以及如何接入国内推荐的中转 API 站点 AIGC Bar,帮你快速上手这款开源 AI 助手。无论你想使用 GPT-5.4、Claude 还是 Gemini,通过 AIGC Bar 都能一站搞定模型接入。
🧭 一、核心流程总览
无论使用哪种安装方式,整体部署流程都遵循以下 5 步:
- 前置准备:确认环境要求,并在 AIGC Bar 注册获取 API 令牌
- 安装环境依赖(Node.js、Git 等)
- 安装 OpenClaw 核心程序
- 运行初始化向导(
openclaw onboard),完成基础配置
- 接入 API 站点,将令牌填入配置文件完成模型调用
核心依赖: Node.js ≥ 22.12.0 + AIGC Bar API 令牌。请提前完成环境安装和令牌获取,详见下一章节。
📋 二、前置准备:环境要求与 API 站点配置
在开始安装 OpenClaw 之前,请先完成以下两步准备工作:确认系统环境满足要求,并在 API 站点注册账号获取令牌。
2.1 通用环境要求
依赖项 | 最低版本 | 说明 |
Node.js | ≥ 22.12.0 | JavaScript 运行环境,从 Node.js 官网 下载 LTS 稳定版 |
npm | ≥ 10 | 随 Node.js 一同安装 |
网络连接 | — | 需访问 API 站点及 npm 仓库 |
终端 / 命令行工具 | — | Windows 用 PowerShell,Linux / macOS 用 Terminal |
2.2 🔑 API 站点注册与令牌获取
OpenClaw 需要接入 AI 模型才能工作。国内用户推荐使用 AIGC Bar 作为中转 API 站点,支持 OpenAI、Anthropic、Gemini 等主流模型协议,稳定可靠。
国内 OpenClaw 推荐 API 站点:api.aigc.bar
支持 GPT-5.4、Claude、Gemini 等主流模型,注册即用,是国内部署 OpenClaw 的首选方案。
注册并获取 API 令牌
以接入 Codex 中最新模型 GPT-5.4 为例,访问 api.aigc.bar 注册账号后,按以下步骤操作:
- 点击 「控制台」 → 进入 「API 令牌」 页面

- 点击 「添加令牌」

- 令牌分组请选择:
openai codex专用(若需使用 Claude 模型,可选择Claudecode 分组)

- 令牌名称随意填写
- 额度建议:设置为无限额度
- 其他选项保持默认,点击 「提交」
- 复制令牌密钥,妥善保存,后续配置步骤需要使用

提示: 请务必在安装前完成 API 令牌的获取,后续初始化向导和配置文件编辑都需要用到此令牌。
💻 三、方式一:Windows 安装
3.1 环境准备
Windows 环境需要额外安装以下工具:
工具 | 作用 | 安装方式 |
Node.js ≥ 22 | JavaScript 运行环境 | winget install OpenJS.NodeJS.LTS 或官网下载 |
Git | 依赖仓库拉取 | winget install Git.Git |
CMake | C++ 构建工具 | winget install Kitware.CMake |
VS Build Tools | C++ 编译工具链 | winget install Microsoft.VisualStudio.2022.BuildTools,勾选 Desktop development with C++ |
安装完成后,打开 管理员 PowerShell,验证环境:
3.2 安装 OpenClaw
方式 A:官方脚本安装(推荐)

方式 B:npm 全局安装
常见报错处理:
- 脚本禁止运行(PSSecurityException):执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force后重试
- npm error code 128:网络波动导致,多执行几次安装命令
- node-gyp 编译失败:检查是否安装了 Visual Studio Build Tools 的 C++ 工作负载
3.3 验证安装
🐧 四、方式二:Linux 安装
4.1 环境准备
4.2 安装 OpenClaw
方式 A:官方脚本安装(推荐)
方式 B:npm 全局安装
方式 C:源码安装(适合进阶用户)
4.3 验证安装
提示: Linux 环境安装成功率通常更高,官方也推荐 Linux 作为首选部署环境。Windows 用户如遇兼容问题,可考虑使用 WSL2(
wsl --install)。🖥️ 五、方式三:1Panel 面板安装(适合服务器用户)
1Panel 是一款现代化的 Linux 服务器运维面板,支持一键安装 OpenClaw,无需手写 Docker Compose 文件,新手友好。
5.1 一键安装
- 登录 1Panel 面板
- 进入 「应用商店」,搜索
OpenClaw
- 点击 "安装"

5.2 配置参数
安装时需要填写以下关键参数:
参数 | 推荐值 | 说明 |
名称 | openclaw | 默认即可 |
版本 | latest | 选最新版本 |
端口 | 18789 | WebUI 默认端口 |
模型提供商 | 按需选择 | 可选 DeepSeek、Qwen 等 |
API Key | 你的 API Key | 从对应平台获取 |
端口外部访问 | ✅ 勾选 | 必须勾选,否则无法访问后台 |
Loading...
.png?table=collection&id=cbe6506e-1263-8358-a4d7-07ce62fcbb3f&t=cbe6506e-1263-8358-a4d7-07ce62fcbb3f)