🚀 [保姆级教程] Windows 下 OpenClaw (小龙虾) 极速部署指南：从零基础到 Web 界面成功运行
摘要：OpenClaw（开源 AI 代理框架）功能强大但配置项繁多，新手极易在插件配置阶段劝退。本文记录了一次在 Windows 环境下“极简启动”的完整实战过程。我们将采用**“核心优先，插件后置”**的策略，跳过所有非必要的第三方依赖（如 Notion/GitHub），仅配置核心大模型 API（以 Moonshot/Kimi 为例），快速跑通本地服务并验证 Web 控制面板。适合希望快速搭建本地 AI 助手的开发者。
关键词：OpenClaw, AI Agent, Windows 安装, Kimi API, Moonshot, 本地大模型, 自动化运维
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 访问管理后台
- 注意：一定要带上 #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 超级助手。
接下来，你可以探索它的文件上传分析、多模态识别以及自定义工作流功能。
如果觉得这篇教程帮到了你，欢迎点赞、收藏、关注！有任何报错欢迎在评论区留言，我们一起探讨。🦞✨
