Windows 下 OpenClaw (小龙虾) 极速部署指南：从零基础到 Web 界面成功运行

优质文章学习记录

05 Apr 2026 — 6 min read

🚀 [保姆级教程] 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? (或类似提示)
我的操作：
1. 输入 Y 或选择 Yes。
2. 粘贴刚才复制的 sk-xxxxxxxx 格式的 API Key。
3. 按回车确认。

💡 注意：如果这里不配，后续 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 超级助手。

接下来，你可以探索它的文件上传分析、多模态识别以及自定义工作流功能。

如果觉得这篇教程帮到了你，欢迎点赞、收藏、关注！有任何报错欢迎在评论区留言，我们一起探讨。🦞✨