1. Windows 上跑 OpenClaw 小龙虾为什么绕不开 WSL2OpenClaw 小龙虾是近期在开发者圈子里讨论度很高的一个开源 Agent 框架它能接入飞书、钉钉这类 IM 工具把大模型能力直接塞进你的聊天窗口里适合想自己搭一套私人助理、又不想被某个平台绑死的同学。它的运行环境对 Linux 更友好官方脚本基本是按 Ubuntu 写的所以 Windows 用户最省心的路径就是 WSL2 Ubuntu 24.04而不是硬啃原生 Windows。我这次把整条链路重新走了一遍从 Node.js、pnpm 环境准备到 WSL2 网络这个最容易翻车的坑再到用 TaoToken 统一 Key 接入模型、配置 settings.json 和 config.toml最后接飞书机器人。整个过程里真正卡人的不是 OpenClaw 本身而是三件事——WSL2 的网络模式、Node 版本选错、以及模型 Key 分散在好几个平台管理。这篇就按可复制的顺序拆开讲每一步都给命令和验证动作你照着敲基本能一次跑通。先说清楚适合谁有 Windows 电脑、会基本命令行、想自建 Agent 但不想折腾双系统的开发者。如果你完全没碰过终端建议先花十分钟熟悉一下cd、ls这类命令再往下看。2. 前置准备Node.js、pnpm 与 WSL2 环境2.1 Node.js 版本选择别踩 25 版这个坑Node.js 直接去官网下 LTS 版本就行安装过程一路下一步。这里有个实测结论不要选 25 版OpenClaw 依赖链里有些包在奇数大版本上会出现原生模块编译失败报错信息还特别隐晦。稳妥选 22 LTS 或 20 LTS。装完打开 CMD 验证node -v npm -v能打印出版本号就说明 PATH 配好了。如果提示「不是内部或外部命令」多半是安装时没勾选自动配置环境变量重装一遍勾上即可。2.2 pnpm 安装与 PowerShell 权限pnpm 是 OpenClaw 推荐的包管理器比 npm 省磁盘、装得快。全局装npm install -g pnpm pnpm -v如果pnpm -v报「无法加载文件因为在此系统上禁止运行脚本」这是 PowerShell 执行策略拦的。搜索 PowerShell右键以管理员身份运行执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认。这一步很多人忽略结果后面所有 pnpm 命令都跑不动。2.3 WSL2 与 Ubuntu 24.04 安装以管理员身份打开 PowerShell一条命令装 WSL2wsl --install装完必须重启而且是重启不是关机再开机一般要重启 2 到 3 次才能让虚拟化组件完全生效。重启后安装 Ubuntuwsl --install -d Ubuntu-24.04首次进入会让你设置 UNIX 用户名和密码密码输入时不显示是正常的。装完在 PowerShell 里wsl -l -v应该能看到 Ubuntu-24.04 且 VERSION 为 2。进 Ubuntu 后先更新源并装 gitsudo apt update sudo apt upgrade -y sudo apt install -y git curl2.4 WSL2 网络模式NAT 改镜像才是关键这是整篇最容易卡死的地方。默认 WSL2 走 NAT 模式虚拟机和宿主机网段隔离某些网络环境下会出现「能解析域名但连不上、下载没日志」的情况。解决办法是在 Windows 用户目录下建一个.wslconfig文件[wsl2] networkingModemirrored dnsTunnelingtrue autoProxytrue保存后 PowerShell 执行wsl --shutdown再重新进入。mirrored 模式让 WSL2 直接复用宿主机网络栈autoProxytrue会自动继承系统代理设置省去手动配的麻烦。改完在 Ubuntu 里ping www.baidu.com能通就说明网络通了。3. TaoToken 统一 Key 接入一个 Key 管所有模型3.1 为什么用 TaoToken 而不是各平台分别注册OpenClaw 支持多家模型但如果你每个平台都注册一遍、各自管一个 Key配置文件和额度管理会非常乱。TaoToken 的思路是提供一个统一入口一个 Key 就能调用多个主流模型切换模型只改配置里的模型名不用换 Key、不用重新充值。对经常在 Claude、GPT、DeepSeek 之间来回切的场景这个省事程度是实打实的。先去官网注册账号https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进控制台创建 API Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建好的 Key 形如sk-xxxx复制保存后面配置要用。想先测模型通不通可以直接在模型对话页试https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content3.2 settings.json 骨架OpenClaw 的模型配置放在~/.openclaw/settings.json在 Ubuntu 里创建mkdir -p ~/.openclaw nano ~/.openclaw/settings.json填入以下骨架把sk-你的Key换成实际值{ provider: openai-compatible, baseURL: https://taotoken.net/api, apiKey: sk-你的Key, model: claude-sonnet-4-20250514, temperature: 0.7, maxTokens: 4096 }注意 baseURL 用https://taotoken.net/api不要带任何多余路径。模型名按你实际要用的填TaoToken 支持的模型列表在文档里能查到https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content3.3 config.toml 骨架部分版本或插件走 TOML 配置路径~/.openclaw/config.toml[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key model_name claude-sonnet-4-20250514 [gateway] port 18789 host 127.0.0.1 [log] level info两个文件都配好OpenClaw 启动时会优先读 settings.jsonconfig.toml 作为补充。如果你只用一种保留 settings.json 就够。4. 安装 OpenClaw 与逐项验证4.1 安装命令在 Ubuntu 终端里执行官方安装脚本curl -fsSL https://clawd.org.cn/install.ps1 | bash如果这条卡住不动、没有任何日志输出八成还是网络问题回到 2.4 检查.wslconfig是否生效。安装成功的标志是终端打印出 OpenClaw 的版本号和「install success」字样。验证安装openclaw --version openclaw doctordoctor会逐项检查 Node 版本、配置文件、网络连通性哪一项红了就按提示修。4.2 验证模型请求配置好 Key 后先跑一次最小请求确认模型通openclaw chat 你好请回复ok如果返回正常文本说明 Key、baseURL、模型名三者都对。如果报 401是 Key 错了报 404是模型名或 baseURL 写错报超时是网络没通。4.3 启动网关openclaw gateway默认监听 127.0.0.1:18789。看到「gateway started」就说明服务起来了保持这个终端不要关。5. 飞书接入与 CC Switch、Cline 配置片段5.1 飞书机器人配置登录飞书开放平台进开发者后台创建企业自建应用。在「权限管理」里搜索im:把消息相关权限全部勾选。每次改完权限都要点「创建版本」并发布否则不生效。拿到 App ID 和 App Secret 后回到 Ubuntu 执行openclaw config按提示选择飞书通道填入 ID 和 Secret。私聊访问策略测试阶段选 open正式用选 pairing。然后openclaw gateway在飞书后台「事件订阅」里添加长连接搜索「接收消息」事件并添加再去权限管理开通通讯录权限同样要重新发布版本。手机飞书 App 里能收到机器人消息就算通了。5.2 CC Switch 配置片段如果你用 CC Switch 管理多个模型配置在它的配置文件里加一段{ name: taotoken, baseURL: https://taotoken.net/api, apiKey: sk-你的Key, models: [claude-sonnet-4-20250514, gpt-4o] }这样在 CC Switch 里一键切换不用手动改 OpenClaw 的配置。5.3 Cline 配置片段Cline 插件里选 OpenAI Compatible填{ apiProvider: openai, openAiBaseUrl: https://taotoken.net/api, openAiApiKey: sk-你的Key, openAiModelId: claude-sonnet-4-20250514 }保存后 Cline 就能走 TaoToken 的通道。长期做编码和 Agent 任务的话可以考虑 Coding Plan额度更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6. 常见报错排查路径报错一openclaw install卡住无日志。先ping www.baidu.com不通就是 WSL2 网络问题检查.wslconfig的 mirrored 模式和 autoProxy。通了还卡检查 DNS在/etc/resolv.conf里加nameserver 8.8.8.8。报错二pnpm 命令报执行策略错误。回 2.2 用管理员 PowerShell 改 RemoteSigned。报错三模型请求 401。Key 复制时带了空格或者 Key 已失效。去控制台重新生成https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content报错四飞书机器人不回复。九成是权限改了没重新发布版本。每次动权限都要创建版本并发布这是飞书的硬性要求。报错五gateway 端口被占用。改 config.toml 里的 port或者lsof -i:18789找到进程杀掉。报错六Node 原生模块编译失败。换回 22 LTS删掉node_modules和pnpm-lock.yaml重装。排查顺序建议固定成网络 → Node 版本 → 配置文件语法 → Key 有效性 → 平台权限。按这个顺序走基本不会绕远路。接入相关的完整文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content整套跑下来最花时间的其实是 WSL2 网络那一段一旦 mirrored 模式生效后面全是顺的。配置文件和 Key 都集中到 TaoToken 之后换模型就是改一行 model 名的事不用再满世界找 Key。