问题现象

在执行配置向导时：

当提示 Enter DeepSeek API key 并显示 Required 后，无论你如何粘贴 API Key、按回车，界面都纹丝不动，仿佛程序失去了响应。

根本原因分析

经过层层排查，发现导致卡死的根本原因有两个：

OpenClaw 网关服务未安装/未启动
配置向导需要与本地网关服务通信来验证 API Key 并保存配置，如果网关服务没有运行，向导就会一直等待，表现为“卡死”。

交互式终端输入机制的特殊性
粘贴 API Key 时，终端默认不显示任何字符（包括星号），且容易让人误以为没有输入成功。此外，网络延迟或服务无响应也会导致界面长时间无反馈。

完整解决步骤

第一步：以管理员身份运行终端

按 Win + R 输入 cmd，按 Ctrl + Shift + Enter 选择“以管理员身份运行”。

第二步：安装网关服务

成功后会提示：

第三步：启动网关服务

或者使用计划任务手动启动：

验证是否运行：

应显示 Gateway: running。

第四步：绕过交互式向导，直接配置 DeepSeek API Key

不要再运行 openclaw onboard，改用以下更稳定的方法。

方法一：环境变量配置（推荐）

进入 OpenClaw 配置目录：

新建 .env 文件：

填入以下内容（替换 sk-你的真实密钥）：

保存并重启网关：

方法二：直接修改配置文件

用记事本打开 %USERPROFILE%\.openclaw\openclaw.json，添加以下内容：

保存后重启网关。

第五步：验证配置是否成功

应该能看到类似输出：

测试对话：

附加问题：开机自动弹出终端窗口的解决方法

完成上述配置后，你可能发现每次电脑开机都会自动弹出一个终端窗口（运行 gateway.cmd）。这是因为 OpenClaw 创建的计划任务默认会在用户登录时显示窗口。

方案一：彻底关闭开机自启（不推荐）

方案二：让网关静默运行（推荐）

创建一个 PowerShell 脚本 Start-OpenClaw-Hidden.ps1，内容如下：

打开任务计划程序（taskschd.msc），找到 OpenClaw Gateway 任务。

右键 → 属性 → 操作 → 编辑。

将“程序或脚本”改为 powershell.exe，添加参数：

确定保存。

之后开机不会再弹出窗口，但网关会在后台正常运行。

进阶建议：迁移到 WSL2 环境

Windows 原生运行 OpenClaw 偶尔会遇到权限、路径、服务等兼容性问题。官方推荐在 WSL2 中使用 OpenClaw，所有后台进程可以真正做到静默运行，且无终端窗口干扰。安装 WSL2 后，在 Ubuntu 子系统中按 Linux 方式配置即可。

总结

通过以上步骤，我们成功解决了：

• OpenClaw 配置 DeepSeek 时卡在 Required 的问题（根源是网关服务未运行 + 交互式向导脆弱）。
• 开机自启弹窗的优化（修改计划任务执行方式）。
• 提供了环境变量与配置文件两种稳定配置方法，避免再次进入卡死的向导。

如果你按照本文操作后仍有问题，欢迎在评论区留言，我会尽力解答。

相关命令速查表

重要提醒：

• 始终以管理员身份运行涉及安装/启动服务的命令。
• DeepSeek API Key 需要账户已完成实名认证并有余额。
• 粘贴 Key 时终端不显示任何字符是正常的安全行为。