【保姆级教程】OpenClaw 在 Windows 10 / Win10 LTSC 下的完整安装指南

admin

前言

OpenClaw 是一款功能强大的集成化网关工具，适用于消息通道管理、插件扩展及服务部署。本文将详细讲解在 Windows 10（含 LTSC 版本）系统中安装 OpenClaw 的完整流程，涵盖系统依赖准备、服务配置、插件安装及常见问题排查，确保你在 Win10 LTSC 环境下也能零障碍完成安装。

OpenClaw官网：https://openclaw.ai

一、安装前准备：配置系统必要依赖

OpenClaw 的正常运行依赖于若干基础工具。请按顺序完成以下组件的安装，Win10 LTSC 用户需特别注意某些组件需手动下载。

1. 安装 Node.js

• 下载地址：Node.js 官网
• 版本选择：请下载 LTS 长期支持版（推荐 22.x 或 24.x，兼容性最佳），选择 Windows 64 位安装包。
• 安装步骤：
  
  • 双击安装包，务必勾选 「Add to PATH」（自动添加至系统环境变量），其余选项保持默认，一路下一步完成安装。
  • 验证安装：按下 Win + R，输入 cmd 打开命令提示符，执行以下命令检查版本：
    
    
    
    1. node -v
       
    2. npm -v

    复制代码
    
    若显示版本号，则表示安装成功。
    
  
  

2. 安装 Git

• 下载地址：Git 官网
• 版本选择：下载 Windows 64 位安装包（Win10 LTSC 直接选默认版本即可）。
• 安装步骤：
  
  • 安装过程中保持默认选项，但请确保 「Git Bash Here」 和 「Add Git to PATH」 被勾选。
  • 验证安装：在命令提示符中执行：
    

1. git --version

复制代码

显示版本号即成功。

3. 安装 Visual C++ Redistributable

Win10 LTSC 系统可能缺失必要的 Visual C++ 运行库，需手动安装：

• 下载地址：微软官方 Visual C++ Redistributable for Visual Studio 2015-2022（64位版本）。
• 选择版本：下载 x64 版本并安装。
  

4. 安装 CMake（可选，仅源码编译时需要）

如果你计划从源码编译 OpenClaw，则需安装 CMake 并配置环境变量：

• 下载地址：CMake 官网
• 版本选择：选择 Windows x64 Installer。
• 安装步骤：
  
  • 安装时勾选 「Add CMake to the system PATH for all users」。
  • 验证安装：在命令提示符中执行：
    
  
  

1. cmake --version

复制代码

显示版本号即配置成功。

二、配置 PowerShell 执行权限（关键！Win10 LTSC 必做）

Windows 10 默认限制 PowerShell 脚本执行，若未解除限制，一键安装脚本将无法运行。请按以下步骤操作：

• 以管理员身份打开 PowerShell：
  按下 Win + X，选择 「Windows PowerShell (管理员)」。
• 依次执行以下两条命令：
  

1. # 为当前用户设置执行策略为 RemoteSigned（允许本地脚本运行）
   
2.    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   
3. 
   
4.    # 临时为当前进程解除所有执行限制（避免脚本被拦截）
   
5.    Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

复制代码

• 若弹出权限确认提示，输入 Y 并回车确认。
  

三、配置 npm 镜像（大幅提升下载速度）

国内访问 npm 官方源速度较慢，建议切换至淘宝镜像源：

1. # 设置 npm 镜像为淘宝源
   
2. npm config set registry https://registry.npmmirror.com/
   
3. 
   
4. # 查看配置是否生效
   
5. npm config list

复制代码

若输出中包含 registry = "https://registry.npmmirror.com/"，则配置成功。

四、一键安装 OpenClaw 核心程序

完成以上准备后，即可执行 OpenClaw 官方提供的一键安装脚本（适用于 Win10 及 Win10 LTSC）：

1. iwr -useb https://openclaw.ai/install.ps1 | iex

复制代码

等待脚本自动运行，期间将自动下载并安装 OpenClaw 核心组件，无需手动干预。

1.初次安装完快速上手

步骤 1：确认「个人使用」提示

1. I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
   
2. |  Yes
   
3. |  No

复制代码

• 选择：直接输入 Yes（或按回车，默认选 Yes）
• 原因：确认你知晓使用权限规则，必须选 Yes 才能进入下一步配置。
  

步骤 2：选择引导模式

1. Onboarding mode
   
2. |  > QuickStart (Configure details later via openclaw configure.)
   
3. |    Manual

复制代码

新手首选：直接按回车选 QuickStart（快速启动模式）
✅ 优势：跳过复杂的初始配置，先启动服务，后续通过命令 / 网页控制台补配（比如 API Key、渠道对接），避免新手因参数填错导致启动失败。
如果选 Manual（手动全配）：往下看「Manual 模式完整配置步骤」。
步骤 3：核心选择逻辑（新手优先）

