1. 为什么要在 Windows CMD 里装 OpenClawOpenClaw 是一个跑在终端里的 AI 编程助手社区里习惯叫它“龙虾”。它和网页版对话工具最大的区别在于所有操作都在命令行完成读文件、改代码、跑命令、看报错不用在浏览器和编辑器之间来回切。对于习惯 CMD 的 Windows 用户来说装好之后输入claw就能直接对话响应链路短适合日常查命令、写脚本、排查环境问题。这篇教程解决的是从零到跑通的全链路Python 环境检查、pip 安装 claw 包、控制台初始化、环境变量配置以及用 TaoToken 统一 Key 完成接口连通性验证。适合刚接触命令行 AI 工具的新手也适合之前装过但卡在“不是内部或外部命令”这类报错上的朋友。整个过程不需要管理员权限普通 CMD 窗口就能完成。我试过在一台没装过 Python 的 Windows 10 机器上从头走一遍踩过的坑主要集中在 PATH 配置和 Key 读取顺序上下面会把每一步的命令和预期输出都写清楚你照着敲就行。2. 前置准备Python 环境与 TaoToken Key2.1 检查 Python 是否可用打开 CMDWinR 输入cmd回车先确认 Python 能不能被调用python --version正常会输出类似Python 3.11.5。如果提示“不是内部或外部命令”说明 Python 没装或者没加进 PATH。去 python.org 下载 3.8 以上版本安装时务必勾选Add Python to PATH装完关掉当前 CMD 重新开一个再验证。再确认 pip 可用pip --version输出里会带 pip 版本号和对应的 Python 路径。如果 pip 报错可以用python -m ensurepip --upgrade修复或者直接用python -m pip代替pip执行后续命令。2.2 获取 TaoToken 统一 KeyOpenClaw 本身是客户端需要接一个模型服务才能对话。TaoToken 提供统一的 API Key一个 Key 可以调用多种模型省去分别申请各家账号的麻烦。获取步骤打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台在 API Keys 页面创建一个新 Key复制保存。这个 Key 后面要写进环境变量格式通常以sk-开头。控制台地址https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接口文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址是https://taotoken.net/api注意这个地址不带 UTM 参数配置时直接填这个。2.3 确认网络与权限CMD 不需要管理员权限但如果你公司电脑有安全软件拦截 pip 下载可能会卡在下载阶段。遇到这种情况先换pip install --upgrade pip试试或者用国内镜像源加速pip install openclaw -i https://pypi.tuna.tsinghua.edu.cn/simple镜像源只是加速下载不影响后续功能。3. 可复制配置pip 安装与环境变量3.1 安装 openclaw 包在 CMD 里执行pip install openclaw等待下载完成出现Successfully installed openclaw-x.x.x就说明装好了。如果之前装过旧版本用升级命令pip install --upgrade openclaw安装完成后验证包信息pip show openclaw输出里会显示版本号、安装路径、依赖包列表。记下 Location 那一行的路径后面排查问题会用到。3.2 配置环境变量OpenClaw 读取配置有两种方式环境变量和配置文件。推荐先用环境变量简单直接。在 CMD 里临时设置只对当前窗口有效set TAOTOKEN_API_KEYsk-你的Key set TAOTOKEN_BASE_URLhttps://taotoken.net/api set OPENCLAW_MODELclaude-sonnet-4-20250514如果要永久生效用setx命令setx TAOTOKEN_API_KEY sk-你的Key setx TAOTOKEN_BASE_URL https://taotoken.net/api setx OPENCLAW_MODEL claude-sonnet-4-20250514注意setx设置后需要新开一个 CMD 窗口才能读到。三个变量分别对应Key、接口地址、默认模型 ID。模型 ID 可以按需替换具体支持列表看接口文档。3.3 配置文件方式可选如果你更喜欢用配置文件OpenClaw 会在用户目录下读取~/.openclaw/config.json。在 CMD 里创建mkdir %USERPROFILE%\.openclaw notepad %USERPROFILE%\.openclaw\config.json写入以下 JSON{ api_key: sk-你的Key, base_url: https://taotoken.net/api, model: claude-sonnet-4-20250514, timeout: 60 }保存后关闭记事本。环境变量和配置文件同时存在时环境变量优先级更高。建议只保留一种方式避免排查时分不清读的哪个值。3.4 验证 claw 命令可用关掉 CMD 重新打开输入claw --version能输出版本号就说明命令已经进 PATH。如果提示“不是内部或外部命令”看第 5 节的排查。4. 验证请求首次运行与连通性测试4.1 启动交互模式在 CMD 里直接输入claw回车后进入交互对话模式界面会显示欢迎信息和当前使用的模型。第一次启动可能会提示你确认配置按提示回车即可。4.2 发一条测试消息在交互模式里输入你好请回复你的模型名称如果配置正确会看到模型返回内容。这一步验证的是 Key、Base URL、模型 ID 三者是否匹配。如果返回 401 或认证失败说明 Key 有问题如果返回连接超时检查 Base URL 是否写成了带路径的完整地址。4.3 用 curl 单独验证接口想排除 OpenClaw 本身的干扰可以在另一个 CMD 窗口用 curl 直接打接口curl -X POST https://taotoken.net/api/v1/chat/completions ^ -H Authorization: Bearer sk-你的Key ^ -H Content-Type: application/json ^ -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\ping\}]}注意 CMD 里换行用^JSON 里的引号要转义。如果这条命令能返回 JSON 结果说明 Key 和网络都没问题问题就出在 OpenClaw 的配置读取上。4.4 退出与常用命令在交互模式里输入exit回车退出回到普通 CMD 界面。几个高频命令claw --help claw --model claude-sonnet-4-20250514 claw --clear--help看所有参数--model临时指定模型启动--clear清空当前对话上下文。5. 常见报错排查401、proxy、choices 读取失败5.1 401 Unauthorized报错原文通常是Error: 401 Unauthorized - invalid api key原因有三种Key 复制时带了空格、Key 已过期或被删除、环境变量没生效。排查顺序先echo %TAOTOKEN_API_KEY%看 CMD 里读到的值对不对注意前后不能有空格。如果值是空的说明setx之后没重开窗口。Key 本身的问题就去控制台重新生成一个。5.2 local proxy failed / connection refused报错原文Error: local proxy failed: dial tcp 127.0.0.1:xxxx: connectex: No connection could be made这是 OpenClaw 尝试走本地代理但没找到服务。检查系统环境变量里有没有HTTP_PROXY或HTTPS_PROXY指向本地端口。如果有在 CMD 里临时清掉set HTTP_PROXY set HTTPS_PROXY然后重新启动 claw。TaoToken 的接口是直连的不需要额外代理配置。5.3 reading choices: unexpected end of JSON报错原文Error: reading choices: unexpected end of JSON input这个通常出现在接口返回了非 JSON 内容比如 HTML 错误页。原因可能是 Base URL 写错了比如多写了/v1或者少了/api。正确写法是https://taotoken.net/apiOpenClaw 会自己拼接/v1/chat/completions。用 4.3 的 curl 命令验证一下实际返回内容如果是 HTML说明地址不对。5.4 OAuth token expired报错原文Error: OAuth token expired, please re-authenticate如果你之前用过其他需要 OAuth 登录的工具配置可能被覆盖了。检查%USERPROFILE%\.openclaw\目录下有没有多余的 token 文件删掉后重新用 API Key 方式配置。OpenClaw 用 TaoToken 统一 Key 时不需要 OAuth 流程。5.5 claw 不是内部或外部命令这是 PATH 问题。找到 Python 安装目录下的 Scripts 文件夹通常在C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Scripts把这个路径加到系统环境变量 PATH 里或者用命令临时加set PATH%PATH%;C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Scripts关掉 CMD 重开再试。如果还是不行用python -m openclaw代替claw启动能跑起来说明包没问题只是入口脚本没进 PATH。6. 接入文档与 Coding Plan 入口配置跑通之后日常使用就是claw进交互模式需要换模型时用--model参数。如果你打算长期在终端里做编码任务或者想接 Agent 工作流可以看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content模型对话调试入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content完整的接口参数和错误码说明在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentKey 管理页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一个实操细节每次改完环境变量一定要新开 CMD 窗口再测旧窗口读的还是旧值。这个坑我踩过不止一次排查半天发现是窗口没刷新。