1. Windows OpenClaw 安装前必须搞清楚的几件事OpenClaw 是一个能在 Windows 上本地运行的 AI 智能体工具你可以把它理解成一个能自己动手操作电脑的助手——它不只是聊天还能按你的自然语言指令去整理文件、批量处理表格、操控浏览器、汇总数据。适合谁适合不想写代码、但又想让电脑自动干重复活的人比如行政、运营、财务、学生以及刚接触 AI 工具的新手。它跑在本机任务数据留在本地这一点对隐私敏感的场景比较友好。但可视化安装这四个字很多人第一次会理解错。它确实不用你敲命令行可它仍然需要你处理三件事解压路径、安全软件拦截、以及首次启动时的后台服务初始化。这三件事任何一件出问题你看到的就不是装好了而是各种报错。我见过最多的就是解压到中文路径后启动直接闪退或者被杀软把核心文件隔离了程序图标还在但点开没反应。所以这篇的写法是先把安装跑通再把 endpoint 改到 TaoToken最后发一次真实对话请求验证。全程可视化但每一步我都会告诉你为什么这么做和做错了会怎样。你照着做一遍能过。需要提前说明的是OpenClaw 本身是本地智能体框架它需要一个模型服务来提供对话与推理能力。默认配置往往指向本地或某些公共端点对新手来说不稳定也不好排查。把它接到 TaoToken 的 API 上是让装好了变成真的能用的关键一步。TaoToken 提供统一的模型接入地址你只需要在配置里改 Base URL、填 Key、选 Model ID 三样东西。下面从环境准备开始一步步来。整个过程大概 15 分钟其中 5 分钟是等它自己装依赖。1.1 系统要求与磁盘空间核对适配 Windows 10/11 的 64 位系统。安装包本体不大但部署依赖构建阶段会生成临时缓存磁盘最低需要预留 1.6GB建议直接留 3GB 以上别卡在临界值上。安装路径必须是纯英文不能有中文、空格、特殊符号。推荐D:\OpenClaw或E:\AI\OpenClaw不要放 C 盘系统根目录也不要用新建文件夹这种带中文的默认名。1.2 关闭安全防护的必要性OpenClaw 要模拟键鼠动作、读写系统文件、操控浏览器这些行为在安全软件眼里和风险程序高度相似很容易被拦截隔离。部署前把 360 安全卫士、360 杀毒、腾讯电脑管家、火绒、Windows Defender 实时防护全部关掉。这不是让你长期裸奔装完验证通过后可以再开回来把 OpenClaw 目录加进白名单即可。项目是开源的你可以去 GitHub 看源码核验但安装阶段先关防护是省事的做法。2. TaoToken 前置准备拿到 Base URL、Key 和 Model ID在改配置之前你得先有三样东西Base URL、API Key、Model ID。这三样缺一个后面请求就会报 401 或者 reading choices 之类的错。很多人卡在装好了但一发消息就失败八成是这三样没对齐。Base URL 用https://taotoken.net/api注意这个地址后面不加任何多余路径也不要自己拼/v1之类的后缀具体以接入文档为准。API Key 需要你去控制台创建创建后复制保存它只显示一次。Model ID 就是你要调用的模型名称填错会直接报模型不存在。我建议你按这个顺序操作先打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 了解整体然后进控制台创建 Key再对照接入文档确认 Base URL 和 Model ID 的准确写法。文档里通常会给一段可直接复制的示例配置你照着改就行。这里有个新手常犯的错把 Key 当成密码一样到处贴或者贴的时候多带了空格和换行。Key 是一串字符复制时前后不要有空格粘贴到配置文件里也要注意别断行。下面第三节我会给出完整的配置片段你直接替换三个值即可。2.1 创建 API Key 的注意点进控制台后找到 API Keys 页面新建一个 Key命名随意比如openclaw-test。创建完立刻复制页面刷新后就看不到了。如果没存下来删掉重建一个不要试图找回。Key 泄露了也要及时删除重建。2.2 确认 Model ID 的写法Model ID 不是随便写的必须和平台提供的名称完全一致大小写敏感。你可以在接入文档或模型列表里找到可用模型名。填错最典型的表现就是请求返回模型不存在或者返回内容为空。建议第一次先用文档里推荐的默认模型跑通后再换。3. 可复制配置把 OpenClaw 的 endpoint 改到 TaoTokenOpenClaw 的配置一般放在安装目录下的配置文件夹里常见是config或settings目录下的 JSON 文件也可能是settings.json这种形式。具体文件名以你安装后的实际目录为准路径和原文保持一致不要自己造。找到后先备份一份再改。下面是一段可直接复制的 JSON 配置片段把三个占位值替换成你自己的即可{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_API_Key_粘贴在这里, modelId: 你的_Model_ID, timeout: 60000 }, gateway: { host: 127.0.0.1, port: 18789 } }如果你用的是 TOML 格式的配置对应写法是这样[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的_API_Key_粘贴在这里 model_id 你的_Model_ID timeout 60000 [gateway] host 127.0.0.1 port 18789改完保存重启 OpenClaw。注意 JSON 里不能有多余逗号字符串必须用双引号这是最常见的语法错误来源。如果你不确定格式对不对可以先用在线 JSON 校验工具过一遍。提示Base URL 只写到/api不要自己加/v1/chat/completions这类路径OpenClaw 会自己拼接。多写反而会 404。3.1 三件套对齐检查改完配置后对照检查三件事Base URL 是不是https://taotoken.net/apiAPI Key 是不是完整无空格Model ID 是不是和文档一致。这三样对齐了请求才可能成功。任何一样不对都会在下一节的验证里暴露出来。3.2 保存与重启顺序先保存配置文件再完全退出 OpenClaw不是最小化是退出进程然后重新启动。只关窗口不退出进程的话配置不会重新加载你会以为改了没用。重启后等 Gateway 显示在线再进行验证。4. 验证请求发一次真实对话确认接通配置改完最重要的一步是发一次真实请求确认真的通了。打开 OpenClaw 主界面在底部输入框里输入一句简单的话比如你好请回复一句话确认你在线。发送后观察返回。如果一切正常你会看到模型返回的内容同时界面不会有红色报错。这一步成功说明 Base URL、Key、Model ID 三件套全部正确OpenClaw 已经通过 TaoToken 拿到了模型响应。如果你想更直观地验证模型能力也可以直接去模型对话页面发一条消息对比确认同一个 Model ID 在那边也能正常返回。这样能排除是 OpenClaw 配置问题还是模型本身的问题。验证通过后你可以试着发一条稍微复杂的指令比如帮我把桌面上的 txt 文件列个清单看它是否能正常理解并执行。这一步是确认智能体能力不只是确认连接。4.1 成功结果的判断标准成功有三个标志界面返回了模型生成的文字没有弹出红色错误提示Gateway 状态保持在线。三者同时满足才算真正跑通。只满足一两个说明还有隐患继续看下一节排查。4.2 首次请求可能稍慢第一次请求因为要建立连接和初始化可能比后续慢几秒这是正常的。如果超过 60 秒还没返回再考虑是不是超时设置太短或网络问题。把 timeout 设成 60000 毫秒比较稳妥。5. 本篇常见报错排查401、local proxy failed、reading choices这一节是重点把新手最常撞到的几个报错对照着排。每个报错我都给出真实表现和对应处理你按表查就行。报错表现可能原因处理方式401 UnauthorizedAPI Key 错误、过期、或带了空格重新复制 Key确认无空格必要时重建local proxy failed本地代理端口被占用或 Gateway 未启动重启 Gateway检查 18789 端口占用reading choices 报错返回结构异常多为 Model ID 或 Base URL 错误核对 Model ID 与 Base URL 写法OAuth 相关报错误用了需要 OAuth 的接入方式改用 API Key 方式确认 provider 为 openai-compatible模型不存在Model ID 拼写错误或大小写不符对照文档逐字核对请求超时timeout 太短或网络不稳调大 timeout 到 60000local proxy failed这个报错特别常见它通常不是网络问题而是本地 Gateway 服务没起来或者端口被别的程序占了。处理办法是先完全退出 OpenClaw再重新启动等 Gateway 在线。如果还不行检查 18789 端口是否被占用换个端口再试。reading choices这类报错本质是程序去读返回结果里的 choices 字段时读不到多半是 Base URL 写错导致返回了非预期内容或者 Model ID 不对导致返回了错误结构。把这两个值重新核对一遍基本能解决。401 就是 Key 的问题没有例外。要么 Key 错了要么复制时带了空格换行要么 Key 被删了。重新走一遍创建流程粘贴时仔细点。注意如果你在配置里同时出现了 CC Switch、Cline MCP、Codex auth.json 这类工具的配置务必确认三件套Base URL Key Model ID在每个地方都写全且一致缺一个都会报错。5.1 排查顺序建议遇到报错别乱改按这个顺序来先看 Gateway 是否在线再看 Key 是否正确再看 Base URL 和 Model ID最后看 timeout 和端口。从外到内一层层排比东改一下西改一下高效得多。5.2 改完记得重启每次改完配置都要完全退出再启动否则改动不生效你会误以为没改对。这是新手最容易忽略的一步。6. 装好之后把 OpenClaw 用起来的几个实用方向安装和接入只是起点真正有价值的是用它干活。跑通之后你可以从简单的自动化指令开始比如整理下载文件夹里的图片、按日期分类、汇总桌面文档内容生成表格。指令描述越具体执行越准。如果你打算长期用它做编码或 Agent 类任务可以考虑 Coding Plan 这类方案配合 OpenClaw 做持续性的自动化工作。日常验证模型是否正常用模型对话页面最直接。接入过程中遇到配置问题接入文档和 API Keys 页面是你最该先看的两处。最后给一个我自己的经验第一次装的时候别急着上复杂指令先用一句你好确认连通再逐步加任务复杂度。这样出问题时你能快速定位是连接问题还是指令问题。装一次不容易跑通之后多用几次把常用指令存下来后面就是复制粘贴的事。如果你在配置里用的是 Claude Code 相关的接入方式记得把 Base URL、Key、Model ID 三件套写全缺一不可。需要创建或管理 Key 就去控制台需要核对地址和模型名就看接入文档需要直接试模型就打开模型对话。把这几处用顺了OpenClaw 才算真正变成你的本地数字员工。 
长河君 · 2026/10/4 13:24:56 · 阅读 1.2k Windows OpenClaw 超详细安装：纯可视化操作，小白一遍装好并接入 TaoToken
1. Windows OpenClaw 安装前必须搞清楚的几件事OpenClaw 是一个能在 Windows 上本地运行的 AI 智能体工具你可以把它理解成一个能自己动手操作电脑的助手——它不只是聊天还能按你的自然语言指令去整理文件、批量处理表格、操控浏览器、汇总数据。适合谁适合不想写代码、但又想让电脑自动干重复活的人比如行政、运营、财务、学生以及刚接触 AI 工具的新手。它跑在本机任务数据留在本地这一点对隐私敏感的场景比较友好。但可视化安装这四个字很多人第一次会理解错。它确实不用你敲命令行可它仍然需要你处理三件事解压路径、安全软件拦截、以及首次启动时的后台服务初始化。这三件事任何一件出问题你看到的就不是装好了而是各种报错。我见过最多的就是解压到中文路径后启动直接闪退或者被杀软把核心文件隔离了程序图标还在但点开没反应。所以这篇的写法是先把安装跑通再把 endpoint 改到 TaoToken最后发一次真实对话请求验证。全程可视化但每一步我都会告诉你为什么这么做和做错了会怎样。你照着做一遍能过。需要提前说明的是OpenClaw 本身是本地智能体框架它需要一个模型服务来提供对话与推理能力。默认配置往往指向本地或某些公共端点对新手来说不稳定也不好排查。把它接到 TaoToken 的 API 上是让装好了变成真的能用的关键一步。TaoToken 提供统一的模型接入地址你只需要在配置里改 Base URL、填 Key、选 Model ID 三样东西。下面从环境准备开始一步步来。整个过程大概 15 分钟其中 5 分钟是等它自己装依赖。1.1 系统要求与磁盘空间核对适配 Windows 10/11 的 64 位系统。安装包本体不大但部署依赖构建阶段会生成临时缓存磁盘最低需要预留 1.6GB建议直接留 3GB 以上别卡在临界值上。安装路径必须是纯英文不能有中文、空格、特殊符号。推荐D:\OpenClaw或E:\AI\OpenClaw不要放 C 盘系统根目录也不要用新建文件夹这种带中文的默认名。1.2 关闭安全防护的必要性OpenClaw 要模拟键鼠动作、读写系统文件、操控浏览器这些行为在安全软件眼里和风险程序高度相似很容易被拦截隔离。部署前把 360 安全卫士、360 杀毒、腾讯电脑管家、火绒、Windows Defender 实时防护全部关掉。这不是让你长期裸奔装完验证通过后可以再开回来把 OpenClaw 目录加进白名单即可。项目是开源的你可以去 GitHub 看源码核验但安装阶段先关防护是省事的做法。2. TaoToken 前置准备拿到 Base URL、Key 和 Model ID在改配置之前你得先有三样东西Base URL、API Key、Model ID。这三样缺一个后面请求就会报 401 或者 reading choices 之类的错。很多人卡在装好了但一发消息就失败八成是这三样没对齐。Base URL 用https://taotoken.net/api注意这个地址后面不加任何多余路径也不要自己拼/v1之类的后缀具体以接入文档为准。API Key 需要你去控制台创建创建后复制保存它只显示一次。Model ID 就是你要调用的模型名称填错会直接报模型不存在。我建议你按这个顺序操作先打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 了解整体然后进控制台创建 Key再对照接入文档确认 Base URL 和 Model ID 的准确写法。文档里通常会给一段可直接复制的示例配置你照着改就行。这里有个新手常犯的错把 Key 当成密码一样到处贴或者贴的时候多带了空格和换行。Key 是一串字符复制时前后不要有空格粘贴到配置文件里也要注意别断行。下面第三节我会给出完整的配置片段你直接替换三个值即可。2.1 创建 API Key 的注意点进控制台后找到 API Keys 页面新建一个 Key命名随意比如openclaw-test。创建完立刻复制页面刷新后就看不到了。如果没存下来删掉重建一个不要试图找回。Key 泄露了也要及时删除重建。2.2 确认 Model ID 的写法Model ID 不是随便写的必须和平台提供的名称完全一致大小写敏感。你可以在接入文档或模型列表里找到可用模型名。填错最典型的表现就是请求返回模型不存在或者返回内容为空。建议第一次先用文档里推荐的默认模型跑通后再换。3. 可复制配置把 OpenClaw 的 endpoint 改到 TaoTokenOpenClaw 的配置一般放在安装目录下的配置文件夹里常见是config或settings目录下的 JSON 文件也可能是settings.json这种形式。具体文件名以你安装后的实际目录为准路径和原文保持一致不要自己造。找到后先备份一份再改。下面是一段可直接复制的 JSON 配置片段把三个占位值替换成你自己的即可{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_API_Key_粘贴在这里, modelId: 你的_Model_ID, timeout: 60000 }, gateway: { host: 127.0.0.1, port: 18789 } }如果你用的是 TOML 格式的配置对应写法是这样[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的_API_Key_粘贴在这里 model_id 你的_Model_ID timeout 60000 [gateway] host 127.0.0.1 port 18789改完保存重启 OpenClaw。注意 JSON 里不能有多余逗号字符串必须用双引号这是最常见的语法错误来源。如果你不确定格式对不对可以先用在线 JSON 校验工具过一遍。提示Base URL 只写到/api不要自己加/v1/chat/completions这类路径OpenClaw 会自己拼接。多写反而会 404。3.1 三件套对齐检查改完配置后对照检查三件事Base URL 是不是https://taotoken.net/apiAPI Key 是不是完整无空格Model ID 是不是和文档一致。这三样对齐了请求才可能成功。任何一样不对都会在下一节的验证里暴露出来。3.2 保存与重启顺序先保存配置文件再完全退出 OpenClaw不是最小化是退出进程然后重新启动。只关窗口不退出进程的话配置不会重新加载你会以为改了没用。重启后等 Gateway 显示在线再进行验证。4. 验证请求发一次真实对话确认接通配置改完最重要的一步是发一次真实请求确认真的通了。打开 OpenClaw 主界面在底部输入框里输入一句简单的话比如你好请回复一句话确认你在线。发送后观察返回。如果一切正常你会看到模型返回的内容同时界面不会有红色报错。这一步成功说明 Base URL、Key、Model ID 三件套全部正确OpenClaw 已经通过 TaoToken 拿到了模型响应。如果你想更直观地验证模型能力也可以直接去模型对话页面发一条消息对比确认同一个 Model ID 在那边也能正常返回。这样能排除是 OpenClaw 配置问题还是模型本身的问题。验证通过后你可以试着发一条稍微复杂的指令比如帮我把桌面上的 txt 文件列个清单看它是否能正常理解并执行。这一步是确认智能体能力不只是确认连接。4.1 成功结果的判断标准成功有三个标志界面返回了模型生成的文字没有弹出红色错误提示Gateway 状态保持在线。三者同时满足才算真正跑通。只满足一两个说明还有隐患继续看下一节排查。4.2 首次请求可能稍慢第一次请求因为要建立连接和初始化可能比后续慢几秒这是正常的。如果超过 60 秒还没返回再考虑是不是超时设置太短或网络问题。把 timeout 设成 60000 毫秒比较稳妥。5. 本篇常见报错排查401、local proxy failed、reading choices这一节是重点把新手最常撞到的几个报错对照着排。每个报错我都给出真实表现和对应处理你按表查就行。报错表现可能原因处理方式401 UnauthorizedAPI Key 错误、过期、或带了空格重新复制 Key确认无空格必要时重建local proxy failed本地代理端口被占用或 Gateway 未启动重启 Gateway检查 18789 端口占用reading choices 报错返回结构异常多为 Model ID 或 Base URL 错误核对 Model ID 与 Base URL 写法OAuth 相关报错误用了需要 OAuth 的接入方式改用 API Key 方式确认 provider 为 openai-compatible模型不存在Model ID 拼写错误或大小写不符对照文档逐字核对请求超时timeout 太短或网络不稳调大 timeout 到 60000local proxy failed这个报错特别常见它通常不是网络问题而是本地 Gateway 服务没起来或者端口被别的程序占了。处理办法是先完全退出 OpenClaw再重新启动等 Gateway 在线。如果还不行检查 18789 端口是否被占用换个端口再试。reading choices这类报错本质是程序去读返回结果里的 choices 字段时读不到多半是 Base URL 写错导致返回了非预期内容或者 Model ID 不对导致返回了错误结构。把这两个值重新核对一遍基本能解决。401 就是 Key 的问题没有例外。要么 Key 错了要么复制时带了空格换行要么 Key 被删了。重新走一遍创建流程粘贴时仔细点。注意如果你在配置里同时出现了 CC Switch、Cline MCP、Codex auth.json 这类工具的配置务必确认三件套Base URL Key Model ID在每个地方都写全且一致缺一个都会报错。5.1 排查顺序建议遇到报错别乱改按这个顺序来先看 Gateway 是否在线再看 Key 是否正确再看 Base URL 和 Model ID最后看 timeout 和端口。从外到内一层层排比东改一下西改一下高效得多。5.2 改完记得重启每次改完配置都要完全退出再启动否则改动不生效你会误以为没改对。这是新手最容易忽略的一步。6. 装好之后把 OpenClaw 用起来的几个实用方向安装和接入只是起点真正有价值的是用它干活。跑通之后你可以从简单的自动化指令开始比如整理下载文件夹里的图片、按日期分类、汇总桌面文档内容生成表格。指令描述越具体执行越准。如果你打算长期用它做编码或 Agent 类任务可以考虑 Coding Plan 这类方案配合 OpenClaw 做持续性的自动化工作。日常验证模型是否正常用模型对话页面最直接。接入过程中遇到配置问题接入文档和 API Keys 页面是你最该先看的两处。最后给一个我自己的经验第一次装的时候别急着上复杂指令先用一句你好确认连通再逐步加任务复杂度。这样出问题时你能快速定位是连接问题还是指令问题。装一次不容易跑通之后多用几次把常用指令存下来后面就是复制粘贴的事。如果你在配置里用的是 Claude Code 相关的接入方式记得把 Base URL、Key、Model ID 三件套写全缺一不可。需要创建或管理 Key 就去控制台需要核对地址和模型名就看接入文档需要直接试模型就打开模型对话。把这几处用顺了OpenClaw 才算真正变成你的本地数字员工。