OpenClaw Windows 安装与第三方API UniVibe 接入指南

OpenClaw是一款开源的本地 AI 助手，运行在你自己的电脑上，可通过文件操作终端命令执行浏览器控制自动化任务编排至此，你已完成 OpenClaw 在 Windows 的安装，并成功接入 UniVibe 模型服务。推荐从Web UI，后续再按需接入 Telegram/Discord 等通道与技能扩展。

取个鸣字真的难

580人浏览 · 2026-03-04 14:58:22

取个鸣字真的难 · 2026-03-04 14:58:22 发布

OpenClaw Windows 安装与第三方API UniVibe 接入指南

本指南将带你在 Windows 上安装并配置 OpenClaw，并接入 UniVibe 模型服务（可在 Claude Code、Codex、Cursor、OpenClaw 等多款官方工具客户端间通用）。

注册地址：https://www.univibe.cc/console/auth?type=register&invite=MB8LFU
白嫖6000积分

什么是 OpenClaw？

OpenClaw 是一款开源的本地 AI 助手，运行在你自己的电脑上，可通过 Web UI、Telegram、WhatsApp、Discord 等多种方式交互，并支持：

文件操作
终端命令执行
浏览器控制
自动化任务编排

前置要求

Windows 10 或更高版本
Node.js 环境（22 或更高版本）
有效的 UniVibe API 密钥

安装步骤

1）安装 Node.js（22+）

OpenClaw 需要 Node.js 22 或更高版本。

方法一：官网下载（推荐）

访问：https://nodejs.org/
点击 LTS 下载（确保版本 ≥ 22）
运行 .msi 安装包
按向导完成安装（默认选项即可）

方法二：使用 winget

如果你已安装 winget，可直接执行：

winget install OpenJS.NodeJS.LTS

验证 Node.js 是否安装成功

打开 PowerShell 或 CMD，执行：

node --version
npm --version

若 node 版本 ≥ 22，则安装成功。

2）安装 OpenClaw

在 PowerShell 或 CMD 运行：

npm install -g openclaw

验证 OpenClaw 是否安装成功

openclaw --version

✅ 能看到版本号表示安装成功。

提示

如果提示找不到命令：尝试重新打开 PowerShell

某些情况下需要以管理员身份运行

3）获取 UniVibe API 密钥

4）运行安装向导（推荐）

首次使用建议运行向导：

openclaw onboard --install-daemon

向导配置项建议选择

步骤	建议选择
Risk 确认	`yes`
Onboarding mode	`QuickStart`
Model/auth provider	`Skip for now`（稍后手动配置 UniVibe）
Filter models by provider	`All providers`
Default model	`Keep current`
Select channel	`Skip for now`
Configure skills	`Yes`（启用本地技能）
Preferred node manager	`npm`
Install missing skill dependencies	`Skip for now`
各种 API Key 设置	没有就选 `No/Skip`
Gateway service	`Install/Reinstall`
How to hatch your bot	`Hatch in TUI`

向导完成后

OpenClaw 会启动 Gateway，并打开 Web 控制页面
默认访问地址：

http://127.0.0.1:18789

如果没有自动打开，请手动用浏览器访问上述地址。
向导会创建配置文件，后续可修改以接入 UniVibe。

5）配置 UniVibe 服务

OpenClaw 使用 JSON 配置文件：

%USERPROFILE%\.openclaw\openclaw.json

你可以 修改配置文件 或用 GUI 配置。

方式一：修改配置文件

用记事本：

notepad %USERPROFILE%\.openclaw\openclaw.json

或用 VS Code：

code %USERPROFILE%\.openclaw\openclaw.json

最小配置（添加或修改 agents + models）

⚠️ 如果配置文件里已有 gateway/skills/wizard 等内容，请保留，只需要合并新增/修改 agents 和 models。

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "univibe/gpt-5.2"
      }
    }
  },
  "models": {
    "providers": {
      "univibe": {
        "baseUrl": "https://api.univibe.cc/openai/v1",
        "apiKey": "你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.2", "name": "GPT-5.2" },
          { "id": "gpt-5.3-codex", "name": "GPT-5.3 Codex" },
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" },
          { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" }
        ]
      }
    }
  }
}

