安装与首次启动

本页带你完成 Windows 版东创龙虾面板的下载安装、首次启动和运行环境检查。完成后，你应能进入主界面，并继续配置模型、Agent 引擎和第一个任务。

安装与首次启动演示视频，点击播放

完成本页后

你将看到绿色的“运行环境已就绪”状态，并能继续完成后续首次引导。

1. 01环境
   运行环境检查 Node.js、Python 和基础组件。→
2. 02模型
   AI 模型登录账号或配置模型提供商。→
3. 03引擎
   引擎安装安装本次任务需要的 Agent。→
4. 04渠道
   IM 集成按需连接消息渠道，也可以暂时跳过。→
5. 05完成
   进入面板确认状态并进入统一工作台。

开始前准备

安装前请确认电脑满足以下要求：

项目	最低要求	推荐配置
操作系统	Windows 10 22H2	Windows 11
可用磁盘	4 GB	8 GB 以上
内存	8 GB	16 GB 以上
网络	能访问模型和组件下载服务	稳定的宽带网络
权限	安装目录写入权限	首次安装使用管理员权限

同时建议准备：

• 一个长期使用、路径清晰的安装目录。
• 可用的模型账号或 API Key；首次启动后配置。
• 需要交给 AI 处理的测试文件夹；首次任务不要使用敏感资料。

第 1 步：下载 Windows 安装包

当前手册提供以下安装包：

系统	当前状态	适用场景	下载地址
Windows	已提供	Windows 10/11 桌面电脑或笔记本	下载 Windows 安装包（2026.8.26）
macOS	暂未提供	MacBook、iMac、Mac mini	等待后续发布
Linux	暂未提供	Ubuntu、Debian、Fedora 等桌面发行版	等待后续发布

下载安全

请只使用本手册或东创 AI 官方渠道提供的安装地址。不要从网盘、群文件或不明网站下载重新打包的安装程序。

下载完成后，按下面三步确认安装包签名：

1. 右键安装包，选择“属性”，打开“数字签名”页签。
2. 确认“签名人姓名”显示官方发布者信息，签名状态正常；需要进一步核对时，点击“详细信息”查看证书。
3. 如果缺少签名、签名状态异常，或浏览器提示来源异常，立即停止安装。

当前下载源没有提供可写入手册的 SHA-256；在官方补充校验值前，如果安装包缺少有效签名、浏览器提示来源异常或文件被重新打包，请停止运行并通过 技术支持 核实。

第 2 步：安装程序

1. 下载完成后，找到 东创龙虾面板-Setup-2026.8.10.exe 并双击运行。如果系统提示需要安装权限，请确认文件来自上方官方地址后再继续。
2. 选择安装范围。个人电脑通常选择“仅为我安装”；多人共用电脑需要管理员确认后再选择“为使用这台电脑的任何人安装”。

选择东创龙虾面板的安装范围

3. 选择安装目录，然后点击“安装”。建议使用空间充足、路径清晰的独立目录。

选择东创龙虾面板的安装位置

4. 等待进度条完成。安装期间不要关闭向导或移除安装磁盘。

等待东创龙虾面板安装完成

5. 安装完成后，保留“运行东创龙虾面板”选项并点击“完成”；也可以稍后从桌面快捷方式或开始菜单启动。

完成东创龙虾面板安装并启动软件

推荐将软件和运行环境放在独立目录，例如 D:\DongChuangOpenClawPanel，避免与个人文档、其他开发环境或系统目录混在一起。

备注

安装向导的文字和选项会根据系统权限、现有安装状态和软件版本略有不同，请以当前安装程序显示为准。

第 3 步：确认运行环境

首次启动后，按下面的顺序操作：

1. 在左侧导航中打开“引导安装”。
2. 确认当前位于“运行环境”步骤。
3. 检查“运行环境目录”。通常保留默认目录即可；需要更改时点击“选择”。
4. 等待页面检查 Node.js、Python、全局包、pnpm 和 yarn 等运行组件。

运行环境检测完成并显示已就绪

完成状态

页面底部显示绿色的“运行环境已就绪”，“下一步”按钮进入可点击状态。

如果环境尚未就绪，不要急着进入其他页面。先检查网络、磁盘空间和运行环境目录的写入权限，然后重新执行当前步骤。

