企业官网建设流程全解析

1. 为什么 Windows 新手也需要一个本地 AI 智能体

OpenClaw 是一个能在 Windows 上本地运行的 AI 智能体框架，它能听懂自然语言指令，然后自动帮你操作电脑——整理文件、批量处理表格、抓取网页信息、定时推送消息。适合谁？适合不想写代码、但想让电脑自己干活的普通办公用户。你不需要懂 Python，也不需要配环境变量，只要会解压文件、会点下一步，就能把它跑起来。

我见过太多人卡在第一步：下载完压缩包，解压出来一堆文件夹，不知道点哪个；或者双击启动程序，被 Windows Defender 弹窗吓退；再或者装完了，发现 Gateway 一直显示离线，模型根本调不通。这些问题不是因为你技术差，而是因为 OpenClaw 的部署流程里藏着几个必须提前知道的坑。

这篇攻略会带你从零走完整个流程：下载一键部署包、规范解压、绕过系统拦截、配置 Gateway 接入、验证模型调用。每一步都有可复制的命令和配置片段，你照着做就行。重点在于，我会把 Gateway 配置和模型通道单独拎出来讲清楚——因为很多人装完 OpenClaw 之后，卡在“智能体没反应”这一步，根本原因就是 Gateway 没连上模型服务。

OpenClaw 的核心价值在于“本地离线运行 + 无代码操作 + 全自动操控电脑”。它和普通对话 AI 的区别是：普通 AI 只给你文字建议，OpenClaw 直接帮你把事办了。比如你说“把 D 盘下载文件夹里的图片按日期分类”，它会自己打开资源管理器、创建文件夹、移动文件。这种能力来自它内置的键鼠模拟和文件系统操作模块，所以安全软件会误判，这也是为什么部署前必须关防护。

但光有 OpenClaw 还不够。它本身只是一个执行框架，真正理解你指令、生成操作步骤的“大脑”是背后的大模型。默认情况下，OpenClaw 需要你配置一个模型通道，也就是 Gateway。Gateway 负责把 OpenClaw 的请求转发给模型服务，再把模型返回的操作指令翻译成电脑动作。如果你不配 Gateway，OpenClaw 就是一个空壳，点啥都没反应。

所以这篇教程分两条线：一条是 OpenClaw 本体的安装部署，另一条是 Gateway 的模型通道配置。两条线都跑通，你才能看到第一个智能体任务真正执行。下面从下载安装包开始，一步步来。

2. TaoToken 前置：给 OpenClaw 配一个稳定的模型通道

OpenClaw 的 Gateway 需要对接一个模型 API 才能工作。你可以把它理解成：OpenClaw 是“手”，Gateway 是“神经”，模型 API 是“大脑”。手和神经都在本地，但大脑需要远程调用。问题来了——国内直接访问很多模型服务不稳定，延迟高、容易断连，OpenClaw 执行任务时一旦请求超时，整个自动化流程就卡死。

TaoToken 在这里的角色是统一 Key/API 通道。它把多个模型服务的接口聚合到一个入口，你只需要一个 API Key，就能在 OpenClaw 里调用不同的模型。对 Windows 新手来说，这省去了“注册多个平台、分别拿 Key、分别配 Base URL”的麻烦。你只要在 TaoToken 控制台生成一个 Key，然后把它填进 OpenClaw 的 Gateway 配置里就行。

具体怎么拿 Key？打开 TaoToken 官网，注册后进入控制台，找到 API Keys 页面，点“创建新 Key”。复制生成的 Key，格式类似sk-xxxxxxxx。这个 Key 就是你后面配置 Gateway 时要填的api_key字段。注意：Key 只显示一次，复制后先存到记事本里，别关页面。

TaoToken 的 API 入口是https://taotoken.net/api，这个地址要填到 Gateway 配置的base_url字段。不要加任何多余路径，也不要加斜杠结尾。模型 ID 根据你实际想用的模型填，比如claude-3-5-sonnet或gpt-4o。如果你不确定填哪个，先去 TaoToken 的模型对话页面试一下，能正常对话的模型 ID 就可以直接用到 OpenClaw 里。

这里有个关键点：OpenClaw 的 Gateway 配置文件和普通应用的配置文件格式不一样。它用的是 JSON 格式，路径在 OpenClaw 安装目录下的config/gateway.json。如果你装完之后找不到这个文件，说明安装过程没走完，或者你解压的版本不对。后面第三节会给出完整的配置片段，你直接复制粘贴改三个字段就行。

另外提醒一句：TaoToken 的 Key 不要泄露，不要提交到 Git，也不要写在公开的配置文件里。如果你要把 OpenClaw 配置分享给别人，记得先把 Key 替换成占位符。Gateway 配置里还有一个timeout字段，建议设成 30 秒以上，因为 OpenClaw 执行复杂任务时，模型返回的操作步骤可能比较长，超时太短会导致任务中断。

