OpenClaw Windows 用户上手指南：详细安装与配置流程（2026年3月版）
本指南将详细介绍 OpenClaw 在 Windows 环境下的安装与初始配置流程，帮助用户快速启动和使用。我们推荐在国内用户优先选择推荐配置，以获得最佳体验。
1. 启动初始配置向导
首次安装 OpenClaw 后，初始配置向导通常会自动启动。如果需要手动启动或重新配置，可以使用以下命令：
- 自动启动：在运行安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex时会自动触发。 - 手动启动：在 PowerShell 管理员权限窗口中执行：
openclaw onboard - 快速配置：跳过部分高级选项，执行：
openclaw onboard --flow quickstart - 重置配置：当遇到问题需要完全重新配置时，执行：
openclaw onboard --reset
注意：请确保在同一个管理员权限的 PowerShell 窗口中执行所有命令。如果遇到中文乱码问题，请先运行 chcp 65001 切换到 UTF-8 编码。
2. 详细配置步骤
向导将引导您完成一系列配置。您可以使用上下箭头选择选项，按 Enter 键确认。按 Ctrl+C 可随时退出。
步骤 1: 安全声明与现有配置检查
首次启动时，您会看到安全提示，确认您了解 OpenClaw 所需的权限。输入 Yes 继续。接着，程序会检测本地是否存在 ~/.openclaw/openclaw.json 配置文件。如果是首次安装，将直接跳过。若已有配置，您可选择保留、修改或重置。
步骤 2: 选择配置模式
这是关键一步。您需要选择配置模式：
- QuickStart（推荐，尤其适合国内用户）：自动配置本地 Gateway、端口 18789、Token 认证及默认工作区。
- Advanced：手动控制每一步配置。
步骤 3: AI 模型与认证配置
在此步骤中，您可以选择 AI 模型提供商。国内用户优先推荐以下选项：
- Moonshot（Kimi 系列模型）：国内访问稳定，提供免费额度。
- MiniMax：同样是国内用户的高性价比选择。
请根据您的选择，前往相应官网获取 API Key，然后在向导中粘贴。确保 API Key 单行输入且无额外空格。选择默认的模型版本（如 moonshot-v1）。向导会自动测试连接，国内网络通常会秒通。
其他选项：如果需要使用 DeepSeek、通义千问等模型，可以选择"Custom Provider"或在安装后通过 Dashboard 或 Skills 插件进行配置，它们通常兼容 OpenAI API 格式。
步骤 4: 配置工作区
默认工作区路径为 C:\Users\<您的用户名>\.openclaw\workspace。推荐直接按 Enter 键使用默认路径。向导将自动创建所需的文件，如 AGENTS.md 和 IDENTITY.md。
步骤 5: Gateway 网关设置
默认配置为：
- Gateway Port:
18789 - Bind:
loopback（仅本地访问） - Auth Mode:
Token（推荐） - Tailscale:
Off
国内用户可直接按 Enter 键使用所有默认设置。
步骤 6: 配置聊天渠道
向导支持多种聊天渠道集成。国内用户建议：
- 立即选择 Skip all for now 以快速完成配置。
- 或选择 TG（Telegram），通过 BotFather 创建机器人即可快速接入。
注意：飞书、钉钉等国内常用即时通讯工具，官方暂未直接集成。但您可以在安装 OpenClaw 后，通过 Dashboard 的 Channels 页面或 Skills 插件进行添加。社区已提供飞书插件，可通过命令 openclaw skills install feishu 安装。
步骤 7: 安装守护进程
建议选择 Yes 安装守护进程，实现开机自启。Runtime 推荐选择 Node.js。在 Windows 环境下，这通常会通过 WSL2 或直接作为 Windows 服务来管理。
步骤 8: 安装 Skills 插件与 Web 搜索
建议安装推荐的 Skills 插件。对于 Web 搜索提供商，国内用户推荐选择 Kimi，或根据需要选择 Brave、Perplexity，也可以选择 Skip 跳过。
步骤 9: 完成与健康检查
向导将自动启动 Gateway 服务，并运行 openclaw health 命令进行最终检查。成功完成后，您将看到类似如下的提示，其中包含 Dashboard 的访问地址：
Onboarding completed! 🎉 Dashboard: http://127.0.0.1:18789
现在，您可以通过访问该地址来管理和使用 OpenClaw。
