Step 1
看到启动引导页
先确认启动器真的打开了
如果你已经看到配置引导，而不是系统拦截弹窗，就说明下载后的第一关已经过了。
👇
还没下载？ 先去 下载页 选对平台的一键包。下载完成后直接回这里继续就好。
💡 前置条件
你已经在 下载页 选好平台，并拿到了对应的一键包。这个页面只负责把你带到“第一次真的能用”。
先按这个顺序检测
如果中途卡住，建议按顺序来。你的目标不是"把配置页点完"，而是确认自己已经走到第一次可用结果。
1
一键包是否下载正确，并且已经解压到新的目录
2
启动器是否能正常打开，没有被系统权限或杀软拦截
3
模型连接测试是否通过，API Key 和网络是否都正常
4
是否已经完成第一次任务，拿到第一条有结果的输出
💡 什么时候去排障
只有当你明确卡在上面某一步时，再去 排障页 按错误类型处理，这样会快很多。
配置引导，只做够第一次跑通的那部分
Step 2
看到模型服务商列表
先选最容易拿到 Key 的服务商
第一次不要纠结最强模型，先选最容易完成测试的那个。
Step 3
看到测试连接成功
成功标志是“能稳定回复”
只要测试通过并拿到第一条正常回复，这次首装就算真的完成了，不是只把软件打开而已。
-
第一次启动
Windows 用户双击启动程序（launch.bat），macOS 用户右键打开启动脚本（launch.command）。
第一次启动会自动进入配置引导，不需要你手动编辑配置文件。
如果这一步就打不开，先去看 排障页 里的“打不开 / 启动失败”。
-
选择 AI 模型供应商
优先选择你当前最容易拿到 API Key（服务商给你的专属密码）的服务商。中国大陆用户推荐先从国内模型提供商开始：
- 🇨🇳 豆包 / 硅基流动 / DeepSeek / 自定义兼容接口
- 🧠 已有海外 API 的用户也可以继续使用现有服务商
- 🏠 想少花钱也可以后续切到本地模型
-
输入 API Key
填入对应服务商的 API Key。密钥仅保存在本地，不会上传到任何第三方。
⚠️ 安全提示 不要将 API Key 分享给他人或提交到公开仓库。如果这里报错，优先检查是不是复制了前后空格、密码已过期，或者当前网络无法访问对应接口。
-
测试连通性
点击「测试连接」，确认 API Key 有效、网络可用、模型能正常返回结果。
✓测试成功：说明这台机器已经具备第一次可用条件
-
完成初始配置
设置工作目录，选择是否开机自启，点击「保存并进入」。
第一次成果，先拿一个看得见的输出
配置完成后，马上做一个足够小、但能证明“真的能用”的任务：
# 让 AI 帮你总结一个网页
总结这篇文章的核心观点：https://docs.openclaw.ai
# 或者让它帮你写一份 README
帮我写一份 Node.js 项目的 README 模板
💡 判断标准
只要你能稳定输入一个真实问题，并拿到一条可读、可复用的回复，你的第一次成果就到手了。
验证安装成功
完成以下 3 项，说明你已经跑通了：
1
应用正常启动，没有报错
2
模型连接测试通过，可以正常对话
3
完成了第一个任务，得到预期输出
接下来，先延续第一次成果这条主线
第一次跑通后，先延续成功感
现在最优先的下一步不是继续折腾环境，而是马上完成一个更像样的新手任务。其他入口都往后排。
继续阅读
按这条顺序继续，最不容易迷路
你现在已经完成安装和首启，下一步重点不是继续折腾环境，而是把第一次可见成果做扎实，然后再决定是否扩展 Skill。
模型选择与 API 配置
如果你首启阶段最不稳的是模型连接，这篇会帮你把服务商和 Key 先配稳。
看模型配置教程 →Skills 指南
如果你已经能稳定对话，就可以进入 Skill 扩展路径，开始装第一个真正会用的扩展。
进入 Skills 指南 →排障页
如果你还卡在模型连接、权限或启动报错，这里会比继续往下读教程更有效。
遇到问题？去排障 →