1. *  Model/auth provider
   
2. |  > OpenAI (Codex OAuth + API key)
   
3. |    Anthropic
   
4. |    Chutes
   
5. |    MiniMax
   
6. |    Moonshot AI (Kimi K2.5)
   
7. |    Google
   
8. |    xAI (Grok)
   
9. |    Mistral AI
   
10. |    Volcano Engine
    
11. |    BytePlus
    
12. |    OpenRouter
    
13. |    Kilo Gateway
    
14. |    Qwen
    
15. |    Z.AI
    
16. |    Qianfan
    
17. |    Alibaba Cloud Model Studio
    
18. |    Copilot
    
19. |    Vercel AI Gateway
    
20. |    OpenCode
    
21. |    Xiaomi
    
22. |    Synthetic
    
23. |    Together AI
    
24. |    Hugging Face
    
25. |    Venice AI
    
26. |    LiteLLM
    
27. |    Cloudflare AI Gateway
    
28. |    Custom Provider
    
29. |    Ollama
    
30. |    SGLang
    
31. |    vLLM
    
32. |    Skip for now

复制代码

新手 / 暂时没有任何 AI 模型 API Key（推荐）




选择：Skip for now

• 操作：在选项列表中找到 Skip for now（通常在列表最后），输入这个选项名称（或按方向键选中后回车）。
• 原因：
  
  • 跳过模型配置不会影响 OpenClaw 核心服务启动，只是暂时无法调用 AI 能力（但网关、网页控制台仍能正常运行）；
  • 后续可随时通过命令 / 网页控制台补充配置，无需重新走引导流程；
  • 避免新手因「无 API Key 却强行选择提供商」导致配置报错，甚至服务启动失败。
    
• 后续补充配置：启动服务后，执行 openclaw configure 重新进入模型配置，或直接在网页控制台（127.0.0.1:18789）的「模型设置」里配置。
  

步骤 4：核心选择逻辑（新手优先）

1. Filter models by provider
   
2. |  > All providers
   
3. |    amazon-bedrock
   
4. |    anthropic
   
5. |    azure-openai-responses
   
6. |    cerebras
   
7. |    github-copilot
   
8. |    google
   
9. |    google-antigravity
   
10. |    google-gemini-cli
    
11. |    google-vertex
    
12. |    groq
    
13. |    huggingface
    
14. |    kimi-coding
    
15. |    minimax
    
16. |    minimax-cn
    
17. |    mistral
    
18. |    openai
    
19. |    openai-codex
    
20. |    opencode
    
21. |    opencode-go
    
22. |    openrouter
    
23. |    vercel-ai-gateway
    
24. |    xai
    
25. |    zai

复制代码

新手 / 不确定具体模型（推荐）


选择：All providers

• 操作：直接按回车选中默认的 All providers（无需手动选其他）。
• 原因：
  
  • 「All providers」会加载所选主提供商下所有可用的模型（比如选了 OpenAI 主提供商，会显示 gpt-3.5-turbo、gpt-4、gpt-4o 等全部模型），新手无需纠结细分项；
  • 避免因选错细分项导致「无模型可选」（比如误选 openai-codex 仅显示代码模型，漏掉通用对话模型）；
  • 后续可在网页控制台自由切换模型，无需在命令行纠结。
    
• 后续：选完后终端会列出该提供商下所有模型，直接回车选默认模型（如 gpt-3.5-turbo）即可。
  

步骤 5：推荐选择（新手必选）

1. *  Default model
   
2. |  > Keep current (default: anthropic/claude-opus-4-6)
   
3. |    Enter model manually
   
4. |    amazon-bedrock/anthropic.claude-3-haiku-20240307-v1:0
   
5. |    amazon-bedrock/anthropic.claude-3-5-haiku-20241022-v1:0
   
6. |    amazon-bedrock/anthropic.claude-haiku-4-5-20251001-v1:0
   
7. |    amazon-bedrock/eu.anthropic.claude-haiku-4-5-20251001-v1:0
   
8. |    amazon-bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0
   
9. |    amazon-bedrock/us.anthropic.claude-haiku-4-5-20251001-v1:0
   
10. |    amazon-bedrock/anthropic.claude-opus-4-20250514-v1:0
    
11. |    amazon-bedrock/us.anthropic.claude-opus-4-20250514-v1:0
    
12. |    amazon-bedrock/anthropic.claude-opus-4-1-20250805-v1:0
    
13. |    amazon-bedrock/us.anthropic.claude-opus-4-1-20250805-v1:0
    
14. |    amazon-bedrock/anthropic.claude-opus-4-5-20251101-v1:0
    
