1. 为什么 Windows 11 上装 OpenClaw 总卡在第一步OpenClaw 是一个本地运行的 AI 智能体能帮你自动整理文件、操控浏览器、批量处理办公文档所有操作都在本机完成数据不出本地。它适合想尝鲜本地 Agent、又不想折腾 Python 和 Node.js 环境的人。但我在 Windows 11 上第一次装的时候卡了整整一个下午——不是解压丢文件就是启动被 SmartScreen 拦下好不容易跑起来界面还是全英文模型通道也没配通。问题基本集中在三个地方一是 Win11 自带的解压工具对含大量小文件的压缩包处理不干净解压后目录结构会缺东西二是系统对模拟键鼠、读写文件这类行为默认拦截Defender 和第三方安全软件都会误判三是 OpenClaw 的模型调用走的是settings.json配置文件零基础用户不知道这个文件在哪、该填什么。这篇就按「下载 → 解压 → 启动 → 汉化 → 配 TaoToken 通道 → 验证」的顺序走一遍每一步都给可复制的命令和配置片段。你不需要懂编程照着做就行。装完之后OpenClaw 的界面是中文的模型通道走 TaoToken 统一 Key后面换模型只改一个字段。2. 装 OpenClaw 之前先把 TaoToken 的 Key 和通道准备好OpenClaw 本身不带模型它需要你提供一个兼容 OpenAI 格式的 API 通道。TaoToken 的作用就是把这个通道统一起来你申请一个 Key填进 OpenClaw 的settings.json后面不管换 Claude 还是别的模型都只改model字段不用动 Key 和地址。先做两件事。第一打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号进控制台。第二在控制台左侧找到「API Keys」点「创建新密钥」复制那串以sk-开头的字符串先粘到记事本里存着。这个 Key 只显示一次关掉页面就看不到了。注意Key 不要直接写在聊天窗口或截图里发出去。后面我们只把它填进本地settings.json这个文件不会上传。TaoToken 的 API 地址是 https://taotoken.net/api 这个地址在配置里会用到。如果你后面想长期跑编码类任务或者 Agent 自动化可以在控制台看一下 Coding Plan 的额度说明只是先验证模型通不通用按量计费就够了。3. 下载、解压、启动Windows 11 上的完整命令与参数3.1 下载与解压别用 Win11 自带解压OpenClaw 的 Windows 包是一个 ZIP里面包含运行环境和依赖不需要你另外装 Python 或 Node.js。下载完成后右键压缩包选「解压到当前文件夹」。这里有个坑Win11 自带的解压对深层目录支持不好解压完可能少文件。建议用 7-Zip 或 WinRAR解压后你会得到一个Openclaw-win文件夹里面有一个红色龙虾图标的Openclaw Windows 一键启动.exe看到这个图标就说明解压完整。如果你习惯用命令行也可以用 PowerShell 解压避免图形界面漏文件Expand-Archive -Path $env:USERPROFILE\Downloads\Openclaw-win.zip -DestinationPath D:\OpenClaw -Force解压目标路径必须是纯英文不能有中文、空格或特殊符号。推荐D:\OpenClaw或E:\AI\OpenClaw。像D:\软件\OpenClaw或C:\Program Files\OpenClaw这种路径后面启动时大概率报路径识别错误。3.2 启动参数与 SmartScreen 放行双击Openclaw Windows 一键启动.exeWin11 会弹「Windows 已保护你的电脑」。点「更多信息」再点「仍要运行」。如果没弹这个窗口但程序没反应右键 exe选「以管理员身份运行」。首次启动建议带上日志参数方便出问题时看输出cd D:\OpenClaw .\Openclaw Windows 一键启动.exe --log-level debug启动后进入欢迎界面点「开始使用」设置安装路径还是纯英文勾选协议点「开始安装」。接下来 3 到 5 分钟系统会自动检测环境、装缺失依赖、部署项目、配置浏览器控制工具、生成配置文件、创建快捷方式。这期间不要关窗口。第一次启动在 Win11 上初始化组件慢等 1 到 3 分钟是正常的。安装完成后主界面自动打开右上角显示「Gateway 在线」就代表部署成功了。4. 界面汉化替换语言文件并让 OpenClaw 显示中文OpenClaw 默认界面是英文汉化靠替换语言包。安装完成后在安装目录下找到resources文件夹里面有一个locales子目录结构大概是这样D:\OpenClaw\ ├── Openclaw Windows 一键启动.exe ├── resources\ │ ├── app.asar │ └── locales\ │ ├── en.json │ └── zh-CN.json └── settings.json把准备好的zh-CN.json汉化文件复制进locales目录。如果你手上没有现成的汉化文件可以先用下面这个最小片段测试确认替换机制生效{ app.title: OpenClaw 智能体, gateway.online: Gateway 在线, gateway.offline: Gateway 离线, menu.settings: 设置, menu.models: 模型管理, action.start: 开始使用, action.install: 开始安装 }替换后打开settings.json把语言字段改成zh-CN{ language: zh-CN, localePath: resources/locales/zh-CN.json }保存后完全退出 OpenClaw右下角托盘图标也要退出再重新启动。界面菜单和状态提示就会变成中文。如果还是英文检查settings.json里language字段有没有拼错以及zh-CN.json是不是放在了locales目录下而不是根目录。5. 配置 settings.json把 TaoToken 通道接进 OpenClawsettings.json在安装根目录用记事本或 VS Code 打开。下面是一个可直接复制的骨架把sk-你的Key换成第 2 步存下来的那串{ language: zh-CN, localePath: resources/locales/zh-CN.json, gateway: { host: 127.0.0.1, port: 8765, autoStart: true }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: claude-sonnet-4-20250514, maxTokens: 4096, temperature: 0.7 }, agent: { allowFileAccess: true, allowBrowserControl: true, workspace: D:\\OpenClaw\\workspace } }几个字段说明一下。baseUrl填 TaoToken 的 API 地址结尾不要多加斜杠。apiKey就是你的 TaoToken Key。model先填一个你账号里有权限的模型名后面想换模型只改这一行。workspace是 Agent 读写文件的默认目录建议单独建一个空文件夹别直接指向整个 D 盘。注意allowFileAccess和allowBrowserControl打开后OpenClaw 才能执行文件整理和浏览器操作。如果你只是先测模型连通性可以先把这两个设为false验证通过再打开。保存settings.json重启 OpenClaw。如果启动时报 JSON 解析错误多半是少了逗号或多了逗号用 VS Code 打开会直接标红。6. 验证确认界面是中文、API 通道能通重启后先看界面。菜单栏显示「设置」「模型管理」右上角显示「Gateway 在线」说明汉化和 Gateway 都正常。接着验证 API 通道。在 OpenClaw 对话框里输入一句简单指令比如「你好请回复当前使用的模型名称」。如果返回内容正常说明 TaoToken 通道通了。如果报 401检查apiKey是不是复制时带了空格如果报 404检查baseUrl是不是写成了https://taotoken.net/api/多了斜杠如果一直转圈检查model字段填的模型名在你账号里有没有权限。你也可以用命令行直接测通道排除 OpenClaw 本身的干扰curl.exe https://taotoken.net/api/v1/chat/completions -H Content-Type: application/json -H Authorization: Bearer sk-你的Key -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回 JSON 里带choices字段就说明 Key 和地址都没问题。这一步通了OpenClaw 里再报错就是配置字段的问题不是通道的问题。7. 本篇常见报错排查安装提示权限不足右键一键启动程序选「以管理员身份运行」。如果还不行检查安装路径是不是在C:\Program Files下换到D:\OpenClaw再试。Gateway 一直显示离线先确认安全软件没有拦截。360、腾讯电脑管家、火绒、Defender 实时防护都可能把 OpenClaw 的键鼠模拟行为当成风险操作。把 OpenClaw 安装目录加入白名单或者临时关闭实时防护后重启软件。另外检查路径是否纯英文管理员身份重启。启动慢、无响应Win11 下第一次启动要初始化组件等 1 到 3 分钟正常。如果超过 5 分钟还没反应看--log-level debug输出的日志卡在哪一步。AI 无法控制鼠标或读写文件确认settings.json里allowFileAccess和allowBrowserControl都是true并且以管理员身份运行。Win11 的权限管理比 Win10 严普通权限下键鼠模拟会被静默拒绝。文件被杀毒软件删除关闭防护重新解压再安装一次。解压前就把安装目录加入白名单避免装到一半文件被删。汉化后界面还是英文检查language字段拼写确认zh-CN.json在locales目录下完全退出托盘进程再重启。有时候只是窗口没刷新退出重开就好。8. 配好之后下一步去哪到这里OpenClaw 在 Windows 11 上的安装、启动、汉化和 TaoToken 通道配置就全部走完了。你现在有一个中文界面的本地 Agent模型通道走统一 Key后面换模型只改settings.json里的model字段。如果你只是想先验证模型对话通不通可以直接用 TaoToken 的模型对话页面测一下https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。如果你打算长期跑编码任务或者 Agent 自动化建议在控制台看一下 Coding Plan 的额度https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。Key 管理和新建密钥在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。接入文档里有不同语言的调用示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。我自己的习惯是装完先把workspace指向一个空目录跑几个文件整理指令确认 Agent 行为符合预期再逐步放开权限。这样即使模型理解偏了也不会误动重要文件。 
长河君 · 2026/9/29 21:13:47 · 阅读 1.2k 一步到位！OpenClaw 安装、启动、界面汉化全流程｜零基础也能轻松上手（TaoToken 配置版）
1. 为什么 Windows 11 上装 OpenClaw 总卡在第一步OpenClaw 是一个本地运行的 AI 智能体能帮你自动整理文件、操控浏览器、批量处理办公文档所有操作都在本机完成数据不出本地。它适合想尝鲜本地 Agent、又不想折腾 Python 和 Node.js 环境的人。但我在 Windows 11 上第一次装的时候卡了整整一个下午——不是解压丢文件就是启动被 SmartScreen 拦下好不容易跑起来界面还是全英文模型通道也没配通。问题基本集中在三个地方一是 Win11 自带的解压工具对含大量小文件的压缩包处理不干净解压后目录结构会缺东西二是系统对模拟键鼠、读写文件这类行为默认拦截Defender 和第三方安全软件都会误判三是 OpenClaw 的模型调用走的是settings.json配置文件零基础用户不知道这个文件在哪、该填什么。这篇就按「下载 → 解压 → 启动 → 汉化 → 配 TaoToken 通道 → 验证」的顺序走一遍每一步都给可复制的命令和配置片段。你不需要懂编程照着做就行。装完之后OpenClaw 的界面是中文的模型通道走 TaoToken 统一 Key后面换模型只改一个字段。2. 装 OpenClaw 之前先把 TaoToken 的 Key 和通道准备好OpenClaw 本身不带模型它需要你提供一个兼容 OpenAI 格式的 API 通道。TaoToken 的作用就是把这个通道统一起来你申请一个 Key填进 OpenClaw 的settings.json后面不管换 Claude 还是别的模型都只改model字段不用动 Key 和地址。先做两件事。第一打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号进控制台。第二在控制台左侧找到「API Keys」点「创建新密钥」复制那串以sk-开头的字符串先粘到记事本里存着。这个 Key 只显示一次关掉页面就看不到了。注意Key 不要直接写在聊天窗口或截图里发出去。后面我们只把它填进本地settings.json这个文件不会上传。TaoToken 的 API 地址是 https://taotoken.net/api 这个地址在配置里会用到。如果你后面想长期跑编码类任务或者 Agent 自动化可以在控制台看一下 Coding Plan 的额度说明只是先验证模型通不通用按量计费就够了。3. 下载、解压、启动Windows 11 上的完整命令与参数3.1 下载与解压别用 Win11 自带解压OpenClaw 的 Windows 包是一个 ZIP里面包含运行环境和依赖不需要你另外装 Python 或 Node.js。下载完成后右键压缩包选「解压到当前文件夹」。这里有个坑Win11 自带的解压对深层目录支持不好解压完可能少文件。建议用 7-Zip 或 WinRAR解压后你会得到一个Openclaw-win文件夹里面有一个红色龙虾图标的Openclaw Windows 一键启动.exe看到这个图标就说明解压完整。如果你习惯用命令行也可以用 PowerShell 解压避免图形界面漏文件Expand-Archive -Path $env:USERPROFILE\Downloads\Openclaw-win.zip -DestinationPath D:\OpenClaw -Force解压目标路径必须是纯英文不能有中文、空格或特殊符号。推荐D:\OpenClaw或E:\AI\OpenClaw。像D:\软件\OpenClaw或C:\Program Files\OpenClaw这种路径后面启动时大概率报路径识别错误。3.2 启动参数与 SmartScreen 放行双击Openclaw Windows 一键启动.exeWin11 会弹「Windows 已保护你的电脑」。点「更多信息」再点「仍要运行」。如果没弹这个窗口但程序没反应右键 exe选「以管理员身份运行」。首次启动建议带上日志参数方便出问题时看输出cd D:\OpenClaw .\Openclaw Windows 一键启动.exe --log-level debug启动后进入欢迎界面点「开始使用」设置安装路径还是纯英文勾选协议点「开始安装」。接下来 3 到 5 分钟系统会自动检测环境、装缺失依赖、部署项目、配置浏览器控制工具、生成配置文件、创建快捷方式。这期间不要关窗口。第一次启动在 Win11 上初始化组件慢等 1 到 3 分钟是正常的。安装完成后主界面自动打开右上角显示「Gateway 在线」就代表部署成功了。4. 界面汉化替换语言文件并让 OpenClaw 显示中文OpenClaw 默认界面是英文汉化靠替换语言包。安装完成后在安装目录下找到resources文件夹里面有一个locales子目录结构大概是这样D:\OpenClaw\ ├── Openclaw Windows 一键启动.exe ├── resources\ │ ├── app.asar │ └── locales\ │ ├── en.json │ └── zh-CN.json └── settings.json把准备好的zh-CN.json汉化文件复制进locales目录。如果你手上没有现成的汉化文件可以先用下面这个最小片段测试确认替换机制生效{ app.title: OpenClaw 智能体, gateway.online: Gateway 在线, gateway.offline: Gateway 离线, menu.settings: 设置, menu.models: 模型管理, action.start: 开始使用, action.install: 开始安装 }替换后打开settings.json把语言字段改成zh-CN{ language: zh-CN, localePath: resources/locales/zh-CN.json }保存后完全退出 OpenClaw右下角托盘图标也要退出再重新启动。界面菜单和状态提示就会变成中文。如果还是英文检查settings.json里language字段有没有拼错以及zh-CN.json是不是放在了locales目录下而不是根目录。5. 配置 settings.json把 TaoToken 通道接进 OpenClawsettings.json在安装根目录用记事本或 VS Code 打开。下面是一个可直接复制的骨架把sk-你的Key换成第 2 步存下来的那串{ language: zh-CN, localePath: resources/locales/zh-CN.json, gateway: { host: 127.0.0.1, port: 8765, autoStart: true }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: claude-sonnet-4-20250514, maxTokens: 4096, temperature: 0.7 }, agent: { allowFileAccess: true, allowBrowserControl: true, workspace: D:\\OpenClaw\\workspace } }几个字段说明一下。baseUrl填 TaoToken 的 API 地址结尾不要多加斜杠。apiKey就是你的 TaoToken Key。model先填一个你账号里有权限的模型名后面想换模型只改这一行。workspace是 Agent 读写文件的默认目录建议单独建一个空文件夹别直接指向整个 D 盘。注意allowFileAccess和allowBrowserControl打开后OpenClaw 才能执行文件整理和浏览器操作。如果你只是先测模型连通性可以先把这两个设为false验证通过再打开。保存settings.json重启 OpenClaw。如果启动时报 JSON 解析错误多半是少了逗号或多了逗号用 VS Code 打开会直接标红。6. 验证确认界面是中文、API 通道能通重启后先看界面。菜单栏显示「设置」「模型管理」右上角显示「Gateway 在线」说明汉化和 Gateway 都正常。接着验证 API 通道。在 OpenClaw 对话框里输入一句简单指令比如「你好请回复当前使用的模型名称」。如果返回内容正常说明 TaoToken 通道通了。如果报 401检查apiKey是不是复制时带了空格如果报 404检查baseUrl是不是写成了https://taotoken.net/api/多了斜杠如果一直转圈检查model字段填的模型名在你账号里有没有权限。你也可以用命令行直接测通道排除 OpenClaw 本身的干扰curl.exe https://taotoken.net/api/v1/chat/completions -H Content-Type: application/json -H Authorization: Bearer sk-你的Key -d {\model\:\claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回 JSON 里带choices字段就说明 Key 和地址都没问题。这一步通了OpenClaw 里再报错就是配置字段的问题不是通道的问题。7. 本篇常见报错排查安装提示权限不足右键一键启动程序选「以管理员身份运行」。如果还不行检查安装路径是不是在C:\Program Files下换到D:\OpenClaw再试。Gateway 一直显示离线先确认安全软件没有拦截。360、腾讯电脑管家、火绒、Defender 实时防护都可能把 OpenClaw 的键鼠模拟行为当成风险操作。把 OpenClaw 安装目录加入白名单或者临时关闭实时防护后重启软件。另外检查路径是否纯英文管理员身份重启。启动慢、无响应Win11 下第一次启动要初始化组件等 1 到 3 分钟正常。如果超过 5 分钟还没反应看--log-level debug输出的日志卡在哪一步。AI 无法控制鼠标或读写文件确认settings.json里allowFileAccess和allowBrowserControl都是true并且以管理员身份运行。Win11 的权限管理比 Win10 严普通权限下键鼠模拟会被静默拒绝。文件被杀毒软件删除关闭防护重新解压再安装一次。解压前就把安装目录加入白名单避免装到一半文件被删。汉化后界面还是英文检查language字段拼写确认zh-CN.json在locales目录下完全退出托盘进程再重启。有时候只是窗口没刷新退出重开就好。8. 配好之后下一步去哪到这里OpenClaw 在 Windows 11 上的安装、启动、汉化和 TaoToken 通道配置就全部走完了。你现在有一个中文界面的本地 Agent模型通道走统一 Key后面换模型只改settings.json里的model字段。如果你只是想先验证模型对话通不通可以直接用 TaoToken 的模型对话页面测一下https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。如果你打算长期跑编码任务或者 Agent 自动化建议在控制台看一下 Coding Plan 的额度https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。Key 管理和新建密钥在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。接入文档里有不同语言的调用示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。我自己的习惯是装完先把workspace指向一个空目录跑几个文件整理指令确认 Agent 行为符合预期再逐步放开权限。这样即使模型理解偏了也不会误动重要文件。