企业官网建设流程全解析

1. 为什么要在 Windows 上折腾 OpenClaw 2.7.9

OpenClaw 2.7.9 是一个能在 Windows 本机跑起来的 AI 数字员工框架，圈里人管它叫「小龙虾」。它和普通对话式 AI 最大的区别在于：它能真正操作你的电脑——读文件、整理目录、开浏览器、调本地工具，把一串自然语言指令拆成可执行的动作序列。适合谁？适合每天被重复性办公操作拖住的人，比如批量整理下载目录、汇总 Word 文档、定时抓取网页信息这类活儿。

我这次在 Windows 11 64 位上从零跑了一遍完整流程，踩了几个坑，也把 API 通道切到了 TaoToken，验证了连通性和实际调用。整篇按「下载安装包 → 解压部署 → 首次启动 → 配置 API → 验证请求 → 排错」的顺序写，每一步都给可复制的命令和配置片段。你照着做，大概二十分钟能跑通。

先说清楚一件事：OpenClaw 本身是本地运行的框架，它需要一个模型 API 通道来驱动任务理解与规划。默认通道不一定适合所有人，所以我会重点演示怎么把通道改到 TaoToken，让请求走https://taotoken.net/api。这一步做完，你才算真正拥有一个能干活的小龙虾。

下面所有操作都在 Windows 10/11 64 位环境下验证过，路径、命令、配置片段都可以直接抄。

2. 下载安装包与解压部署的完整路径

2.1 获取安装包

OpenClaw 2.7.9 的 Windows 安装包体积约 45.8MB，是一个 zip 压缩包。下载时建议用浏览器原生下载工具，别用某些下载器的多线程加速，容易把压缩包下坏。下载完成后确认后缀是.zip，如果浏览器自动改成了.zip.crdownload之类的，说明没下完，重新下。

安装包拿到后，先别急着双击。我试过用 Windows 自带的解压程序解压，结果启动时报「文件缺失」，后来换成 7-Zip 重新解压才正常。所以这一步别省：

# 推荐用 7-Zip 命令行解压，避免资源管理器自带解压的权限问题 # 假设安装包放在 D:\Downloads\OpenClaw-2.7.9-win.zip & "C:\Program Files\7-Zip\7z.exe" x "D:\Downloads\OpenClaw-2.7.9-win.zip" -o"D:\OpenClaw" -y

解压完成后，D:\OpenClaw下应该出现一个Openclaw-win文件夹。目录结构大致是这样：

D:\OpenClaw\Openclaw-win\ ├── Openclaw Windows 一键启动.exe ├── resources\ │ ├── app.asar │ └── runtime\ ├── config\ │ └── default.json └── logs\

如果你解压出来没有resources或config目录，说明压缩包不完整，重新下载解压。

2.2 关闭安全防护再启动

OpenClaw 需要模拟键鼠、读写系统目录，这些行为很容易被安全软件判定为风险操作。部署前把 360、腾讯电脑管家、火绒这类防护程序临时关掉，包括它们的后台服务。不是让你永久关闭，只是部署和首次启动期间别让它们拦截。

双击Openclaw Windows 一键启动.exe，如果弹出「Windows 已保护你的电脑」提示，点「更多信息」→「仍要运行」。这是 SmartScreen 的常规校验，不代表程序有问题。

2.3 设置安装目录

进入欢迎界面后点「开始使用」，会跳到安装路径配置页。这里有个硬性要求：路径全程纯英文，不能有中文、空格、特殊符号。下面这些是违规示例：

• D:\办公软件\OpenClaw（含中文）
• D:\Open Claw（含空格）
• D:\小龙虾工具（含中文）

合规的写法就是D:\OpenClaw这种。另外不建议装到 C 盘，长期跑会占系统盘空间。路径填好后勾选用户协议，点「开始安装」。

安装过程全自动，耗时 3 到 5 分钟，窗口别中途关。它会自动补齐 Git、Node.js、Python 这些运行组件，部署核心程序文件，安装浏览器自动化工具，最后生成配置文件和桌面快捷方式。

2.4 首次启动与 Gateway 初始化

