OpenClaw 完整部署图文教程:三平台安装 + 第三方中转 API站点接入指南(含图文指导)

type
status
date
slug
summary
tags
category
icon
password
网址
OpenClaw 是一款开源 AI 个人助手,可部署在个人设备或服务器上,通过 Slack、Telegram、WhatsApp、Discord 等聊天应用或 Web 控制面板交互。它能实现邮件处理、日历管理、代码编写、智能家居控制、网页数据抓取等功能,堪称 24 小时在线的私人 AI 打工人
notion image
本文将从零开始,详解 Windows、Linux、1Panel 面板三种安装方式,以及如何接入国内推荐的中转 API 站点 AIGC Bar,帮你快速上手这款开源 AI 助手。无论你想使用 GPT-5.4、Claude 还是 Gemini,通过 AIGC Bar 都能一站搞定模型接入。

🧭 一、核心流程总览

无论使用哪种安装方式,整体部署流程都遵循以下 5 步
  1. 前置准备:确认环境要求,并在 AIGC Bar 注册获取 API 令牌
  1. 安装环境依赖(Node.js、Git 等)
  1. 安装 OpenClaw 核心程序
  1. 运行初始化向导openclaw onboard),完成基础配置
  1. 接入 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 注册账号后,按以下步骤操作:
  1. 点击 「控制台」 → 进入 「API 令牌」 页面
notion image
  1. 点击 「添加令牌」
notion image
  1. 令牌分组请选择:openai codex专用(若需使用 Claude 模型,可选择 Claudecode 分组
notion image
  1. 令牌名称随意填写
  1. 额度建议:设置为无限额度
  1. 其他选项保持默认,点击 「提交」
  1. 复制令牌密钥,妥善保存,后续配置步骤需要使用
notion image
⚠️
提示: 请务必在安装前完成 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:官方脚本安装(推荐)
notion image
方式 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 一键安装

  1. 登录 1Panel 面板
  1. 进入 「应用商店」,搜索 OpenClaw
  1. 点击 "安装"
notion image

5.2 配置参数

安装时需要填写以下关键参数:
参数
推荐值
说明
名称
openclaw
默认即可
版本
latest
选最新版本
端口
18789
WebUI 默认端口
模型提供商
按需选择
可选 DeepSeek、Qwen 等
API Key
你的 API Key
从对应平台获取
端口外部访问
✅ 勾选
必须勾选,否则无法访问后台
Loading...

没有找到文章