3. 可复制配置：Gateway JSON 片段与 OpenClaw 启动参数

OpenClaw 安装完成后，默认会在安装目录下生成一个config文件夹。如果没生成，手动新建一个。然后在里面创建gateway.json文件。下面是一个完整的配置片段，你直接复制，把api_key换成你自己的 TaoToken Key，model换成你想用的模型 ID：

{ "gateway": { "enabled": true, "base_url": "https://taotoken.net/api", "api_key": "sk-你的TaoTokenKey", "model": "claude-3-5-sonnet", "timeout": 30, "max_retries": 3, "retry_delay": 2 }, "agent": { "name": "OpenClaw-Windows", "workspace": "D:\\OpenClaw\\workspace", "auto_start": true, "log_level": "info" } }

注意几个细节：base_url必须是https://taotoken.net/api，不要写成https://taotoken.net/api/v1或者加斜杠。api_key填你从 TaoToken 控制台复制的完整 Key。model字段填模型 ID，如果你用 Claude 系列，填claude-3-5-sonnet；如果用 GPT 系列，填gpt-4o。workspace是你想让 OpenClaw 操作的文件夹路径，必须是纯英文路径，不能有中文和空格。

配置写完后，还需要在 OpenClaw 的启动脚本里指定 Gateway 配置文件的位置。如果你是用一键启动程序，它默认会读取config/gateway.json。但如果你手动启动，需要在命令行里加参数：

OpenClaw.exe --config "D:\OpenClaw\config\gateway.json" --gateway-enabled

如果你用的是 PowerShell，命令类似：

.\OpenClaw.exe --config "D:\OpenClaw\config\gateway.json" --gateway-enabled

启动后，OpenClaw 会先加载 Gateway 配置，然后尝试连接 TaoToken 的 API 入口。如果配置正确，界面右上角会显示“Gateway 在线”。如果显示离线，先检查base_url和api_key是否填对，再看网络能不能正常访问https://taotoken.net/api。

还有一个容易忽略的点：OpenClaw 的 Gateway 配置里，max_retries和retry_delay控制重试次数和间隔。如果你网络环境一般，建议把max_retries设成 3，retry_delay设成 2 秒。这样即使某次请求失败，OpenClaw 也会自动重试，不会直接报错退出。timeout设成 30 秒是保守值，如果你经常执行复杂任务，可以调到 60 秒。

配置改完后，一定要保存文件，然后重启 OpenClaw。不要只关窗口，要在任务管理器里确认 OpenClaw 进程完全退出，再重新启动。否则旧配置可能还在内存里，新配置不生效。

4. 验证请求：用模型对话确认 Gateway 连通

配置写完、OpenClaw 重启后，怎么确认 Gateway 真的连上了？最直接的方法是在 OpenClaw 主界面底部的输入框里发一条简单指令，比如“列出 D 盘根目录下的所有文件夹”。如果 Gateway 正常，OpenClaw 会先调用模型解析指令，然后执行文件系统操作，最后在界面显示结果。如果 Gateway 没连上，界面会提示“模型请求失败”或“Gateway 离线”。

但更稳妥的验证方式是先用 TaoToken 的模型对话页面单独测一下 Key 和模型 ID 是否可用。打开模型对话页面，选择你配置里填的同一个模型 ID，发一条“你好”，看能不能正常回复。如果能回复，说明 Key 和模型 ID 没问题，问题出在 OpenClaw 的 Gateway 配置上。如果不能回复，说明 Key 或模型 ID 有误，先去控制台检查。

另一个验证方法是直接用 curl 请求 TaoToken 的 API 入口，模拟 OpenClaw 的调用方式：

curl -X POST "https://taotoken.net/api/v1/chat/completions" \ -H "Authorization: Bearer sk-你的TaoTokenKey" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-3-5-sonnet", "messages": [{"role": "user", "content": "回复OK"}], "max_tokens": 10 }'

如果返回 JSON 里包含"content": "OK"或类似内容，说明 API 通道正常。注意：这个 curl 命令里的路径是/api/v1/chat/completions，但 OpenClaw 配置里的base_url只写到/api，OpenClaw 会自动拼接后面的路径。所以你在配置文件里不要写/v1/chat/completions，只写https://taotoken.net/api就行。

验证通过后，你可以试一个完整的智能体任务。比如在 OpenClaw 输入：“在桌面新建一个文件夹叫 TestClaw，然后在里面创建一个文本文档，写入当前时间”。如果 Gateway 和 OpenClaw 都正常，你会看到鼠标自动移动、文件夹自动创建、文档自动写入。这个过程不需要你手动操作，全是 OpenClaw 通过模型解析指令后自动执行的。