安装完成后程序会自动拉起主界面。第一次启动时 Gateway 网关需要初始化，页面会显示等待提示，等 1 到 3 分钟。后续再打开就快了。

判断部署成功的标准很简单：主界面右上角状态栏显示Gateway 在线。如果一直显示离线，先别慌，后面第 5 节有专门的排查。

3. 把 API 通道切到 TaoToken 的可复制配置

OpenClaw 默认的模型通道不一定能用，或者速度不理想。我把它切到了 TaoToken，请求走https://taotoken.net/api。这一步的核心是改配置文件，把 Base URL、API Key、Model ID 三件套填对。

3.1 获取 API Key

先去 TaoToken 控制台创建一个 API Key。地址是：

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

创建后复制那串sk-开头的 Key，先存到记事本里，下一步要用。

3.2 修改 OpenClaw 配置文件

OpenClaw 的模型通道配置在D:\OpenClaw\Openclaw-win\config\default.json。用 VS Code 或记事本打开，找到model或provider相关字段。不同版本字段名可能略有差异，2.7.9 的结构大致如下。你可以直接替换成这份配置：

{ "gateway": { "host": "127.0.0.1", "port": 18789, "autoStart": true }, "model": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "modelId": "claude-sonnet-4-20250514", "maxTokens": 8192, "temperature": 0.3 }, "tools": { "browser": true, "fileSystem": true, "shell": false } }

几个关键点：

• baseUrl必须是https://taotoken.net/api，不要多加/v1或结尾斜杠，OpenClaw 会自己拼路径。
• apiKey填你刚创建的那串 Key。
• modelId填你要用的模型 ID，比如claude-sonnet-4-20250514或gpt-4o，具体可用列表在 TaoToken 文档里查。
• shell建议先设false，等跑通后再按需开启，避免误执行命令。

如果你更习惯用 TOML 格式，OpenClaw 也支持config.toml，等价写法：

[gateway] host = "127.0.0.1" port = 18789 autoStart = true [model] provider = "openai-compatible" baseUrl = "https://taotoken.net/api" apiKey = "sk-你的TaoToken密钥" modelId = "claude-sonnet-4-20250514" maxTokens = 8192 temperature = 0.3

改完保存，重启 OpenClaw。重启按钮在主界面右上角，或者直接关掉程序重新双击启动。

3.3 确认配置生效

重启后，主界面右上角的 Tokens 统计区域如果开始有数字变化，说明通道已经接上了。你也可以点「运行日志」，看到类似这样的行：

[model] provider=openai-compatible baseUrl=https://taotoken.net/api model=claude-sonnet-4-20250514 [gateway] listening on 127.0.0.1:18789

看到这两行，配置就算生效了。

4. 验证请求与调用成功的实操

配置改完不代表真能跑通，得发一条实际请求验证。OpenClaw 的验证分两层：先验证 Gateway 本地服务通不通，再验证模型通道能不能返回结果。

4.1 验证 Gateway 本地服务

打开 PowerShell，请求本地 Gateway 的健康检查接口：

Invoke-RestMethod -Uri "http://127.0.0.1:18789/health" -Method Get

正常返回应该是：

{ "status": "ok", "gateway": "online", "version": "2.7.9" }

如果返回Connection refused，说明 Gateway 没起来，去主界面点「重启网关」，或者检查 18789 端口有没有被占用：

netstat -ano | findstr 18789

4.2 验证模型通道

在 OpenClaw 主界面底部的输入框里，输入一条最简单的任务指令：

列出 D 盘根目录下所有文件夹的名称

按 Enter 发送。如果通道正常，几秒内会返回 D 盘根目录的文件夹列表。同时右上角 Tokens 统计会增加。这一步成功，说明从 OpenClaw → TaoToken → 模型 → 返回结果这条链路全通了。

你也可以用命令行直接测 TaoToken 通道，确认 Key 和 Base URL 没问题：

$headers = @{ "Authorization" = "Bearer sk-你的TaoToken密钥" "Content-Type" = "application/json" } $body = @{ model = "claude-sonnet-4-20250514" messages = @(@{ role = "user"; content = "回复两个字：通了" }) max_tokens = 32 } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri "https://taotoken.net/api/v1/chat/completions" -Method Post -Headers $headers -Body $body

