1. Windows 上跑 OpenClaw为什么我最后选了 WSL2 这条路OpenClaw 是一个面向本地运行的 AI 编码代理工具能读取项目文件、执行命令、按任务链自动改代码适合想把 Agent 能力落到自己机器上的开发者。它的原生运行环境是 Linux官方安装脚本是 bash 脚本直接扔进 Windows 的 PowerShell 里会各种水土不服。我一开始也试过纯 Windows 方案Node 装好了、Git 装好了结果脚本里的路径分隔符、权限模型、进程管理全对不上跑两步就断。后来换成 WSL2整个流程顺了很多。WSL2 本质是在 Windows 里跑一个轻量 Linux 虚拟机文件系统、网络、进程都是真 Linux 语义OpenClaw 的安装脚本能原样执行。Windows 这边你照常用 PowerShell 做初始化、装 Node、管文件Linux 那边负责跑 OpenClaw 本体两边通过/mnt/c/...互访。这篇就把这套组合从零跑通包括 PowerShell 初始化、WSL2 安装、Node 依赖、config.toml和settings.json骨架最后接上 TaoToken 的统一 Key/API 通道让模型请求走一个入口。适合谁看手上是 Windows 10/11、想本地跑 OpenClaw 但被环境卡住的人已经装了 WSL2 但 Node 版本或配置对不上的人以及想把模型调用统一到一个 Key 上、不想每个工具单独配一遍的人。下面每一步都给可复制命令和预期输出照着敲基本能一次过。2. 前置准备PowerShell 初始化与 WSL2 安装2.1 用管理员 PowerShell 打开 WSL 功能在开始菜单搜 PowerShell右键选「以管理员身份运行」。先确认系统版本Windows 10 需要 2004 及以上Windows 11 全版本都行。winver弹窗里看版本号。然后一条命令装 WSL2微软现在把内核、发行版、默认设置打包在一起了wsl --install这条命令会启用虚拟机平台、装 WSL2 内核、拉一个默认 Ubuntu 发行版。跑完提示重启重启后 Ubuntu 会自动弹出来让你设用户名和密码。如果卡在下载可以先设默认版本再单独装发行版wsl --set-default-version 2 wsl --install -d Ubuntu-22.04装完验证wsl -l -v预期输出类似NAME STATE VERSION * Ubuntu-22.04 Running 2VERSION 那列必须是 2如果是 1用wsl --set-version Ubuntu-22.04 2转过来。这一步很关键WSL1 的文件系统和网络行为和真 Linux 差很多OpenClaw 的安装脚本在 WSL1 上容易出权限错误。2.2 进入 WSL 并更新基础包在 PowerShell 里直接敲wsl就进 Linux 了。第一次进去先更新源和基础工具sudo apt update sudo apt upgrade -y sudo apt install -y curl git build-essentialbuild-essential别省OpenClaw 有些依赖要编译原生模块缺 gcc/make 会在 npm install 阶段报错。装完确认git --version curl --version2.3 在 WSL 里装 Node 22OpenClaw 要求 Node 22。Ubuntu 自带的 apt 源版本太旧用 NodeSource 的源装curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs验证node -v npm -v预期v22.x.x和10.x.x以上。如果node -v还是旧版本检查which node是不是指向/usr/bin/node有时候之前装过 nvm 会打架hash -r刷新一下再试。注意Node 版本低于 22 时OpenClaw 安装脚本可能在依赖解析阶段直接退出报engine不匹配。先node -v确认再往下走。3. 安装 OpenClaw 与配置文件骨架3.1 执行官方安装脚本在 WSL 终端里跑curl -fsSL https://openclaw.ai/install.sh | bash脚本会检测 Node 版本、拉取 OpenClaw 包、装到用户目录下。跑完通常会提示把~/.openclaw/bin加进 PATH。手动加一下echo export PATH$HOME/.openclaw/bin:$PATH ~/.bashrc source ~/.bashrc验证安装openclaw --version能打印版本号就说明本体装好了。如果提示 command not found检查ls ~/.openclaw/bin里有没有可执行文件再确认 PATH 拼写。3.2 config.toml 骨架OpenClaw 的主配置放在~/.openclaw/config.toml。没有就新建mkdir -p ~/.openclaw nano ~/.openclaw/config.toml填入下面骨架字段按你实际项目路径改[core] workspace /home/yourname/projects/myapp log_level info max_concurrent_tasks 2 [model] provider openai-compatible base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY model_name claude-sonnet-4-20250514 timeout_seconds 120 [tools] shell_enabled true file_write_enabled true allowed_commands [npm, node, git, ls, cat]几个点解释一下。workspace是 OpenClaw 能操作的根目录别设成/或整个用户目录限制在具体项目里更安全。provider用openai-compatible因为 TaoToken 的 API 通道兼容 OpenAI 格式的请求结构。api_key_env指向环境变量名Key 本身不写进配置文件避免误提交。allowed_commands是白名单只放你确实需要的命令。3.3 settings.json 骨架部分 OpenClaw 版本用~/.openclaw/settings.json存运行时偏好和 config.toml 分工不同toml 管核心与模型json 管界面和会话行为。骨架{ session: { auto_save: true, history_limit: 50, context_window: 128000 }, ui: { theme: dark, show_token_usage: true }, telemetry: { enabled: false } }context_window按你实际用的模型填别超过模型上限。telemetry关掉本地跑没必要上报。4. 接入 TaoToken 统一 Key/API 通道4.1 拿 Key 并写进环境变量TaoToken 的作用是把模型调用收敛到一个 Key、一个 API 入口OpenClaw、其他编码工具、脚本都能共用不用每个工具单独配一遍。先去控制台建 Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite建完把 Key 写进 WSL 的环境变量别硬编码进配置文件echo export TAOTOKEN_API_KEYsk-你的key ~/.bashrc source ~/.bashrc echo $TAOTOKEN_API_KEY最后一条能打印出 Key 就对了。API 基础地址用https://taotoken.net/api这个不带任何查询参数直接填进 config.toml 的base_url。4.2 确认配置生效回到 OpenClaw 目录跑一次配置检查不同版本命令名可能略有差异常见的是openclaw config check或openclaw doctoropenclaw config check预期输出会列出 workspace、model provider、base_url、api_key 是否已设置。如果 api_key 显示 missing说明环境变量没被读到检查是不是在同一个 shell 会话里source过。5. 验证请求一次跑通本地部署5.1 发一条最小请求在 WSL 里直接 curl 一下 TaoToken 的 API确认 Key 和通道通curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: reply with ok}], max_tokens: 16 }返回 JSON 里choices[0].message.content有内容就说明 Key 和 API 通道都正常。这一步过了OpenClaw 里的模型调用基本不会因为鉴权失败。5.2 用 OpenClaw 跑一个真实任务进你的项目目录启动 OpenClawcd /home/yourname/projects/myapp openclaw run 列出当前目录下的文件并说明 package.json 里的依赖预期它会调用 shell 工具执行ls、读package.json然后返回一段说明。如果卡住不动看日志tail -f ~/.openclaw/logs/openclaw.log日志里能看到请求发往哪个 base_url、用的哪个 model、有没有 401/429。401 一般是 Key 问题429 是频率限制检查 Key 配额。5.3 想直接对话验证模型如果只想确认模型通道本身不想跑完整 Agent 流程可以用模型对话入口快速试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite选同一个模型发一句话返回正常就说明通道没问题再回去排查 OpenClaw 侧配置。6. 本篇常见错排查6.1wsl --install卡住或报 0x80370102这个错误码通常是 BIOS 里虚拟化没开。重启进 BIOS找 Intel VT-x 或 AMD-V设为 Enabled。开完再跑wsl --install。如果提示「此计算机不支持」确认系统版本够 2004或者手动启用两个功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart然后重启。6.2 Node 版本对但 npm install 报 engine 错多半是 WSL 里存在多个 Node。检查which -a node如果列出/usr/bin/node和~/.nvm/.../node两个说明 nvm 和 apt 装的打架。统一用一个建议保留 NodeSource 装的把 nvm 的从 PATH 里去掉或者反过来。改完hash -r再node -v。6.3 OpenClaw 报api_key missing三种可能环境变量没 source、config.toml 里api_key_env名字写错、或者 OpenClaw 启动的 shell 不是交互式 shell 读不到.bashrc。最稳的办法是把 Key 写进~/.profile而不是.bashrc或者启动前手动 export 一次export TAOTOKEN_API_KEYsk-你的key openclaw run ...6.4 请求返回 404 或路径不对检查base_url是不是写成了https://taotoken.net/api/带尾斜杠或者写成了/v1。config.toml 里填https://taotoken.net/apiOpenClaw 会自己拼/v1/chat/completions。多写一层路径就会 404。6.5 WSL 里访问 Windows 文件权限报错如果你把 workspace 设在/mnt/c/...Linux 侧对 NTFS 的权限映射可能让 OpenClaw 写文件失败。建议把项目放在 WSL 自己的文件系统里比如/home/yourname/projects/性能也更好。确实要访问 Windows 文件在/etc/wsl.conf里加[automount] options metadata,umask22,fmask11然后wsl --shutdown重启 WSL。6.6 长期跑编码任务想省心如果你打算把 OpenClaw 当日常编码代理用频繁跑任务、跑 Agent 链单次按量调用不如包月划算。Coding Plan 适合这种长期高频场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入文档在这里配置字段和兼容格式都列了https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaude Code 相关的接入说明单独有一页https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite整套跑下来WSL2 负责 Linux 语义PowerShell 负责 Windows 侧初始化Node 22 提供运行时config.toml 和 settings.json 定骨架TaoToken 把模型调用收敛成一个 Key。下次换机器照这个顺序重来一遍就行。
