1. OpenClaw 是什么为什么要在 PowerShell 里跑通统一 KeyOpenClaw 是近期在 GitHub 上热度飙升的开源项目社区里习惯叫它「龙虾」。它本质上是一个可扩展的智能体运行框架能通过配置文件接入不同的大模型通道再配合 skill、channel 等模块完成对话、代码辅助、消息转发等任务。对刚接触的人来说最容易卡住的地方不是功能本身而是首次安装和模型通道配置Node.js 版本不对、npm 全局目录没权限、settings.json 与 config.toml 写错字段都会让 OpenClaw 启动后发不出请求。这篇内容聚焦 Windows PowerShell 环境下的首次安装与启动把 Node.js、npm、qwen 模型调用串起来并用 TaoToken 统一 Key/API 通道完成 settings.json 与 config.toml 的骨架配置。适合谁手里有一台 Windows 机器、想快速验证 OpenClaw 能否正常发起模型请求、又不想在多个模型平台之间反复注册和切换 Key 的开发者。下面所有命令都可以直接复制到 PowerShell 里执行配置文件片段也可以按需替换。2. 前置准备Node.js、npm 与 TaoToken 统一 KeyOpenClaw 依赖 Node.js 运行环境npm 负责全局安装。建议 Node.js 使用 20.x LTS 或更高版本npm 随 Node.js 一起安装。先在 PowerShell 里确认版本node -v npm -v如果提示命令不存在去 Node.js 官网下载对应 Windows 安装包一路默认安装即可。安装完成后关闭并重新打开 PowerShell让环境变量生效。接下来是 TaoToken 的前置准备。TaoToken 提供统一的 Key/API 通道把不同模型的调用收敛到一个入口省去在多个平台分别申请和轮换 Key 的麻烦。你需要先拿到一个可用的 API Key并确认接入地址。相关入口如下官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址https://taotoken.net/api获取 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite注意API Key 只放在本地配置文件或环境变量里不要提交到 Git 仓库也不要在截图里暴露完整 Key。安装 OpenClaw 之前先把 npm 源切到国内镜像否则全局安装会非常慢npm config set registry https://registry.npmmirror.com npm install -g openclawlatest openclaw -version如果openclaw -version能输出版本号说明全局安装成功。这里有个踩过的坑一定要用管理员权限打开 PowerShell否则全局目录写入会失败后面启动 Gateway 时会报权限错误。3. 可复制配置settings.json 与 config.toml 骨架OpenClaw 的配置分两层settings.json负责运行参数和模型通道config.toml负责 skill、channel 等模块开关。先找到配置目录Windows 下通常在用户目录的.openclaw文件夹cd $env:USERPROFILE mkdir .openclaw -Force cd .openclaw3.1 settings.json 骨架新建或编辑settings.json把模型通道指向 TaoToken 的统一入口模型名填 qwen 系列{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, modelName: qwen-plus, timeout: 60000 }, gateway: { host: 127.0.0.1, port: 18789 }, log: { level: info } }字段说明用表格对照更清楚字段作用建议值provider通道类型openai-compatiblebaseUrl统一 API 入口https://taotoken.net/apiapiKey统一 Key你的 TaoToken KeymodelName调用的模型qwen-plus 或 qwen-turbotimeout请求超时毫秒600003.2 config.toml 骨架config.toml控制模块行为首次跑通只需要保留最小集[channel] type cli enabled true [skill] enabled [github, clawhub] [agent] name lobster max_tokens 2048 temperature 0.7提示channel先选cli等模型请求验证通过后再换成 iMessage 等通道避免一开始就被通道问题干扰。4. 验证请求PowerShell 命令与成功结果配置写完后先做一次最小化验证确认 OpenClaw 能通过 TaoToken 发起模型请求。启动 OpenClawopenclaw onboard在交互界面里选择Yes再选QuickStart。当它询问基座模型时选择 qwen。由于settings.json已经写入了 TaoToken 的baseUrl和 Key这里不会再跳转到其他平台的登录页而是直接使用统一通道。启动完成后用 PowerShell 发一条测试请求openclaw chat 用一句话说明什么是 OpenClaw如果返回类似下面的内容说明请求链路已经打通OpenClaw 是一个可扩展的智能体运行框架支持通过配置文件接入多种模型通道。也可以直接调用 API 做独立验证排除 OpenClaw 自身配置的干扰$headers { Authorization Bearer sk-你的TaoTokenKey Content-Type application/json } $body { model qwen-plus messages ({ role user; content ping }) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body能拿到choices字段的返回就证明 Key、地址、模型名三者一致。此时再回到 OpenClaw 界面输入测试对话应该能正常收到回复。5. 本篇常见错排查Gateway 没有权限这是最常见的问题根因是没用管理员权限安装。解决方式是关闭当前 PowerShell右键选择「以管理员身份运行」重新执行npm install -g openclawlatest再启动 Gateway。npm 安装卡住或超时确认镜像源已切换执行npm config get registry应返回https://registry.npmmirror.com。如果仍慢可以加--verbose看卡在哪一步。401 或 invalid api key检查settings.json里的apiKey是否完整、有没有多余空格以及baseUrl是否写成https://taotoken.net/api。Key 失效时去 API Keys 页面重新生成。模型名报错 model not foundmodelName要和通道支持的名称一致先用qwen-turbo做低成本验证再换qwen-plus。config.toml 解析失败TOML 对引号和缩进敏感enabled必须是数组字符串必须用双引号。改完可以用openclaw config check做语法校验。请求超时把timeout调到 60000 以上并确认本机网络能正常访问https://taotoken.net/api。6. 后续怎么用从验证到长期编码跑通最小链路后你可以按需扩展。想快速对比不同模型的回答效果直接进模型对话页面切换模型即可https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite如果你打算把 OpenClaw 用在长期编码或 Agent 任务上建议了解 Coding Plan把调用额度和通道统一管理https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite需要管理多个 Key 或查看调用情况时进控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite配置字段拿不准就翻接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你用 Claude Code 这类工具Anthropic 兼容通道的说明在这里https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_anthropicutm_campaignrewrite最后留一个实用习惯把settings.json里的 Key 换成环境变量引用例如apiKey: ${TAOTOKEN_API_KEY}然后在 PowerShell 里用$env:TAOTOKEN_API_KEYsk-...注入。这样配置文件可以安全地放进版本管理换机器时也只需要重新设置一次环境变量。