如果任务执行到一半卡住，先看 OpenClaw 的日志文件。日志默认在logs/openclaw.log，里面会记录每次 Gateway 请求的耗时和返回状态。如果看到401 Unauthorized，说明 Key 不对；如果看到timeout，说明网络延迟太高，把timeout调大；如果看到model not found，说明模型 ID 填错了。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

部署 OpenClaw 和配置 Gateway 的过程中，有几个报错几乎每个人都会遇到。下面逐个拆解原因和解决办法。

401 Unauthorized：这是最常见的错误，意思是 TaoToken 的 API Key 无效。可能原因有三个：Key 复制时漏了字符、Key 已经被删除、Key 前面多了空格。解决办法：重新去 TaoToken 控制台复制 Key，粘贴到gateway.json的api_key字段时，确保前后没有空格。如果你用的是记事本编辑，注意不要多按回车。改完后重启 OpenClaw。

local proxy failed：这个报错通常出现在 OpenClaw 启动时，提示本地代理连接失败。原因是 OpenClaw 的 Gateway 尝试通过本地代理端口转发请求，但代理没启动或者端口被占用。解决办法：检查gateway.json里有没有多余的proxy字段，如果有，删掉。OpenClaw 默认直连 TaoToken 的 API 入口，不需要本地代理。如果你之前配过其他代理工具，先把它们关掉，再重启 OpenClaw。

reading choices 报错：这个错误一般出现在模型返回格式异常时，OpenClaw 解析响应失败。常见原因是模型 ID 填错，或者 TaoToken 的 API 返回了非标准格式。解决办法：先用 curl 命令测试同一个模型 ID，看返回的 JSON 里有没有choices字段。如果没有，说明模型 ID 不对，换一个模型试。如果有choices但 OpenClaw 还是报错，检查gateway.json里model字段是否和 curl 里用的一致。

OAuth 相关报错：如果你在 OpenClaw 里看到 OAuth 认证失败，说明你误用了需要 OAuth 的模型服务。TaoToken 的 API 通道用的是 Bearer Token 认证，不需要 OAuth。解决办法：确认gateway.json里没有oauth相关字段，api_key填的是 TaoToken 的 Key，而不是其他平台的 OAuth token。如果你之前配过其他模型服务，把它们的配置删掉，只保留 TaoToken 的配置。

还有一个隐藏坑：OpenClaw 的 Gateway 配置里，base_url如果写成https://taotoken.net/api/（结尾带斜杠），会导致请求路径拼接错误，返回 404。解决办法：去掉结尾斜杠，只写https://taotoken.net/api。这个细节很容易忽略，但报错信息不会直接提示路径问题，只会显示“请求失败”。

如果你用的是 CC Switch 或 Cline MCP 这类工具来管理 OpenClaw 的模型配置，需要确保三件套完整：Base URL 填https://taotoken.net/api，Key 填 TaoToken 的 Key，Model ID 填你实际用的模型。缺任何一个，Gateway 都连不上。Codex 的auth.json也是类似逻辑，但 OpenClaw 不用auth.json，它用gateway.json，别搞混。

6. 跑通第一个智能体任务后的实用技巧

当你看到 OpenClaw 自动完成第一个任务后，可以开始试更复杂的指令。比如：“遍历 D 盘工作文件夹里所有 Excel 文件，把每个文件的第一个工作表名称提取出来，汇总到一个新表格里，保存到桌面”。这种任务涉及文件遍历、Excel 读取、数据汇总、文件写入，OpenClaw 会拆成多个步骤依次执行。

实测下来，指令描述越具体，执行精准度越高。不要只说“整理文件”，要说“把 D 盘下载文件夹里所有 .jpg 和 .png 文件，按修改日期创建子文件夹，移动到对应文件夹里”。OpenClaw 对文件扩展名和路径的识别比较准，但对模糊描述容易理解偏差。

如果你想让 OpenClaw 长期自动运行，可以在gateway.json里把auto_start设为true，然后把 OpenClaw 加到 Windows 启动项里。这样每次开机后，Gateway 会自动连接 TaoToken，OpenClaw 处于待命状态。你随时发指令，它随时执行。

最后提醒：OpenClaw 的 Gateway 配置里，workspace字段决定了它能操作哪个文件夹。为了安全，不要把workspace设成 C 盘根目录或系统文件夹。建议单独建一个工作目录，比如D:\OpenClaw\workspace，所有自动化任务都在这个目录里操作。这样即使指令有误，也不会影响系统文件。

如果你在配置过程中遇到其他报错，先去 TaoToken 的接入文档页面查一下 API 调用规范，确认base_url和认证方式没写错。大部分 Gateway 连接问题都是配置字段填错导致的，仔细核对一遍就能解决。