✅ 记得把 "你的API密钥" 替换成你在 UniVibe 控制台创建的真实密钥。

完整配置示例（可直接参考）

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "univibe/gpt-5.2"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "compaction": {
        "mode": "safeguard"
      }
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "bind": "loopback"
  },
  "models": {
    "providers": {
      "univibe": {
        "baseUrl": "https://api.univibe.cc/openai/v1",
        "apiKey": "你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.2", "name": "GPT-5.2" },
          { "id": "gpt-5.3-codex", "name": "GPT-5.3 Codex" },
          { "id": "gpt-5.1-codex-max", "name": "GPT-5.1 Codex Max" },
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" },
          { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
          { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5" },
          { "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5" },
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" }
        ]
      }
    }
  }
}

方式二：GUI 界面配置

打开浏览器访问：
- http://127.0.0.1:18789
进入：Config → Models → Providers
添加如下配置：

配置项	值
Api	`openai-completions`
Api Key	你的 UniVibe API 密钥
Base Url	`https://api.univibe.cc/openai/v1`
models - id	模型 ID（如 `gpt-5.2`）
models - name	显示名称（如 `GPT-5.2`）

保存后立即生效。

6）字段说明速查

字段	说明
`agents.defaults.model.primary`	默认模型，格式：`provider/模型id`
`models.providers`	自定义模型提供商集合
`baseUrl`	UniVibe API 地址：`https://api.univibe.cc/openai/v1`
`apiKey`	UniVibe API 密钥
`api`	API 类型：`openai-completions`
`models`	模型列表（`id` + `name`）

7）启动服务

配置完成后启动 Gateway：

openclaw gateway start

8）开始使用

方式一：Web UI（推荐）

openclaw dashboard

浏览器会打开：

http://127.0.0.1:18789/

直接在网页聊天窗口对话即可。

方式二：Telegram Bot（可选）

Telegram 搜索 @BotFather
发送 /newbot 创建机器人
获取 Bot Token
在 openclaw onboard 时输入 Token

9）可用模型（UniVibe）

GPT 系列

模型 ID	名称	适用场景
gpt-5.2	GPT-5.2	通用高性能，推荐默认
gpt-5.3-codex	GPT-5.3 Codex	最新编程模型，复杂重构首选
gpt-5.2-codex	GPT-5.2 Codex	稳定编程模型
gpt-5.1-codex-max	GPT-5.1 Codex Max	大上下文编程
gpt-5.1-codex	GPT-5.1 Codex	通用编程
gpt-5.1-codex-mini	GPT-5.1 Codex Mini	轻量编程
gpt-5.1	GPT-5.1	通用模型
gpt-5	GPT-5	基础模型
gpt-5-codex	GPT-5 Codex	基础编程

Claude 系列

模型 ID	名称	适用场景
claude-opus-4-6	Claude Opus 4.6	最强推理，复杂任务首选
claude-sonnet-4-5-20250929	Claude Sonnet 4.5	均衡性能，日常开发
claude-opus-4-5-20251101	Claude Opus 4.5	高性能推理
claude-haiku-4-5-20251001	Claude Haiku 4.5	快速响应，简单任务

Gemini 系列

模型 ID	名称	适用场景
gemini-3-pro-preview	Gemini 3 Pro	顶级性能，前端开发
gemini-3-flash-preview	Gemini 3 Flash	性价比首选

10）切换模型

在聊天窗口输入：

/model univibe/claude-opus-4-6

或者修改配置文件：

agents.defaults.model.primary

常用命令速查

终端命令

