1. Windows 本地跑 OpenClaw 接 Qwen3到底卡在哪OpenClaw 是一个可以跑在本机的智能体框架能读写文件、执行命令、按目录结构批量生成内容适合想把大模型能力落到本地磁盘操作上的人。Qwen3 是通义千问的第三代开源模型14B 版本在消费级显卡或统一内存机器上能跑起来中文指令跟随不错。把这两个东西接在一起你就能在 Windows 上拥有一个不依赖外部网络、数据不出本机的本地龙虾对话闭环。但真动手时坑集中在三个地方。第一是依赖环境Node.js 版本不够或者用 npm 装依赖树直接卡死这是 Windows 上最常见的第一道墙。第二是模型服务地址本地 Qwen3 通常由 Ollama 或类似运行时暴露一个 OpenAI 兼容接口地址填错一个斜杠就连不上。第三是 config.toml 骨架字段名、endpoint 兼容模式、contextWindow 这些参数一旦对不上启动后要么验证失败要么对话时报上下文窗口太小。我试过在 Windows 11 上从零走一遍下面把每一步的命令、配置和验证动作都摊开写你照着复制就能跑通。核心交付物是一份可直接用的 config.toml 骨架以及启动后如何确认本地 Qwen3 真的被调起来。2. 前置准备Node.js、pnpm 与本地 Qwen3 服务2.1 版本要求与安装OpenClaw 对运行时版本有硬性要求Node.js 必须大于等于 v22.0.0包管理器强制推荐 pnpm因为 npm 在处理它的依赖树时容易卡死。Git 用于拉源码建议 2.53 以上安装时勾选 Git Bash后面很多命令在 Git Bash 里跑比 PowerShell 顺。先确认版本node -v npm -v pnpm -v git --version如果 pnpm 没装用 npm 全局装一次npm install -g pnpm装完再pnpm -v确认能输出版本号。这里有个细节pnpm 装完后如果命令找不到关掉终端重开一次让 PATH 刷新。2.2 拉源码与换镜像源源码从国内镜像拉速度快很多git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git cd openclaw-cn装依赖前先换 pnpm 镜像源否则某些包会卡在解析阶段pnpm config set registry https://registry.npmmirror.com/2.3 本地 Qwen3 服务要暴露什么本地 Qwen3 需要一个 OpenAI 兼容的 HTTP 接口。如果你用 Ollama 跑qwen3:14b它默认在http://127.0.0.1:11434/v1提供兼容端点API Key 随便填一个非空字符串即可比如ollama。如果你的模型服务在另一台机器上把 IP 换成那台机器的局域网地址比如http://192.168.40.137:11434/v1。先用 curl 确认这个端点活着curl http://127.0.0.1:11434/v1/models能返回模型列表说明服务正常再往下走。3. 可复制的 config.toml 配置骨架3.1 安装依赖与构建在 Git Bash 里执行路径用/d/openclaw-cn这种写法cd /d/openclaw-cn pnpm install pnpm ui:build pnpm buildpnpm install装依赖pnpm ui:build构建前端界面首次会自动装 UI 依赖pnpm build构建核心服务。三步都跑完再进初始化。3.2 初始化向导的关键选项pnpm openclaw onboard --install-daemon向导里几个选项要选对I understand this is powerful and inherently risky. Continue? 选 YES Onboarding mode 选 QuickStart Model/auth provider 选 Custom Provider API Base URL 填 http://127.0.0.1:11434/v1 API Key 填 ollama Endpoint compatibility 选 OpenAI-compatible Model ID 填 qwen3:14b Endpoint ID 填 ollama Model alias 填 ollama Select channel 选 Skip for now Configure skills now? 选 NO Enable hooks? 选 Skip for now How do you want to hatch your bot? 选 Do this later走到最后会显示 Verification successful说明模型端点验证通过。3.3 config.toml 骨架向导生成的配置在C:\Users\你的用户名\.openclaw\下。下面是一份可复制的骨架字段含义我标在注释里# OpenClaw 主配置骨架 [gateway] host 127.0.0.1 port 18789 [model] # 本地 Qwen3 的 OpenAI 兼容端点 base_url http://127.0.0.1:11434/v1 api_key ollama # 兼容模式本地运行时一般用这个 compatibility openai model_id qwen3:14b alias ollama # 上下文窗口Qwen3 支持较大窗口这里给足 context_window 40960 max_tokens 40960 [agent] # 智能体可操作的工作目录 workspace C:/Users/你的用户名/Desktop注意context_window和max_tokens这两个值。默认如果留小对话时会直接报错下一节会讲。4. 启动服务与验证请求4.1 启动网关与仪表板pnpm openclaw gateway pnpm openclaw dashboardgateway 是网关服务dashboard 打开仪表板。两个命令建议开两个 Git Bash 窗口或者一个后台跑。4.2 验证模型真的被调起来打开仪表板的聊天窗口发一句简单的话比如你好你是什么模型。如果返回内容里能看出是 Qwen3 的风格说明链路通了。更硬的验证是看日志pnpm openclaw logs --follow日志里应该能看到请求打到http://127.0.0.1:11434/v1并返回 200。4.3 跑一个真实任务在聊天窗口输入一个目录生成任务比如在桌面目录根据以下结构生成新目录每个目录下生成一个 txt 文件 --1 ----11 ------111 ------112 ----12 ------121 ------122 --2 ----21 ------211 ----22 ------221 ------222如果 OpenClaw 能在桌面创建出这套目录并写入 txt说明文件操作能力也通了。这一步是本地龙虾闭环的最终验证。5. 本篇常见错排查5.1 Model context window too small报错原文Agent failed before reply: Model context window too small (4096 tokens). Minimum is 16000.原因是配置里上下文窗口给太小。改C:\Users\你的用户名\.openclaw\openclaw.json把两个值调大contextWindow: 40960, maxTokens: 40960改完重启 gateway。5.2 连接被拒绝curl http://127.0.0.1:11434/v1/models如果连不上先确认本地 Qwen3 服务在跑。Ollama 的话执行ollama list看模型在不在ollama serve看服务起没起。地址里的127.0.0.1和localhost在某些环境不等价哪个通用哪个。5.3 pnpm install 卡住多半是镜像源没换。重新执行pnpm config set registry https://registry.npmmirror.com/然后删掉node_modules重装。如果还卡检查 Node.js 版本是否达标。5.4 验证失败但端点正常向导里 Endpoint compatibility 如果选错比如选成非 OpenAI 兼容模式验证会失败。回到向导重选OpenAI-compatible。API Key 不能留空填ollama这种占位值即可。6. 后续接入与长期使用建议本地 Qwen3 跑通后如果你还想接云端模型做对比或者需要更稳定的 API 通道可以在 TaoToken 上拿一个 API Key接入文档里有 OpenAI 兼容的调用方式填到 config.toml 的base_url和api_key就能切换。想先验证模型效果可以直接用模型对话页面试几句如果打算长期跑编码类或 Agent 类任务Coding Plan 的额度更划算。接入相关的 Key 和文档都在 API Keys 与接入文档里按需取用。本地这套配置的好处是数据不出机器适合处理敏感目录和离线场景。跑顺之后你可以把workspace指到具体项目目录让 OpenClaw 直接在里面干活。