1. 为什么要在 Windows 上折腾 OpenClaw 2.9.3如果你和我一样电脑里存着大量不想上传到云端的文档、截图、表格又想让 AI 帮忙自动整理文件、批量重命名、定时抓取网页数据那 OpenClaw 2.9.3 值得花半小时试一次。它是一款跑在本地 Windows 上的 AI 自动化工具核心逻辑是你用自然语言描述任务它调用本机的鼠标键盘模拟、文件读写、浏览器控制能力去执行全程数据不出本机不需要注册云端账号也不依赖外部网络就能完成大部分桌面操作。适合谁用三类人最合适一是对隐私敏感、不愿把工作文件交给在线 AI 的办公族二是完全不会写代码但想用「说人话」的方式让电脑自动干活的普通用户三是想先在本机跑通一套自动化骨架再决定要不要接大模型 API 的折腾党。OpenClaw 2.9.3 这个版本在 Windows 11 上的安装流程已经做到零代码解压、双击、点几下就能跑起来真正的门槛不在安装而在装完之后怎么把模型通道接上、怎么排掉启动时的各种报错。这篇就按「先跑通本地、再接 TaoToken 通道、最后逐项排障」的顺序写。前半段是零代码部署后半段是我实测踩过的坑和修复清单配置骨架可以直接复制。2. TaoToken 前置准备统一 Key 与 API 通道OpenClaw 本身是执行壳真正理解你指令、生成操作步骤的是背后的大模型。2.9.3 支持在设置里填自定义 API 通道这样你就不用被绑死在某个模型上想换模型只改一行配置。我用的方案是 TaoToken 的统一 Key一个 Key 走多个模型省得每个模型单独申请。先做三件事第一注册并拿到 API Key。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进控制台创建 Key。地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 只在创建时显示一次复制到本地记事本暂存。第二确认 API 基址。TaoToken 的 API 入口是 https://taotoken.net/api 注意这个地址不带任何查询参数填配置时不要自己加斜杠或路径。第三想清楚你要接哪类模型。日常对话和指令理解用通用对话模型就够如果你后面要跑长时间编码或 Agent 任务可以看 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按需选套餐。模型列表和调用方式在文档里 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入前扫一眼字段名避免配置里写错参数。注意Key 属于敏感凭证不要写进会同步到云盘的文件夹也不要截图发群里。本地配置文件里明文存储是 OpenClaw 的现状建议把配置目录放在非共享路径下。3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 2.9.3 的配置分两层config.toml管模型通道和运行参数settings.json管界面和自动化权限。两个文件都在安装目录下的config文件夹里装完后如果没有就手动新建。先看config.toml这是接入 TaoToken 的核心# OpenClaw 2.9.3 模型通道配置 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_name gpt-4o-mini timeout 60 max_retries 2 [gateway] host 127.0.0.1 port 8765 auto_start true [automation] allow_mouse true allow_keyboard true allow_file_write true workspace D:/OpenClaw/workspace几个参数说明base_url必须写https://taotoken.net/api不要带/v1后缀OpenClaw 会自己拼model_name填你在 TaoToken 文档里看到的模型标识workspace是自动化操作的默认工作目录建议单独建一个空文件夹别直接指向 C 盘根目录。再看settings.json管的是界面语言、日志和权限确认{ language: zh-CN, theme: light, log_level: info, confirm_before_execute: true, screenshot_on_error: true, gateway_port: 8765, auto_update_check: false }confirm_before_execute建议先设true让每次自动化操作前弹确认框跑顺了再改false。gateway_port要和config.toml里的port一致不一致会导致界面显示 Gateway 离线。改完配置后完全退出 OpenClaw右下角托盘图标也要退再重新启动配置才会生效。4. 验证请求确认模型通道真的通了配置写完不代表通了得实际发一次请求验证。OpenClaw 2.9.3 主界面底部有个输入框但更可靠的验证方式是先用命令行测 API 通道排除是模型问题还是软件问题。打开 PowerShell执行curl -X POST https://taotoken.net/api/chat/completions ^ -H Authorization: Bearer sk-你的TaoToken密钥 ^ -H Content-Type: application/json ^ -d {\model\:\gpt-4o-mini\,\messages\:[{\role\:\user\,\content\:\回复ok\}]}如果返回 JSON 里choices数组有内容说明 Key 和通道都没问题。如果返回 401是 Key 错了返回 404是base_url写错了返回超时检查本机网络是否能访问该地址。命令行通了之后回到 OpenClaw 界面在输入框发一句「列出当前工作目录下的文件」。正常表现是界面右上角 Gateway 显示在线几秒后返回文件列表或提示目录为空。如果 Gateway 一直离线跳到下一节排障。再测一次自动化权限发「在桌面新建一个名为 test_openclaw 的文件夹」。成功的话桌面会出现该文件夹说明文件写入权限正常。这一步失败通常是权限或路径问题不是模型问题。5. 本篇常见错排查清单下面是我在 Windows 11 上实测遇到的报错按出现频率排序每条都给验证动作。启动失败双击 exe 没反应或闪退。先看安装路径是否含中文或空格。D:\软件\OpenClaw这种路径必挂改成D:\OpenClaw。验证动作把整个文件夹移到纯英文路径下重新双击Openclaw Windows一键启动.exe。Gateway 持续离线。三个原因端口被占用、配置里端口不一致、Defender 拦截。验证动作PowerShell 执行netstat -ano | findstr 8765如果有其他进程占用把config.toml和settings.json里的端口都改成 8766 再重启。如果没占用检查两个文件端口是否一致。模型加载异常提示 model not found。是model_name填错了。验证动作对照 TaoToken 文档里的模型标识逐字核对注意大小写和连字符。改完必须完全退出软件再启动。AI 无法操控鼠标键盘。权限不够。验证动作右键启动程序选「以管理员身份运行」重新走一遍。Windows 11 对模拟输入有额外校验非管理员权限下部分操作会被静默丢弃。程序文件被杀软隔离。火绒、360、Defender 都可能误报。验证动作在杀软隔离区恢复文件把 OpenClaw 安装目录加入白名单重新解压覆盖。不要长期关闭杀软加白名单就够了。首次启动特别慢。正常现象2.9.3 首次运行要初始化资源等 1 到 3 分钟。验证动作看任务管理器里进程是否在跑CPU 有占用就等着别反复重启。配置文件改了不生效。托盘进程没退干净。验证动作任务管理器里结束所有 OpenClaw 相关进程再启动。6. 接上通道之后怎么用配置跑通后日常使用就是自然语言下指令。比如「把 D 盘下载文件夹里的图片按月份分类到子文件夹」「打开浏览器搜索本地 AI 工具对比把结果存成表格放桌面」。OpenClaw 会拆解成鼠标点击、文件移动、浏览器操作等步骤逐步执行。如果你后面要跑更重的编码或 Agent 任务建议单独看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按任务量选通道比每次临时换 Key 省事。API Key 管理在控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入字段有疑问查文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 想先试模型效果可以直接用模型对话 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句workspace目录别指向系统盘根目录或桌面自动化批量操作时容易误伤。单独建个D:\OpenClaw\workspace所有文件操作先在里面试确认指令理解正确再放开到其他目录。