15. |    amazon-bedrock/eu.anthropic.claude-opus-4-5-20251101-v1:0
    
16. |    amazon-bedrock/global.anthropic.claude-opus-4-5-20251101-v1:0
    
17. |    amazon-bedrock/us.anthropic.claude-opus-4-5-20251101-v1:0
    
18. |    amazon-bedrock/anthropic.claude-opus-4-6-v1
    
19. |    amazon-bedrock/eu.anthropic.claude-opus-4-6-v1
    
20. |    amazon-bedrock/global.anthropic.claude-opus-4-6-v1
    
21. |    amazon-bedrock/us.anthropic.claude-opus-4-6-v1
    
22. |    amazon-bedrock/anthropic.claude-3-5-sonnet-20240620-v1:0
    
23. |    amazon-bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0
    
24. |    amazon-bedrock/anthropic.claude-3-7-sonnet-20250219-v1:0
    
25. |    amazon-bedrock/anthropic.claude-sonnet-4-20250514-v1:0
    
26. |    amazon-bedrock/eu.anthropic.claude-sonnet-4-20250514-v1:0
    
27. |    amazon-bedrock/global.anthropic.claude-sonnet-4-20250514-v1:0
    
28. |    amazon-bedrock/us.anthropic.claude-sonnet-4-20250514-v1:0
    
29. |    amazon-bedrock/anthropic.claude-sonnet-4-5-20250929-v1:0
    
30. |    amazon-bedrock/eu.anthropic.claude-sonnet-4-5-20250929-v1:0
    
31. |    amazon-bedrock/global.anthropic.claude-sonnet-4-5-20250929-v1:0
    
32. |    amazon-bedrock/us.anthropic.claude-sonnet-4-5-20250929-v1:0
    
33. |    amazon-bedrock/anthropic.claude-sonnet-4-6
    
34. |    amazon-bedrock/eu.anthropic.claude-sonnet-4-6
    
35. |    amazon-bedrock/global.anthropic.claude-sonnet-4-6
    
36. |    amazon-bedrock/us.anthropic.claude-sonnet-4-6
    
37. |    amazon-bedrock/deepseek.r1-v1:0
    
38. |    amazon-bedrock/deepseek.v3-v1:0
    
39. |    amazon-bedrock/deepseek.v3.2
    
40. |    amazon-bedrock/mistral.devstral-2-123b
    
41. |    amazon-bedrock/google.gemma-3-4b-it
    
42. |    amazon-bedrock/zai.glm-4.7
    
43. |    amazon-bedrock/zai.glm-4.7-flash
    
44. |    amazon-bedrock/google.gemma-3-27b-it
    
45. |    amazon-bedrock/openai.gpt-oss-safeguard-120b
    
46. |  ...

复制代码

Keep current (default: anthropic/claude-opus-4-6)





直接回车 用默认模型即可。

---

为什么选这个？

• 这是当前 OpenClaw 自动给你推荐的默认模型，兼容性最好
• 不用你手动输入、不用纠结版本、不会配置错
• 后面想换模型随时能改，不用在这里卡死
  

步骤 6：网络搜索选择

1. Search provider
   
2. |  > Brave Search (Structured results · country/language/time filters)
   
3. |    Gemini (Google Search)
   
4. |    Grok (xAI)
   
5. |    Kimi (Moonshot)
   
6. |    Perplexity Search
   
7. |    Skip for now

复制代码

Skip for now





直接回车跳过。

---

为什么选 Skip for now？

• 这一步是配置联网搜索能力（让 AI 能查最新信息）
• 你现在没有这些服务商的 API Key，选了也用不了
• 跳过完全不影响 OpenClaw 主程序启动
• 后面想加搜索功能，再去网页后台配置就行
  

步骤 7：选择WEB UI打开 完成



五、基础配置与启动

1. 启动 Gateway 服务

1. # 启动 OpenClaw Gateway 核心服务
   
2. openclaw gateway start

复制代码

2. 初始化配置向导

首次安装建议执行重置并运行配置向导：

1. # 重置 onboard 配置（首次安装推荐）
   
2. openclaw onboard --reset
   
3. 
   
4. # 仅运行配置向导（如已重置或需修改配置）
   
5. openclaw onboard

复制代码

3. 查看 Gateway 状态

1. # 检查 Gateway 服务是否正常运行
   
2. openclaw gateway status

复制代码

若输出 Running 表示服务启动成功；若为 Stopped，请检查依赖安装是否完整。

4. 打开可视化控制面板

1. # 启动 OpenClaw 控制面板（自动打开浏览器）
   
2. openclaw dashboard

复制代码

执行后浏览器将自动打开，进入 OpenClaw 图形化管理界面。

六、进阶配置：安装系统服务与扩展插件

