企业官网建设流程全解析

1. 为什么要在 Windows CMD 里装 OpenClaw

OpenClaw 是一个跑在终端里的 AI 编程助手，社区里习惯叫它“龙虾”。它和网页版对话工具最大的区别在于：所有操作都在命令行完成，读文件、改代码、跑命令、看报错，不用在浏览器和编辑器之间来回切。对于习惯 CMD 的 Windows 用户来说，装好之后输入claw就能直接对话，响应链路短，适合日常查命令、写脚本、排查环境问题。

这篇教程解决的是从零到跑通的全链路：Python 环境检查、pip 安装 claw 包、控制台初始化、环境变量配置，以及用 TaoToken 统一 Key 完成接口连通性验证。适合刚接触命令行 AI 工具的新手，也适合之前装过但卡在“不是内部或外部命令”这类报错上的朋友。整个过程不需要管理员权限，普通 CMD 窗口就能完成。

我试过在一台没装过 Python 的 Windows 10 机器上从头走一遍，踩过的坑主要集中在 PATH 配置和 Key 读取顺序上，下面会把每一步的命令和预期输出都写清楚，你照着敲就行。

2. 前置准备：Python 环境与 TaoToken Key

2.1 检查 Python 是否可用

打开 CMD（Win+R 输入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 统一 Key

OpenClaw 本身是客户端，需要接一个模型服务才能对话。TaoToken 提供统一的 API Key，一个 Key 可以调用多种模型，省去分别申请各家账号的麻烦。获取步骤：

打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册登录后进入控制台，在 API Keys 页面创建一个新 Key，复制保存。这个 Key 后面要写进环境变量，格式通常以sk-开头。

控制台地址：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

API Keys 页面：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

接口文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

API 基础地址是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_KEY=sk-你的Key set TAOTOKEN_BASE_URL=https://taotoken.net/api set OPENCLAW_MODEL=claude-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/api，OpenClaw 会自己拼接/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 Plan：

https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

模型对话调试入口：

https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

完整的接口参数和错误码说明在文档里：

https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

Key 管理页面：

https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

最后提醒一个实操细节：每次改完环境变量，一定要新开 CMD 窗口再测，旧窗口读的还是旧值。这个坑我踩过不止一次，排查半天发现是窗口没刷新。