OpenClaw Windows 安装指南

什么是 OpenClawOpenClaw 是一款开源的本地 AI 助手运行在你自己的电脑上可通过 Web UI、Telegram、WhatsApp、Discord 等多种方式交互实现文件操作、终端命令执行、浏览器控制等自动化任务。前置要求Windows 10 或更高版本Node.js 环境版本 22 或更高有效的 UniVibe API 密钥安装步骤1. 安装 Node.js 环境OpenClaw 需要 Node.js 22 或更高版本才能运行。方法一官网下载推荐访问https://nodejs.org/点击 “LTS” 版本进行下载确保版本 ≥ 22下载完成后运行.msi安装程序按照安装向导完成安装保持默认设置即可方法二使用 winget如果你已经安装了 winget可以使用以下命令winget install OpenJS.NodeJS.LTS验证 Node.js 安装安装完成后打开 PowerShell 或命令提示符输入以下命令node --version npm --version如果显示版本号node 版本需 ≥ 22说明安装成功了2. 安装 OpenClaw打开 PowerShell 或命令提示符运行以下命令npm install -g openclaw这个命令会从 npm 官方仓库下载并安装最新版本的 OpenClaw。验证 OpenClaw 安装安装完成后输入以下命令检查是否安装成功openclaw --version如果显示版本号恭喜你OpenClaw 已经成功安装了。提示如果提示找不到命令尝试重新打开 PowerShell 窗口某些情况下可能需要以管理员身份运行3. 获取 API 密钥获取key4. 运行安装向导首次使用 OpenClaw建议运行安装向导openclaw onboard --install-daemon向导配置选项说明向导会逐步引导你完成配置以下是每个步骤的建议选择步骤建议选择Risk 确认选择yes继续Onboarding mode推荐选择QuickStart快速完成基础配置Model/auth provider选择Skip for now稍后手动配置 UniVibeFilter models by provider选择All providersDefault model选择Keep currentSelect channel选择Skip for now后续再配置Configure skills推荐选择Yes启用本地实用技能Preferred node manager for skill installs选择npmInstall missing skill dependencies选择Skip for now各种 API Key 设置没有的话选No或SkipGateway service选择Install或Reinstall安装 Gateway 服务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 界面来接入 UniVibe。方式一修改配置文件使用记事本编辑notepad %USERPROFILE%.openclaw\openclaw.json使用 VS Code 编辑code %USERPROFILE%.openclaw\openclaw.json配置内容在配置文件中添加或修改以下内容{ agents: { defaults: { model: { primary: univibe-gpt/gpt-5.4 } } }, models: { providers: { univibe-claude: { baseUrl: https://api.univibe.cc/anthropic, apiKey: 你的API密钥, api: anthropic-messages, models: [ { id: claude-sonnet-4-6, name: Claude Sonnet 4.6 }, { id: claude-opus-4-6, name: Claude Opus 4.6 } ] }, univibe-gpt: { baseUrl: https://api.univibe.cc/openai, apiKey: 你的API密钥, api: openai-responses, models: [ { id: gpt-5.4, name: GPT-5.4 }, { id: gpt-5.3-codex, name: GPT-5.3 Codex } ] }, univibe-gemini: { baseUrl: https://api.univibe.cc/openai/v1, apiKey: 你的API密钥, api: openai-completions, models: [ { id: gemini-3.1-pro-preview, name: Gemini 3.1 Pro }, { id: gemini-3-pro-preview, name: Gemini 3 Pro } ] } } } } 记得将你的API密钥替换为在上方API Keys标签页中创建的实际密钥。注意如果配置文件中已有其他内容如gateway、skills、wizard等请保留它们只需添加或修改agents和models部分。完整配置示例以下是一个完整的配置文件示例{ agents: { defaults: { model: { primary: univibe-gpt/gpt-5.4 }, maxConcurrent: 4, subagents: { maxConcurrent: 8 }, compaction: { mode: safeguard } } }, gateway: { mode: local, port: 18789, bind: loopback }, models: { providers: { univibe-claude: { baseUrl: https://api.univibe.cc/anthropic, apiKey: 你的API密钥, api: anthropic-messages, models: [ { id: claude-sonnet-4-6, name: Claude Sonnet 4.6 }, { 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 } ] }, univibe-gpt: { baseUrl: https://api.univibe.cc/openai, apiKey: 你的API密钥, api: openai-responses, models: [ { id: gpt-5.4, name: GPT-5.4 }, { id: gpt-5.3-codex, name: GPT-5.3 Codex }, { id: gpt-5.1-codex-max, name: GPT-5.1 Codex Max } ] }, univibe-gemini: { baseUrl: https://api.univibe.cc/openai/v1, apiKey: 你的API密钥, api: openai-completions, models: [ { id: gemini-3.1-pro-preview, name: Gemini 3.1 Pro }, { id: gemini-3-pro-preview, name: Gemini 3 Pro }, { id: gemini-3-flash-preview, name: Gemini 3 Flash } ] } } } }方式二GUI 界面配置如果你更喜欢图形界面可以在 Web 控制页面中配置打开浏览器访问http://127.0.0.1:18789进入Config → Models → Providers依次添加以下三个 ProviderClaude 系列univibe-claude配置项值Apianthropic-messagesApi Key你的 UniVibe API 密钥Base Urlhttps://api.univibe.cc/anthropicGPT 系列univibe-gpt配置项值Apiopenai-responsesApi Key你的 UniVibe API 密钥Base Urlhttps://api.univibe.cc/openaiGemini 系列univibe-gemini配置项值Apiopenai-completionsApi Key你的 UniVibe API 密钥Base Urlhttps://api.univibe.cc/openai/v1保存后配置立即生效6. 配置说明字段说明agents.defaults.model.primary默认模型格式为provider名/模型名如univibe-gpt/gpt-5.4models.providers自定义模型提供商配置建议按模型系列分开配置baseUrlClaude 用https://api.univibe.cc/anthropicGPT 用https://api.univibe.cc/openaiGemini 用https://api.univibe.cc/openai/v1apiKey你的 UniVibe API 密钥apiClaude 用anthropic-messagesGPT 用openai-responsesGemini 用openai-completionsmodels可用模型列表包含id和name7. 启动服务配置完成后启动 Gateway 服务openclaw gateway start8. 开始使用方式一Web UI推荐最简单的使用方式无需任何外部服务openclaw dashboard浏览器会打开http://127.0.0.1:18789/直接在网页聊天窗口发消息即可。方式二Telegram Bot在 Telegram 搜索BotFather发送/newbot创建机器人获取 Bot Token在openclaw onboard时输入 Token9. 可用模型UniVibe你可以在配置文件的models数组中添加以下模型GPT 系列模型 ID名称适用场景gpt-5.4GPT-5.4最新通用模型推荐默认使用gpt-5.2GPT-5.2通用高性能模型gpt-5.3-codexGPT-5.3 Codex高性能编程模型复杂重构首选gpt-5.2-codexGPT-5.2 Codex稳定编程模型gpt-5.1-codex-maxGPT-5.1 Codex Max大上下文编程模型gpt-5.1-codexGPT-5.1 Codex通用编程模型gpt-5.1-codex-miniGPT-5.1 Codex Mini轻量编程模型gpt-5.1GPT-5.1通用模型gpt-5GPT-5基础模型gpt-5-codexGPT-5 Codex基础编程模型Claude 系列模型 ID名称适用场景claude-opus-4-6Claude Opus 4.6最强推理能力复杂任务首选claude-sonnet-4-6Claude Sonnet 4.6均衡性能日常开发推荐claude-opus-4-5-20251101Claude Opus 4.5高性能推理模型claude-haiku-4-5-20251001Claude Haiku 4.5快速响应简单任务首选Gemini 系列模型 ID名称适用场景gemini-3-pro-previewGemini 3 Pro顶级性能前端开发神器gemini-3-flash-previewGemini 3 Flash性价比首选日常开发10. 切换模型在聊天窗口中使用/model命令切换模型/model univibe-claude/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 常见问题解决安装时提示权限错误尝试以管理员身份运行 PowerShell右键点击 PowerShell 图标选择 “以管理员身份运行”重新执行安装命令找不到配置文件目录在 PowerShell 中运行# 查看配置目录 explorer %USERPROFILE%.openclawGateway 启动失败检查端口 18789 是否被占用netstat -ano | findstr 18789如果端口被占用可以在配置文件中修改gateway.portNode.js 版本过低OpenClaw 需要 Node.js 22检查版本node --version如果版本低于 22请重新安装最新版本。防火墙阻止连接如果 Windows 防火墙提示请选择 “允许访问”或手动添加防火墙规则。