1. 安装系统服务（实现开机自启）

Win10 LTSC 推荐将 OpenClaw 安装为系统服务，免去每次手动启动的麻烦：

1. # 完整安装向导并配置为系统服务（开机自启）
   
2. openclaw onboard --install-daemon

复制代码

2. 添加消息通道

1. # 新增自定义消息通道
   
2. openclaw channels add

复制代码

根据提示输入通道名称、类型及配置信息即可完成添加。

3. 安装插件（以企业微信插件为例）

OpenClaw 支持丰富的插件扩展，例如安装企业微信插件：

1. # 安装企业微信插件
   
2. openclaw plugins install @wecom/wecom-openclaw-plugin

复制代码

七、常见问题排查（Win10 LTSC 专属）

• PowerShell 执行脚本提示权限不足
  
  • 请确保已按“第二部分”以管理员身份运行 PowerShell，并正确执行了 Set-ExecutionPolicy RemoteSigned 和 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass。
    
• npm 命令找不到
  
  • 检查 Node.js 安装时是否勾选了 「Add to PATH」。若未勾选，请手动将 Node.js 安装目录（例如 C:\Program Files\nodejs）添加到系统环境变量 Path 中。
    
• Gateway 启动失败
  
  • 确认 Visual C++ Redistributable 已安装且为最新版本（x64）。
  • 检查 Node.js 版本是否为 16.x 或 18.x，过高版本可能存在兼容性问题。
    
  
  

总结

• 核心准备：安装 Node.js、Git、Visual C++ 运行库，并正确配置 PowerShell 执行权限（Win10 LTSC 必须执行的两条命令）。
• 安装流程：配置 npm 镜像 → 执行一键安装脚本 → 启动 Gateway 并完成初始化向导。
• 进阶建议：安装为系统服务实现开机自启，按需添加消息通道和插件。
• 特别提醒：Win10 LTSC 用户需重点检查运行库安装和权限配置，其余步骤与标准 Win10 一致。
  

admin

补配模型等信息
方案一：Web UI 可视化配置（推荐）


1. 进入正确入口


打开 Web UI（openclaw dashboard）：

• 左侧菜单栏：Config（不是 Settings）
• 进入：Models → Providers
• 点 Add Provider 开始添加
  

2. 填写模型信息（以 Anthropic Claude 为例）

项	示例值
Provider Name	anthropic-bedrock
API	openai-completions
Base URL	https://bedrock-runtime.us-east-1.amazonaws.com
API Key	你的 AWS 密钥
Models → ID	anthropic.claude-3-5-sonnet-20241022-v2:0
Models → Name	Claude-3.5-Sonnet

3. 保存并设为默认

• 点 Test Connection 验证连通性
• 保存后，进入 Config → Agents → Defaults，将 primary 设为 anthropic-bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0
• 保存后自动热重载，无需重启
• 方案二：RAW 配置（找不到 Models 时用）
  

1. 进入 RAW 编辑

• 左侧：Config → All Settings → RAW
• 找到 models.providers 节点，添加如下配置（替换密钥和模型）
• 1. {
     
  2.   "models": {
     
  3.     "mode": "merge",
     
  4.     "providers": {
     
  5.       "anthropic-bedrock": {
     
  6.         "baseUrl": "https://bedrock-runtime.us-east-1.amazonaws.com",
     
  7.         "apiKey": "你的AWS密钥",
     
  8.         "api": "openai-completions",
     
  9.         "models": [
     
  10.           {
      
  11.             "id": "anthropic.claude-3-5-sonnet-20241022-v2:0",
      
  12.             "name": "Claude-3.5-Sonnet",
      
  13.             "reasoning": true,
      
  14.             "input": ["text"]
      
  15.           }
      
  16.         ]
      
  17.       }
      
  18.     }
      
  19.   },
      
  20.   "agents": {
      
  21.     "defaults": {
      
  22.       "model": {
      
  23.         "primary": "anthropic-bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0"
      
  24.       }
      
  25.     }
      
  26.   }
      
  27. }

  复制代码
  
  

2. 保存并重启

• 点 Save
• 终端执行：openclaw restart
• 
  
  

方案三：命令行配置（最稳，跳过 UI 问题）


1. 启动配置向导

1. openclaw config

复制代码

2. 按步骤选择

• 选择 local（本地网关）
• 选择 model（模型配置）
• 选择你的提供商（如 anthropic / openai / bedrock）
• 粘贴 API Key
• 选择具体模型（如 claude-3-5-sonnet）
• 设为默认模型 → yes
• 完成后重启：openclaw restart
  

验证是否生效

• 进入 Chat Playground，发送消息，查看是否使用配置的模型
• 终端：openclaw models status 查看默认模型
• Web UI 顶部 Health 显示 OK 即正常