第 4 步：完成首次引导

运行环境通过后，依次完成剩余步骤：

引导步骤	需要完成的操作	成功标志
运行环境	确认运行目录并完成组件检测	显示“运行环境已就绪”
AI 模型	登录官方账号，或配置模型提供商和 API Key	至少有一个可用模型
引擎安装	安装或启用 OpenClaw、Claude Code、Hermes Agent、Codex 等所需引擎	目标引擎显示已安装或运行中
IM 集成	按需要配置消息渠道；暂时不用时可按页面提示跳过	能进入下一步
完成	检查前面各项状态并结束引导	进入东创龙虾面板主界面

配置 AI 模型

进入“AI 模型”步骤后，选择模型提供商，使用 OAuth 登录或填写 API Key、Base URL 和接口格式。保存后执行连接测试，确认至少显示一个可用模型。

在首次引导中配置 AI 模型

保护模型凭据

API Key 应始终保持隐藏。截图、录屏或提交问题前，确认页面中没有显示完整密钥。

安装并启动 Agent 引擎

进入“引擎安装”步骤后，按页面提示安装并启动 OpenClaw。安装期间保持页面打开，等待启动过程结束。

等待 OpenClaw 引擎安装并启动

页面显示绿色“运行中”状态后，点击“下一步”。

OpenClaw 引擎安装完成并显示运行中

按需配置 IM 集成

需要通过微信、钉钉、飞书、企业微信、Telegram 或 WhatsApp 使用 Agent 时，在“IM 集成”步骤选择对应渠道并完成连接。暂时不使用消息渠道时，可以按页面提示跳过。

在首次引导中配置 IM 集成

完成需要的渠道配置后进入最后一步，检查运行环境、模型和引擎状态，再结束首次引导。

首次引导完成并生成认证信息

完成状态

页面显示“配置完成”后，点击“立即体验”进入主界面。认证信息由软件自动生成，请妥善保管。

推荐顺序

第一次使用时，先完成一个模型和一个 Agent 引擎即可。不要同时安装和配置所有能力，先跑通第一个任务，再按需要增加其他应用、Skill 和 MCP。

第 5 步：检查安装结果

进入主界面后，依次确认：

• 左侧能看到“对话、软件商店、技能管理、MCP 工具、AI 模型、实例管理”等入口。
• “AI 模型”页面可以打开。
• “软件商店”可以加载应用列表。
• “实例管理”可以显示本机实例或“添加实例”入口。

以上检查通过后，继续阅读 快速开始：完成第一个任务。

可选：U 盘或移动硬盘运行

东创龙虾面板支持便携使用场景，但不同系统仍需使用对应的运行环境包。只有当前发布说明明确标记为便携包或已经完成便携验收时，才按下面流程使用；普通安装目录不能直接视为完整便携包。

1. 使用读写速度较好的 U 盘或移动 SSD。
2. 将软件和完整运行环境放在独立目录。
3. 将非敏感模型配置、技能配置和常用资料放在明确的工作目录中。
4. 在另一台电脑运行前，确认系统允许执行外部磁盘中的程序。
5. 涉及敏感资料时，配合 文件与文件夹加密 和 敏感文件夹授权访问 使用。

完整的换机、导出和恢复检查见 升级、备份与迁移。

注意

不要把真实 API Key、未加密的客户资料和安装程序放在同一个可随意复制的便携目录中。

常见问题

现象	优先检查	建议处理
安装程序无法启动	系统版本、文件来源、安装权限	重新从官方地址下载；确认系统满足最低要求
环境检测长时间没有完成	网络、磁盘空间、目录写入权限	保持当前页面，修复条件后重试当前步骤
更换运行环境目录后仍读取旧目录	当前页面显示的路径	恢复默认目录，重新启动后再次检查
进入主界面但没有可用模型	AI 模型配置	登录官方账号或手动配置模型并测试连接
实例显示离线	Agent 引擎状态、实例配置	先确认引擎已安装，再刷新实例状态

仍无法解决时，请记录操作系统、软件版本、失败步骤和完整错误提示，再按 技术支持 中的清单收集信息。

下一步

• 完成第一个任务：快速开始：完成第一个任务
• 认识主界面：新手界面导览
• 配置模型与实例：AI 模型管理、实例管理