切换到窄版

 找回密码
 立即注册
兔窝窝»论坛 › 学习 › 教程 › 【保姆级教程】OpenClaw 在 Windows 10 / Win10 LTSC 下 ...
返回列表 发新帖
查看: 20|回复: 1

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

[复制链接]
admin

2

主题

1

回帖

26

积分

管理员

积分
26
发表于 6 天前 | 显示全部楼层 |阅读模式
前言

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++ 运行库，需手动安装：
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

  4.    # 临时为当前进程解除所有执行限制（避免脚本被拦截）
  5.    Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
复制代码


  • 若弹出权限确认提示，输入 Y 并回车确认。
三、配置 npm 镜像（大幅提升下载速度）

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



  1. # 设置 npm 镜像为淘宝源
  2. npm config set registry https://registry.npmmirror.com/

  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

  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

2

主题

1

回帖

26

积分

管理员

积分
26
 楼主| 发表于 6 天前 | 显示全部楼层
补配模型等信息
方案一：Web UI 可视化配置（推荐）


1. 进入正确入口


打开 Web UI（openclaw dashboard）：

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

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

项
示例值
Provider Nameanthropic-bedrock
APIopenai-completions
Base URLhttps://bedrock-runtime.us-east-1.amazonaws.com
API Key你的 AWS 密钥
Models → IDanthropic.claude-3-5-sonnet-20241022-v2:0
Models → NameClaude-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 即正常



回复

举报

返回列表 发新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver|手机版|小黑屋|兔窝窝

GMT+8, 2026-3-22 19:27 , Processed in 0.100045 second(s), 19 queries .

Powered by www.tu55.cn

Copyright © www.tu55.cn, All Rights Reserved.

快速回复 返回顶部 返回列表