返回里如果能看到choices数组和内容，说明通道完全正常。这个命令排错时特别有用，能把 OpenClaw 本身的问题和通道问题分开。

4.3 跑一条真实办公任务

验证通过后，试一条稍微复杂的指令，感受一下小龙虾的实际能力：

扫描桌面所有 .docx 文件，提取每个文件的标题和第一段内容，汇总成一个表格保存到 D:\summary.csv

这条指令会触发文件系统工具和模型规划。执行过程中主界面会显示步骤日志。跑完后去D:\summary.csv看结果。如果表格内容正确，说明你的 OpenClaw 已经能干活了。

5. 本篇常见报错排查对照

部署和配置过程中最容易撞上这几类报错，我按真实错误信息对照给方案。

5.1 401 Unauthorized

日志里出现：

[model] request failed: 401 Unauthorized

原因就三个：Key 填错、Key 过期、Base URL 写错。检查default.json里的apiKey是不是完整复制了，有没有多余空格。Base URL 必须是https://taotoken.net/api，别写成https://taotoken.net/api/v1。如果 Key 没问题，去控制台重新生成一个再试。

5.2 local proxy failed / connection refused

日志里出现：

[gateway] local proxy failed: connect ECONNREFUSED 127.0.0.1:18789

这是 Gateway 没起来。先确认主界面右上角是不是「离线」。如果是，点「重启网关」。还不行就检查端口占用：

netstat -ano | findstr 18789 tasklist | findstr <占用进程PID>

如果是安全软件拦了本地端口，把 OpenClaw 加入白名单，或者临时关掉防护再启动。

5.3 reading choices 报错

日志里出现：

[model] response parse error: reading 'choices' - undefined

这说明请求发出去了，但返回结构不对。常见原因是 Base URL 多写了/v1，导致路径变成/api/v1/v1/chat/completions。把baseUrl改回https://taotoken.net/api即可。另一个可能是modelId填了一个不存在的模型，返回了错误结构。去 TaoToken 文档确认模型 ID 拼写。

5.4 OAuth 相关报错

如果你在配置里误开了某些需要 OAuth 的 provider，日志会出现：

[model] oauth token missing or expired

OpenClaw 2.7.9 用 TaoToken 这种 openai-compatible 通道时不需要 OAuth。检查provider字段是不是被改成了anthropic或openai官方 provider。改回openai-compatible，只保留baseUrl+apiKey+modelId三件套就行。

5.5 Gateway 一直离线

排除了端口占用和防护拦截后，还离线的话，看日志文件D:\OpenClaw\Openclaw-win\logs\gateway.log。常见的是 Node.js 运行组件没装全。重新跑一遍安装程序，或者手动补装：

# 检查 Node.js 是否可用 node -v # 如果报 command not found，去 nodejs.org 下 LTS 版装一遍

5.6 安装时提示路径不合规

这个最简单，路径里只要有中文、空格、特殊符号就会终止。改成D:\OpenClaw这种纯英文无空格路径，重新点安装。

6. 跑通之后怎么继续用

到这一步，你的 OpenClaw 2.7.9 已经在 Windows 上跑起来了，API 通道也切到了 TaoToken。日常用法就是在底部输入框下发自然语言指令，它会自己规划步骤、调工具、返回结果。

几个实用建议。第一，指令描述越具体，执行越准。比如「整理下载目录」不如「把 D:\Downloads 里所有 .jpg 按修改日期分到对应月份文件夹」。第二，shell工具先别开，等熟悉了再按需打开，避免误执行。第三，Tokens 统计区域可以帮你判断通道是否正常，如果数字长时间不动，多半是通道断了，去日志里找401或connection refused。

如果你后面想把这套东西用到长期编码或 Agent 场景，可以看看 Coding Plan，通道和额度更适合高频调用：

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

接入文档和模型列表在这里，换模型或排查通道问题时对着查：

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

想先在线试试模型对话效果，不用装任何东西：

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

最后说个我踩过的坑：改完default.json一定要完全退出 OpenClaw 再重启，光点「重启网关」有时候不会重新读配置文件，导致你以为改错了，其实是没生效。彻底关掉进程再启动，配置才会重新加载。