1. 国内 Windows 装 OpenClaw 到底卡在哪OpenClaw 是一个可以跑在本地、通过浏览器交互的 AI 工具链入口支持接入云端模型和 Ollama 本地模型适合想在自己 Windows 电脑上搭一套私有 AI 工作台的人。它的安装脚本默认走 GitHub 拉依赖国内网络环境下经常卡在 Preparing environment 或 Installing OpenClaw 这两步表现就是命令行一直转圈、十几分钟没动静。另一个高频问题是装完之后网页端右上角显示 offline原因是首次访问没有带 token而不是服务没起来。这篇教程聚焦国内 Windows 环境把两条安装路径都走一遍一条是 PowerShell 直装一条是 WSL 子环境安装。同时给出 Ollama 本地模型的接入骨架以及用 TaoToken 统一 Key 管理云端模型调用的配置方式。你不需要有 Linux 基础WSL 部分我会把每条命令的用途说清楚。装完之后PowerShell 和 WSL 两个终端都能连上同一套模型配置切换终端不用重新配 Key。先说清楚整体结构OpenClaw 本体负责界面和会话管理模型来源分两类一类是云端 API通过 TaoToken 统一 Key 调用一类是本地 Ollama 服务。两者可以同时存在在配置里按 provider 区分。下面按安装、配置、验证、排错的顺序展开。2. 装之前先把 TaoToken 的 Key 准备好TaoToken 在这里的角色是统一模型调用入口。你可以在官网注册后拿到一个 API Key然后在 OpenClaw 的配置里把 base_url 指向 TaoToken 的 API 地址模型名按文档填。这样做的实际好处是PowerShell 和 WSL 两套环境共用同一个 Key不用为每个终端单独申请换模型时也只改一处配置。具体操作路径打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台在 API Keys 页面创建一个新 Key。创建时建议给 Key 起个能认出来的名字比如 openclaw-win方便后面在多个工具间区分。Key 只显示一次复制后先存到记事本里。拿到 Key 之后接入文档在 https://taotoken.net/api 里面有 base_url 和模型名的填写格式。注意 API 地址不带 UTM 参数直接写 https://taotoken.net/api 即可。如果你后面要长期跑编码类任务或者 Agent 流程可以看一下 Coding Plan 页面按用量选套餐比单次调用更划算。注意Key 不要直接写进会提交到 Git 的配置文件里。本地测试可以先放环境变量后面配置章节会给两种写法。3. PowerShell 直装 OpenClaw 的完整命令PowerShell 路径适合不想折腾 WSL 的人。以管理员身份打开 PowerShell先确认执行策略允许运行脚本Get-ExecutionPolicy如果返回 Restricted临时放开当前会话Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass然后执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex这条命令会下载安装脚本并立即执行。安装过程会自动拉取依赖、下载 OpenClaw 本体最后进入交互式设置界面。看到蓝色的 OpenClaw installed successfully 就说明本体装好了接下来会跳到设置流程。设置流程里几个关键选择模型提供商这一步可以先 skip for now因为我们要统一用 TaoToken 的 Key后面手动写配置更可控Channel 按默认走hooks 建议至少勾选 command-logger 和 session-memory前者记录命令历史后者保留会话上下文对后面排查问题有帮助。安装服务时如果之前装过选 reinstall没装过选 install。装完先跑一次依赖检查openclaw doctor没有报错输出就说明依赖完整。如果有报错执行修复命令openclaw doctor --fix修复完再跑一次 doctor 确认。这一步别跳过依赖缺失会导致后面 gateway 起不来表现是网页端一直 offline。4. WSL 路径安装与国内加速处理WSL 路径适合已经在用 Ubuntu 子环境、或者想让 OpenClaw 跑在 Linux 环境里的人。先在 Windows 里装好 WSL 和 Ubuntu进入 Ubuntu 终端后先更新系统sudo apt update sudo apt upgrade -y然后执行官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash这个脚本分三步装依赖mvn 和 node.js、下载 OpenClaw、进入配置。国内环境最容易卡在第 1 步和第 2 步。如果卡在第 1 步 Preparing environment手动装 Node.js用国内镜像装 nvmcurl -o- https://gitee.com/mirrors/nvm/raw/v0.40.1/install.sh | bash source ~/.bashrc然后装 Node.js 22nvm install 22 nvm use 22 nvm alias default 22 node -v npm -vnode -v 应输出 v22.x.x。如果卡在第 2 步 Installing OpenClaw说明脚本在从 GitHub 拉包时超时了换备选安装脚本curl -fsSL https://clawd.org.cn/install.sh | bash备选脚本装完后后续命令前缀从 openclaw 变成 openclaw-cn这点要记住否则会提示 command not found。装完同样跑依赖检查openclaw-cn doctor有报错就执行 openclaw-cn doctor --fix。WSL 环境下还要确认 Ollama 服务能被访问到这个在验证章节讲。5. 可复制的 settings.json 与 config.toml 骨架OpenClaw 的配置分两块一块是模型 provider 配置一块是 gateway 和 hooks 配置。下面给两份骨架你按自己的路径和 Key 替换占位符。settings.json 放在 OpenClaw 配置目录下Windows 路径通常是 %USERPROFILE%.openclaw\settings.jsonWSL 下是 ~/.openclaw/settings.json。内容如下{ providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, models: { default: 按接入文档填模型名 } }, ollama: { type: ollama, baseUrl: http://127.0.0.1:11434, models: { default: qwen2.5:7b } } }, defaultProvider: taotoken }config.toml 管 gateway 和 hooks放在同目录下[gateway] port 18789 host 127.0.0.1 [hooks] command-logger true session-memory true [ollama] enabled true endpoint http://127.0.0.1:11434WSL 环境下如果 Ollama 装在 Windows 侧endpoint 要改成 Windows 主机地址不能写 127.0.0.1因为 WSL 的 localhost 指向的是子环境自己。具体地址在 WSL 里执行 cat /etc/resolv.conf 看 nameserver 那一行通常是 172.x.x.x。改完配置后重启 gatewayopenclaw gateway restartPowerShell 下对应命令是 openclaw gateway restart备选安装的用 openclaw-cn gateway restart。6. 验证 Ollama 连通性与首次请求先确认 Ollama 服务本身在跑。Windows 侧打开 PowerShellollama list能看到模型列表说明服务正常。如果提示连接失败先启动 Ollama 应用或执行 ollama serve。然后测一下 API 端口curl http://127.0.0.1:11434/api/tags返回 JSON 里有 models 数组就说明 API 通了。WSL 侧验证时把地址换成第 5 节查到的 Windows 主机地址curl http://172.x.x.x:11434/api/tags两边都通之后启动 OpenClaw 并拿带 token 的地址。PowerShell 直装版执行openclaw dashboard --no-openWSL 备选安装版执行openclaw-cn dashboard --no-open命令会输出一个带 token 的网址形如 localhost:18789/?tokenxxxx复制到浏览器打开。首次访问必须带这个 token否则右上角会显示 offline。打开后进入对话界面在模型选择里切到 ollama provider发一条测试消息比如「用一句话说明你现在用的是哪个模型」。如果返回内容且没有报错说明本地模型接入成功。再测 TaoToken 云端 provider切到 taotoken provider发同样的测试消息。如果返回 401检查 Key 是否复制完整如果返回 404检查 baseUrl 是否写成了带路径的地址正确写法是 https://taotoken.net/api不要多加 /v1。两个 provider 都能返回内容说明统一 Key 和本地模型双通道都打通了。7. 本篇常见报错排查offline 状态不消失九成是没带 token 访问。重新执行 dashboard --no-open 拿新链接注意 token 有时效过期就再生成一次。不要直接访问 localhost:18789 裸地址。openclaw 命令找不到WSL 下用备选脚本装的命令是 openclaw-cn不是 openclaw。PowerShell 下如果提示找不到检查安装目录是否加进了 PATH重开一个终端再试。Ollama 连接被拒绝Windows 侧确认 Ollama 应用在运行WSL 侧确认 endpoint 写的是 Windows 主机地址而不是 127.0.0.1。另外检查 Windows 防火墙有没有拦 11434 端口。gateway 起不来先跑 doctor 看依赖再跑 doctor --fix 修复。如果端口 18789 被占用改 config.toml 里的 port 换一个然后重启 gateway。模型返回空内容检查 settings.json 里模型名是否和接入文档一致模型名写错通常不会报错但会返回空。Ollama 侧用 ollama list 确认模型确实拉下来了。更新后配置丢失更新前备份 settings.json 和 config.toml。网页端点 update now 没反应时在对话窗口回复「需要」让它跑诊断修复后回复重启 gateway再点更新。排错时如果涉及 Key 和接入地址的确认直接对照接入文档 https://taotoken.net/api 核对字段格式比在网页端反复改配置靠谱。网页端改 provider 容易把已有配置覆盖掉这也是前面建议手动写配置文件的原因。8. 后续怎么用这套环境装好之后日常使用就三件事启动 Ollama、启动 OpenClaw gateway、浏览器打开带 token 的地址。PowerShell 和 WSL 两套环境共用同一份 settings.json 里的 TaoToken Key换终端不用重新配。本地 Ollama 适合跑不需要联网的轻量任务云端 provider 适合需要更强模型能力的场景在对话界面里按需切换即可。如果你后面要接编码类 Agent 或者长期跑自动化流程建议去 Coding Plan 页面看一下用量套餐比按次调用更稳定。模型对话入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 的模型对话页可以先用它验证 Key 和模型名是否配对正确再去改 OpenClaw 配置能省不少排查时间。控制台里可以随时查看 Key 的调用记录发现异常调用及时轮换。