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

type

status

date

slug

summary

🧭 一、核心流程总览

无论使用哪种安装方式，整体部署流程都遵循以下 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 一键安装

进入 「应用商店」，搜索 OpenClaw

点击 "安装"

5.2 配置参数

安装时需要填写以下关键参数：

参数	推荐值	说明
名称	`openclaw`	默认即可
版本	`latest`	选最新版本
端口	`18789`	WebUI 默认端口
模型提供商	按需选择	可选 DeepSeek、Qwen 等
API Key	你的 API Key	从对应平台获取
端口外部访问	✅ 勾选	必须勾选，否则无法访问后台

5.3 访问 Web 控制台

安装完成后，使用以下格式访问：

⚠️

OpenClaw 要求带 Token 访问，直接访问 IP:端口会被拒绝。建议将完整链接收藏到浏览器书签。

5.4 对接聊天软件（可选）

在 1Panel「已安装应用」中找到 OpenClaw → 进入安装目录 → 打开终端，执行：

按提示选择渠道（如 Telegram），填入对应 Bot Token 即可。

🔧 六、初始化配置（通用步骤）

以下步骤适用于 Windows 和 Linux 本地安装方式，1Panel 用户在安装向导中已完成大部分配置。

6.1 启动初始化向导

6.2 向导操作流程

安全提示：阅读后输入 Yes 继续

Onboarding 模式：选择 QuickStart（推荐新手），默认端口 18789

模型选择：以接入https://api.aigc.bar的codex为例，后续可更换

聊天渠道 / Skills / API Keys：全部选择 Skip for now，后续统一配置

6.3 ⚠️ 保存关键信息（必做）

向导结束时会显示以下信息，务必妥善保存：

Web UI 链接：http://127.0.0.1:18789/#token=你的专属token

Gateway WS：ws://127.0.0.1:18789

🔑

重要： 后续必须使用 带 token 的链接 打开控制台！否则会报 token_missing 或 too many failed authentication attempts 错误。忘记链接可执行 openclaw dashboard 自动打开。

🌐 七、接入第三方中转 API（以 AIGC Bar 为例）

在第二章中，我们已经在 AIGC Bar 注册并获取了 API 令牌。接下来只需将令牌填入 OpenClaw 配置文件，即可完成模型接入。

7.1 找到配置文件

操作系统	配置文件路径
Windows	`C:\Users\你的用户名\.openclaw\openclaw.json`
macOS / Linux	`~/.openclaw/openclaw.json`

7.2 修改配置文件

用编辑器打开 openclaw.json，将全部内容替换为以下模板：

7.3 配置说明

📝

需要修改的 4 处：

workspace：替换为你的实际路径（Windows 用双反斜杠 \\，Linux/macOS 用 /）

gateway.auth.token：填写 Onboard 向导中获得的专属 token

models.providers[0].config.apiKey：替换为你的 AIGC Bar API Key

models.defaults.completion 和 agents.defaults.model：按需调整默认模型

7.4 重启生效

保存配置文件后，重启网关服务：

7.5 适配其他中转平台

如果不使用 AIGC Bar，只需修改配置中的 2 处：

字段	说明	示例
`baseUrl`	替换为对应平台的 API 基础地址	`https://api.其他平台.com/v1`
`type`	根据平台支持的协议调整	`openai` / `anthropic` / `gemini`

⚙️ 八、网关配置（Windows / Linux 必做）

网关服务是 OpenClaw 的核心，负责连接聊天渠道、接收处理消息。必须启动网关后才能正常使用。

8.1 两种启动方式

方式	适用场景	操作
前台运行	快速试用	执行 `openclaw gateway`，保持终端窗口不关闭
守护进程（推荐）	长期使用、开机自启	以管理员身份执行 `openclaw gateway install` → `openclaw gateway start`

8.2 常见问题

🛠️

Gateway service install failed / schtasks create failed：未使用管理员权限，以管理员身份重新打开终端再执行

端口被占用：检查 18789 端口是否被其他程序占用，或在配置中更改端口

TUI 正常但 WebUI 报错：TUI 和 WebUI 使用独立认证，需在 URL 中带上 token 参数

🚀 九、功能全览：OpenClaw 能做什么？

配置完成后，OpenClaw 可作为全能私人助理：

场景	功能说明
💬 日常对话	在 Web 控制台或聊天软件中提问、查询、总结文章
💻 Shell 与编码	执行系统命令、编写并运行脚本（注意权限安全）
📧 邮件管理	配置 Gmail 后，查询/回复/筛选邮件
📅 日历提醒	创建会议、设置日程、查询日历
🌐 网页抓取	访问网页、抓取内容并保存
📁 文件操作	整理目录、批量重命名、按条件清理文件
🔧 技能扩展	安装社区技能或自建技能，实现定时任务、待办清单等
📱 远程控制	通过 Slack/Telegram 发送指令，远程操作服务器

📋 十、常用命令速查

基础操作

命令	说明
`openclaw --version`	查看当前版本
`openclaw onboard`	启动 / 重新运行初始化向导
`openclaw dashboard`	自动打开带 token 的 Web 控制面板
`openclaw configure`	修改核心配置（API Key、渠道等）
`openclaw update`	更新到最新版本
`openclaw doctor`	诊断系统环境，排查安装配置错误

网关管理

命令	说明
`openclaw gateway`	前台启动网关（窗口关闭则停止）
`openclaw gateway install`	安装网关守护进程（需管理员权限）
`openclaw gateway start`	启动网关守护进程
`openclaw status`	查看 Gateway 运行状态
`openclaw logs --follow`	查看实时运行日志
`openclaw daemon uninstall`	卸载后台守护进程

Hooks 与安全

命令	说明
`openclaw hooks list`	查看已安装的 Hooks
`openclaw hooks enable <名称>`	启用指定 Hook
`openclaw hooks disable <名称>`	禁用指定 Hook
`openclaw security audit --deep`	深度安全审计

🗺️ 十一、快速上手路线图

🦞

10 分钟快速部署路线：

✅ 前往 AIGC Bar 注册账号，获取 API 令牌

✅ 安装 Node.js 22+

✅ 安装 OpenClaw：npm install -g openclaw（或使用官方脚本 / 1Panel）

✅ 初始化：openclaw onboard → 选择 QuickStart → 保存 token

✅ 编辑 openclaw.json，填入 AIGC Bar 的 API Key 和 baseUrl

✅ 启动网关：openclaw gateway 或 openclaw gateway start

✅ 打开控制台：openclaw dashboard，开始与 AI 助手对话！

⚠️ 十二、注意事项汇总

安全相关

OpenClaw 仍处于 Beta 阶段，请勿在生产环境中处理敏感数据

切勿在公开平台粘贴 真实 token 或 API Key

定期执行 openclaw security audit --deep 检查安全隐患

启用工具权限时遵循 最小权限原则

系统兼容性

Windows：原生环境偶有兼容问题，官方推荐搭配 WSL2 使用

Linux：安装最顺畅，推荐作为服务器部署首选

1Panel：最适合不熟悉命令行的用户，一键搞定

日常使用

守护进程方式（推荐长期使用）：开机自动启动，执行 openclaw status 确认状态

前台运行方式：每次使用前手动执行 openclaw gateway，不要关闭终端窗口

Gateway 守护进程需 管理员权限 安装，普通权限可使用前台运行

忘记 token 时执行 openclaw dashboard 可自动打开带认证的控制台