命令	功能
openclaw onboard	运行安装向导
openclaw gateway start	启动 Gateway
openclaw gateway restart	重启 Gateway
openclaw gateway stop	停止 Gateway
openclaw status	查看运行状态
openclaw doctor	诊断问题
openclaw doctor --fix	自动修复
openclaw dashboard	打开 Web 面板
openclaw logs --follow	实时日志
openclaw configure	修改配置
openclaw update	更新到最新版本

聊天命令

命令	功能
/help	显示帮助
/new	新对话
/reset	重置对话
/stop	停止当前任务
/model `<id>`	切换模型
/status	查看状态
/skills	查看技能

Windows 常见问题解决

1）安装提示权限错误

以管理员身份运行 PowerShell：

右键 PowerShell 图标
选择 “以管理员身份运行”
重新执行安装命令

2）找不到配置文件目录

explorer %USERPROFILE%\.openclaw

3）Gateway 启动失败（端口被占用）

检查 18789 端口占用：

netstat -ano | findstr "18789"

若被占用，可在配置文件中修改：

gateway.port

4）Node.js 版本过低

检查版本：

node --version

若低于 22，请重新安装 Node.js 最新 LTS。

5）防火墙阻止连接

如果 Windows 防火墙弹窗提示：

选择 “允许访问”
或
手动添加防火墙规则放行 OpenClaw/Gateway

结语

至此，你已完成 OpenClaw 在 Windows 的安装，并成功接入 UniVibe 模型服务。
推荐从 Web UI 开始体验：openclaw dashboard，后续再按需接入 Telegram/Discord 等通道与技能扩展。

龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

OpenClaw+GLM-4.7-Flash语音交互：对接Whisper实现语音控制

本文介绍了如何在星图GPU平台上自动化部署【ollama】GLM-4.7-Flash镜像，构建语音交互系统。该系统结合Whisper语音识别与GLM-4.7-Flash的指令理解能力，实现智能家居控制等场景的语音操作，提升日常任务执行效率。

龙虾开发者社区

学生党福音：OpenClaw+nanobot搭建学习监督助手

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，构建智能学习监督助手。该方案利用轻量级模型实现网课进度跟踪、自动生成练习题和错题整理功能，特别适合学生群体通过QQ机器人实现移动端学习管理，显著提升学习效率。

龙虾开发者社区

OpenClaw创意工坊：用nanobot镜像生成技术海报文案

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，快速生成技术海报文案。该镜像基于Qwen3-4B模型，能将复杂技术术语转化为通俗表达，适用于技术活动宣传、社交媒体推广等场景，显著提升内容创作效率。

龙虾开发者社区

所有评论(0)

查看更多评论

取个鸣字真的难

@qq_41081984

已为社区贡献14条内容

OpenClaw Windows 安装与 第三方API UniVibe 接入指南

取个鸣字真的难

OpenClaw Windows 安装与 第三方API UniVibe 接入指南

什么是 OpenClaw？

前置要求

安装步骤

1）安装 Node.js（22+）

方法一：官网下载（推荐）

方法二：使用 winget

验证 Node.js 是否安装成功

2）安装 OpenClaw

验证 OpenClaw 是否安装成功

3）获取 UniVibe API 密钥

4）运行安装向导（推荐）

向导配置项建议选择

向导完成后

5）配置 UniVibe 服务

方式一：修改配置文件

最小配置（添加或修改 agents + models）

完整配置示例（可直接参考）

方式二：GUI 界面配置

6）字段说明速查

7）启动服务

8）开始使用

方式一：Web UI（推荐）

方式二：Telegram Bot（可选）

9）可用模型（UniVibe）

GPT 系列

Claude 系列

Gemini 系列

10）切换模型

常用命令速查

终端命令

聊天命令

Windows 常见问题解决

1）安装提示权限错误

2）找不到配置文件目录

3）Gateway 启动失败（端口被占用）

4）Node.js 版本过低

5）防火墙阻止连接

结语

所有评论(0)

取个鸣字真的难

OpenClaw Windows 安装与第三方API UniVibe 接入指南

OpenClaw Windows 安装与第三方API UniVibe 接入指南