夜雨聆风OpenClaw落地应用实操系列 · 第 02 篇
第一期主题：OpenClaw落地应用实操本期共规划 21 篇内容，本文为第 02 篇。本篇主要讲述：如何在 Windows 本地把 OpenClaw 真正安装起来、接上模型、跑通第一次会话，并知道遇到报错时该按什么顺序排查。
所属栏目《跨境电商AI应用实操专栏》第一期内容
本篇主题手把手：OpenClaw本地安装 + 首次使用全流程（Windows版）
上一篇OpenClaw是什么？跨境卖家为什么现在必须学
下一篇OpenClaw与主流跨境工具的联动配置
特别提示文末有彩蛋，建议看到最后
🎁 本期文末彩蛋：「OpenClaw本地安装检查清单」——从 Node、安装命令、Gateway 状态到首次会话，一步一步帮你排查。文末见 ↓
上一篇我们把 OpenClaw 讲清楚了，这一篇开始真正动手。
我先把话说透：如果第 02 篇只是写“注册账号、配置环境”这种空话，读者看完还是不知道命令在哪敲、模型在哪接、第一次怎么跑，那这篇就是失败的。
所以这一篇，我直接按“Windows 本地安装 → 首次启动 → 接模型 → 跑通第一次会话 → 出问题怎么查”这个顺序来写。你照着往下做，目标不是“理解 OpenClaw 的全部原理”，而是今天把它跑起来。
一、先把路线选对：Windows 原生先跑，长期建议 WSL2
官方当前对 Windows 的口径其实很明确：Windows 原生能装，WSL2 更稳。也就是说，你完全可以先在 Windows 原生里把 OpenClaw 跑起来，但如果你后面要长期使用、接更多工具、装更多 skills、追求稳定性，官方更推荐在 WSL2 里运行。
你现在怎么选最合适：
如果你只是想先本地体验：先按这篇走 Windows 原生。如果你后面准备长期用、追求稳定、要接更多 Linux 工具链：下一步再迁到 WSL2。不要一开始就被“环境路线”卡死，先完成第一遍安装更重要。
二、安装前准备：你电脑里至少要具备这几样
官方安装要求里，最关键的是 Node 版本。当前推荐的是 Node 24，最低是 Node 22.14+。安装脚本会自动处理，但你自己脑子里要知道：很多“装不上”的问题，本质都是 Node、PATH、权限或网络问题，而不是 OpenClaw 本身坏了。
✓ Windows 电脑一台
✓ 能正常联网
✓ PowerShell 可以正常打开
✓ 你手里已经有一个模型 API Key（后面接模型要用）
✓ 最好以普通用户先装，只有遇到权限问题时再考虑管理员权限
三、正式安装前，先做 30 秒自检
不要一上来就跑安装脚本。先打开 PowerShell，做三个最基础的检查，这一步能帮你省掉一半排错时间。
如果 node -v 有输出，说明本机已经装过 Node；如果没有，也没关系，官方安装脚本会处理。你现在做这一步，只是为了后面一旦失败，知道该先查哪一层。
四、第一步：在 Windows 里真正安装 OpenClaw
打开 PowerShell，直接执行官方安装脚本。Windows 对应的命令就是这一条：
这条命令的作用，不是单纯“下载一个程序”，而是：检测你的系统、需要的话处理 Node、安装 OpenClaw，并进入 onboarding 初始化流程。
如果你不想安装后立刻进入初始化向导，官方也提供了跳过 onboarding 的写法：
但如果你是第一次装，我不建议跳。对新手来说，跟着官方向导走，比自己乱配更稳。
五、安装时你会看到什么，做到哪一步算正常
很多人看到命令行滚动一堆英文就慌了。其实你只需要盯住 4 个关键阶段：
①脚本开始运行说明 PowerShell 没拦住脚本，安装流程已经真正开始。
②Node 检测 / 安装阶段如果你本机没有合适的 Node，脚本会自动处理。这时你要做的是等，不要中途关掉窗口。
③OpenClaw CLI 安装完成这一阶段结束后，你的机器里已经有 openclaw 命令了。
④onboarding 启动这说明不仅装上了，而且已经进入首次配置流程。对于新手，这是最理想的状态。
六、第二步：安装完别急着关，先做 4 条验收命令
真正的实操文章，不能只告诉你“装完了”，还要告诉你怎么验收。安装完成后，先跑下面这 4 条命令：
你要的不是“命令有回显就行”，而是：CLI 能识别、doctor 没有阻塞性错误、gateway 有状态、status 能给出总览。
每条命令分别在看什么：
openclaw --version：机器里到底有没有装上 CLI。
openclaw doctor：当前环境有没有明显配置问题。
openclaw gateway status：Gateway 有没有起来。
openclaw status：给你一个更完整的本地状态总览，出问题时优先看它。
七、如果 openclaw 命令压根找不到，先别重装
这是新手最常见的问题之一：脚本好像跑完了，但一敲 openclaw，就报 not found 或不是内部命令。这个时候别急着重复安装三遍，先按下面顺序查：
①Node 是否正常先跑 node -v、npm -v，看底层环境是不是已经坏了。
②PATH 是否刷新有时脚本装好了，但当前 PowerShell 会话没刷新，先关掉 PowerShell 再重开一遍。
③再跑 doctor如果命令能识别了，再看 doctor 是否有路径或权限提示。
④最后才考虑重装先把问题定位清楚，再决定要不要重装，不然大概率还是会回到原问题。
八、第三步：跑 onboarding，这一步不要跳
OpenClaw 官方推荐的新手配置方式，就是 onboarding。命令很简单：
如果你是通过 npm 之类自己装的，而不是官方安装脚本装的，官方还给了一个常见写法：
这一步的作用，不是“填几个参数”这么简单。它会帮你配置本地 Gateway 或远程 Gateway 连接、workspace 默认项、技能和渠道的初始配置。你要把它当成真正的初始化，而不是可有可无的欢迎页。
九、onboarding 过程中，你应该怎么选
这一步很多文章都写得太空。真正实操时，新手最需要的是“这一题该怎么选”。你第一轮安装，建议按下面的思路来：
✓ Gateway 相关：优先选本地可用路线，先保证它能在你机器上跑起来
✓ 模型相关：只接一个主模型，不要一开始就研究多模型路由
✓ Web 搜索相关：有能力就先配置，没有也可以后面补，不影响先聊天
✓ Skills 相关：第一轮以最小可用为主，不要一开始装一堆可选能力
原则只有一个：先有一套能跑的，再谈一套更完整的。
十、第四步：把模型接上，不然 OpenClaw 只是空壳
这里是很多人最容易糊弄过去、但实际上最关键的一步。OpenClaw 本身不是模型，它要连模型提供方才能真正工作。官方推荐的主路径就是用 onboarding 来完成模型选择、认证和默认模型设置；如果后面你要调整，再用 models/configure 命令补改。([docs.openclaw.ai](https://docs.openclaw.ai/start/getting-started?utm_source=chatgpt.com))
你先记住一个原则：第 02 篇不要追求多模型，不要一开始研究路由和 fallback，只接一个主模型。你的目标只是先把第一次会话跑通。([docs.openclaw.ai](https://docs.openclaw.ai/concepts/model-providers?utm_source=chatgpt.com))
十一、先选模型提供方：你到底接哪一家
✓ 想走标准 API Key：优先选 OpenAI / Anthropic / Venice 这类官方支持提供方
✓ 想直接复用 ChatGPT / Codex 订阅体系：可以走 OpenAI Codex OAuth
✓ 想本地跑模型：可以接 Ollama，本地默认地址通常是 127.0.0.1:11434
✓ 第一次安装最稳妥的路线：选你手里已经有 Key 的那一家，不要为了“最优”拖慢第一次落地
官方文档里，OpenClaw 把模型写成 provider/model 的形式，比如 opencode/claude-opus-4-6。也就是说，你先选 provider，再选它下面的具体模型。([docs.openclaw.ai](https://docs.openclaw.ai/concepts/model-providers?utm_source=chatgpt.com))
十二、在 onboarding 里接入模型，到底是怎么填的
如果你是第一次装，最稳的方法不是手改配置文件，而是直接在 onboarding 里做。官方 Getting Started 也明确说了：向导会带你完成 provider 选择、API Key 设置、Gateway 配置和默认模型选择。([docs.openclaw.ai](https://docs.openclaw.ai/start/getting-started?utm_source=chatgpt.com))
你真正会遇到的动作，基本就是下面这几步：
①选择 provider例如 OpenAI、Anthropic、Venice、Ollama、OpenCode 等。第一轮只选一个。
②输入认证信息如果是 API Key 路线，就粘贴 API Key；如果是 OAuth 路线，就会跳登录授权。
③选择默认模型官方向导会探测可用模型，并让你选一个默认 primary model。先选一个你最熟悉、最稳的。
④完成模型检查onboarding 会做模型检查，并提醒你是否缺 auth、模型是否未知或没配好。
十三、API Key 到底怎么放，哪种方式更适合新手
官方当前支持 OAuth 和 API Key 两大类认证。对本地长期运行的 Gateway 来说，官方文档明确提到：API Key 往往是更可预测的选择。([docs.openclaw.ai](https://docs.openclaw.ai/gateway/authentication?utm_source=chatgpt.com))
而在 onboarding 里，Key 的保存又分两种理解方式：
方式 A：直接在向导里输入 Key
适合新手快速跑通。优点是最省事，缺点是后面迁移环境时不如环境变量方案清晰。
方式 B：用环境变量 / SecretRef
更适合长期使用。官方文档里明确写了：在非交互模式下，可以用 --secret-input-mode ref，让配置写成 env-backed refs，而不是明文值。([docs.openclaw.ai](https://docs.openclaw.ai/cli/onboard?utm_source=chatgpt.com))
如果你是第一次装，我建议：先跑通，再升级到环境变量方案。不要因为一开始研究“最规范存储方式”，把第一次成功拖没了。
十四、几个典型 provider，到底怎么接
为了让你有“手感”，我把几种最常见的 provider 接法压缩成最实用口径：
1）OpenAI可以走标准 API Key，也可以走 Codex OAuth。官方 OpenAI provider 文档里两种都支持。第一次上手更简单的是 API Key；如果你明确要走订阅/OAuth 生态，再选 openai-codex。([docs.openclaw.ai](https://docs.openclaw.ai/providers/openai?utm_source=chatgpt.com))
2）Anthropic官方支持在 onboarding 里直接选择 Anthropic API key，也支持 setup-token 路线。第一次最稳的还是标准 API Key。([docs.openclaw.ai](https://docs.openclaw.ai/providers/anthropic?utm_source=chatgpt.com))
3）Venice官方 provider 文档写得很清楚：你可以设环境变量 VENICE_API_KEY，也可以直接跑 openclaw onboard --auth-choice venice-api-key，向导会显示可用模型并让你选默认模型。([docs.openclaw.ai](https://docs.openclaw.ai/providers/venice?utm_source=chatgpt.com))
4）Ollama这是本地模型路线。官方文档里写明：当你设置好 OLLAMA_API_KEY（或 auth profile）且不手写 models.providers.ollama 时，OpenClaw 会从本地 127.0.0.1:11434 自动发现模型。你可以先用 ollama list 看本地模型，再用 openclaw models list 看 OpenClaw 是否已经识别到。([docs.openclaw.ai](https://docs.openclaw.ai/providers/ollama?utm_source=chatgpt.com))
十五、给你两个最实用的接入示例：OpenAI 和 Ollama
前面讲的是原理和路径，这里开始给你真正能照着做的示例。第一个是最常见的 OpenAI API Key 路线，第二个是很多人后面会用到的 Ollama 本地模型 路线。
示例 A：用 OpenAI API Key 接入
适合谁：你已经有 OpenAI 的 API Key，想先把 OpenClaw 跑起来，不想折腾本地模型。
具体怎么做：
1. 先运行 openclaw onboard。
2. 在 provider 选择阶段，选 OpenAI。
3. 在认证阶段，选择 API Key 路线，不要先选 OAuth。
4. 把你的 OpenAI API Key 粘贴进去。
5. 当向导让你选默认模型时，只选一个主模型，不要一开始选太多。
6. 完成后，立刻跑 openclaw models status 和 openclaw dashboard 做验收。
示例 B：用 Ollama 本地模型接入
适合谁：你想在本地跑模型，或者后面想减少外部 API 依赖。
具体怎么做：
1. 先确认你电脑里已经装好了 Ollama。
2. 先在本地拉一个你准备给 OpenClaw 用的模型。
3. 跑 ollama list，确认这个模型已经真的在本地了。
4. 再运行 openclaw onboard，provider 选择 Ollama。
5. 确保 Ollama 服务在本机默认地址运行，也就是 127.0.0.1:11434。
6. 完成后，跑 openclaw models list，看 OpenClaw 是否已经识别到本地模型。
7. 再跑 openclaw dashboard，发一条简单测试指令验证是否能正常回复。
Ollama 这条路的关键，不是“装了 Ollama”就行，而是：本地模型真的在、本地服务真的起着、OpenClaw 真的识别到了它。这三件事少任何一个，最后都会表现成“dashboard 能开，但模型不回”。
十六、模型接完以后，怎么确认它真的生效了
很多人以为“填完 Key”就算完了，不对。模型接入的验收，一定要多看一步。官方给了最直接的命令：openclaw models status。你甚至可以加上 --probe 做实时探测，但要注意，这会发真实请求，可能消耗额度。([docs.openclaw.ai](https://docs.openclaw.ai/cli/models?utm_source=chatgpt.com))
你分别该看什么：
openclaw models list：系统现在识别到了哪些 provider/model。
openclaw models status：当前默认模型、fallback、auth 状态是否解析正常。
openclaw models status --probe：真正去探模型 auth 是否可用。适合你怀疑 Key 填错了的时候用。
十六、如果模型接入失败，最常见的表现是什么
①Dashboard 能开，但发消息没有正常回复这通常不是安装问题，而是模型 auth 没配好，或默认模型没设成功。
②models list 能看到模型，但 models status 有 auth 异常这说明 catalog 识别到了，但认证没有真正过。
③status 正常，但 probe 失败重点查 API Key、本机环境变量、provider 选错、默认模型名输错。
④一开始填的是明文 Key，后面换成环境变量后失效通常是当前 shell 没拿到 env，或 SecretRef 指向的环境变量为空。官方 onboarding 文档明确说过：ref 模式要求对应 env 在当前进程里真的存在。([docs.openclaw.ai](https://docs.openclaw.ai/cli/onboard?utm_source=chatgpt.com))
十一、第五步：真正跑通第一次会话
很多教程写到这里就结束了，但真正的实操不是“安装结束”，而是“第一次用起来”。官方给了一个很重要的入口：Dashboard。
跑这条命令后，你可以直接在浏览器里打开 OpenClaw 的控制界面聊天，不需要你先去配 Telegram、WhatsApp 这些渠道。对于新手来说，这是最好的第一步。
这里不要一上来就测试复杂任务。第一轮最稳的做法，是发一条你能立刻判断对错的简单指令，比如：
只要它能稳定返回，说明你这条链路已经通了：CLI 装好了、Gateway 在、模型能用、Dashboard 能连、会话能跑。
十二、第六步：创建第一个 Agent，不要拖到后面
OpenClaw 不是只让你“聊天”的，它本质上是 Agent 工作方式。所以第 02 篇不能只停在打开 dashboard。你至少要知道，第一个 Agent 怎么建。
这里你可以先随便起一个名字，比如 xuanpin、listing、kefu。重点不是名字，而是你第一次建立起“一个独立 Agent”的概念。后面你做选品员、客服员、文案员，都会从这里长出来。
如果后面你想重新配置，不用重装，直接记住两个入口：
十三、你真正应该记住的 5 条验证命令
✓ openclaw --version：CLI 有没有装成功
✓ openclaw doctor：当前配置有没有阻塞性问题
✓ openclaw gateway status：Gateway 有没有真的跑起来
✓ openclaw status：本地整体状态是不是正常
✓ openclaw dashboard：第一次会话能不能真正打开并使用
十四、报错了，先按这个顺序排，不要乱改
①openclaw 找不到先看 Node、npm、PATH，再重开 PowerShell，不要先重装系统。
②Gateway 没起来先看 gateway status，再看 doctor，再看 logs。不要一上来就怪模型。
③Dashboard 打不开或连不上先看 gateway status、status、doctor；如果还不行，再看日志。排查顺序永远是“状态 → 网关 → 日志”。
④装好了但聊不起来先确认模型认证是不是已经填好，不要把“安装成功”和“模型可用”混为一谈。
⑤Windows 下老是不稳定如果你已经能装起来，但长期不稳，就别死磕原生 Windows，下一步切 WSL2 往往更省事。
十五、如果你决定切 WSL2，最短路径是什么
这一篇主体还是 Windows 原生，但你至少要知道：如果原生 Windows 折腾半天不稳，最短路径并不复杂。官方对 Windows 的推荐路线，就是用 WSL2 + Ubuntu，在 Linux 环境里跑 OpenClaw。
装好 WSL2 之后，再进入 Ubuntu，继续按官方安装脚本走即可。后面如果你准备长期运行 Gateway，官方也给了 gateway install、enable-linger 等更稳定的方案。
到这里，你已经不是“知道 OpenClaw 是什么”了，而是已经把它装到了自己的电脑上，并跑通了第一条链路。
下一篇，我们就不再停留在安装，而是开始进入真正会产生业务价值的部分：OpenClaw 怎么和你现有的跨境工具联动起来。
下一篇
OpenClaw与主流跨境工具的联动配置——把 AI 从单点工具，接进你的店铺数据流和运营流程。
🎁 本期彩蛋：OpenClaw本地安装检查清单
我整理了一份最适合新手的本地安装检查清单，从安装命令、Node 版本、Gateway 状态、Dashboard 打开、Agent 创建，到高频报错排查都做成了一页式流程。你照着核对，基本不会跑偏。
关注公众号，回复「安装清单」，免费领取
