Windows 下 OpenClaw 快速部署指南
1. 前言
最近开源社区火热的 OpenClaw（社区昵称'小龙虾'）是一个极具潜力的 AI 代理框架。它支持连接多种大模型，具备文件处理、联网搜索和自动化工作流能力。
然而，很多同学在初次安装时，面对密密麻麻的插件配置选项（Hooks, Plugins, Optional Apps）感到无从下手，甚至因为缺少某个无关紧要的 Token 导致安装失败。
本教程的核心目标：
- 最快路径：跳过所有非必要配置，5 分钟内让服务跑起来。
- 稳定运行：确保核心对话和联网功能正常。
- 可视化验证：成功打开 Web 管理后台。
2. 环境准备
在开始之前，请确保你的电脑满足以下条件：
- 操作系统：Windows 10 或 Windows 11。
- 网络环境：能够正常访问 GitHub（下载依赖）和大模型 API 接口。
- API Key 准备：
- 推荐国内用户选择 Moonshot AI (Kimi)，速度快且免费额度充足。
- 获取地址：Moonshot 开放平台
- *注：本教程以 Kimi 为例，其他模型配置逻辑类似。
3. 安装与配置实战 (核心步骤)
3.1 启动初始化向导
下载并解压 OpenClaw 后，在终端（CMD 或 PowerShell）中进入目录并运行启动命令。系统将进入交互式配置向导。
3.2 配置核心大模型 (必须)
程序会首先询问是否配置大模型 API。这是 AI 的'大脑'，必须配置。
- 系统提示：
Set MOONSHOT_API_KEY for moonshot?(或类似提示) - 我的操作：
- 输入
Y或选择Yes。 - 粘贴刚才复制的
sk-xxxxxxxx格式的 API Key。 - 按回车确认。
- 输入
💡 注意：如果这里不配，后续 AI 将无法回答任何问题。
3.3 极简策略：跳过非必要插件 (关键！)
接下来，系统会询问一系列第三方服务集成。为了快速启动，我们统一选择跳过！
- Notion / GitHub / Google Drive 等：
- 提示：
Set NOTION_API_KEY...?/Set GITHUB_TOKEN...? - 操作：直接选
No或Skip。 - 理由：这些是进阶功能，不影响核心对话。以后可以在 Web 界面随时补配。
- 提示：
- Hooks (自动化钩子)：
- 提示：
Enable hooks? - 选项包括：
Skip for now,boot-md,session-memory等。 - 操作：保持默认选中 [•] Skip for now，直接按 Enter。
- 理由：新手开启 Hooks 容易因路径权限问题报错，先跳过保平安。
- 提示：
- Optional Apps (可选应用)：
- 提示：
Add nodes for extra features (macOS/iOS/Android)? - 操作：直接按 Enter 跳过。
- 理由：Windows 用户暂时不需要移动端节点。
- 提示：
3.4 孵化机器人 (Hatch Your Bot)
配置完成后，进入最后的启动选择环节。
- 系统提示：
How do you want to hatch your bot? - 选项分析：
> Hatch in TUI (recommended)：在终端运行（推荐，最稳定）。Open the Web UI：直接尝试打开浏览器（有时受限于默认浏览器设置）。Do this later：退出。
- 我的操作：保持默认，选中 Hatch in TUI (recommended)，按 Enter。
此时，终端会开始加载服务，你会看到类似以下的日志输出：
Heartbeat interval: 30m (main) Session store (main): C:\Users\Administrator\.openclaw\agents\main\sessions\sessions.json Web UI: http://127.0.0.1:18789/ Web UI (with token): http://127.0.0.1:18789/#token=...... Gateway: reachable
看到 Gateway: reachable 和 Web UI 地址，说明后端启动成功！
4. 验证运行结果
虽然我们在终端选择了 TUI 模式，但 OpenClaw 会自动在后台启动一个强大的 Web 控制面板。
4.1 访问管理后台
- 打开浏览器（Chrome/Edge）。
- 在地址栏输入终端日志中显示的 带 Token 的完整链接（例如：
http://127.0.0.1:18789/#token=d4b5...）。- 注意：一定要带上
#token=...部分，否则可能无法通过鉴权。
- 注意：一定要带上
4.2 界面检查
成功进入后，你将看到如下界面（请核对关键点）：
成功标志：
- ✅ 右上角状态灯为 绿色 (
健康状况 正常)。 - ✅ 版本号显示正常（如图中的
2026.3.8）。 - ✅ 中间聊天区域空白待命。
- ✅ 底部输入框可用。
5. 首次对话测试
光看不练假把式，我们来测试一下 AI 是否真的'活'了。
在底部输入框尝试发送以下指令：
测试 1：基础自我介绍
'你好，请介绍一下你自己。'
测试 2：联网能力测试 (核心亮点)
'帮我搜索一下今天最新的科技新闻，并总结三条要点。'
预期结果：
AI 应该能迅速回复，并且在测试 2 中展示它调用搜索引擎的过程（通常会显示 Searching... 或类似的工具调用日志）。
6. 常见问题 (FAQ)
Q1: 浏览器打不开页面，提示'无法连接'？
- 解决：检查防火墙是否拦截了
18789端口。或者尝试手动复制终端里生成的带 Token 的长链接，不要只输127.0.0.1:18789。
Q2: 我想后续配置 GitHub 或 Notion 怎么办？
- 解决：不需要重装！在 Web 界面左侧菜单找到 '设置' (Settings) 或 '技能' (Skills)，在那里可以动态添加 API Key 并启用相应插件。
Q3: 关闭命令行窗口后，服务还能用吗？
- 解决：不能。命令行窗口是服务的宿主进程。如果需要长期运行，可以将该命令设置为开机自启脚本，或使用
pm2等工具守护进程（进阶玩法）。
7. 结语
通过**'核心优先，插件后置'**的策略，我们成功绕过了 OpenClaw 复杂的配置陷阱，在 Windows 上丝滑启动了服务。现在的你已经拥有了一个本地的、可联网的、支持文件处理的 AI 超级助手。
接下来，你可以探索它的文件上传分析、多模态识别以及自定义工作流功能。
