1. 为什么要在 Windows 上跑 OpenClaw 本地 AI 智能体OpenClaw 是一个能在你本机运行的 AI 智能体框架圈内有人叫它“小龙虾”。它和普通对话式 AI 最大的区别是它能真正操作你的电脑——整理文件夹、批量重命名、生成表格、驱动浏览器抓数据这些动作都由自然语言指令触发不需要你写脚本。适合谁适合每天被重复性办公操作拖住的人比如行政、运营、财务、测试以及想在自己 Windows 机器上跑一个可控智能体的开发者。我试过在 Windows 11 上从零部署 OpenClaw v2.7.9整个过程如果路径和权限没踩坑20 分钟内能跑通。但实际卡人的地方不在安装本身而在两个配置文件config.toml和settings.json。前者决定智能体加载哪些工具、连哪个模型后者决定运行时行为和本地服务端口。很多人装完发现 Gateway 离线、指令没反应八成是这两个文件没配对。这篇就按“拿到安装包 → 解压启动 → 写配置骨架 → 启动验证 → 排错”的顺序走一遍重点交付可复制的配置骨架而不是只讲点下一步。你跟着做能一次把本地智能体跑起来。2. TaoToken 前置准备给 OpenClaw 接上模型能力OpenClaw 本身是智能体壳子它需要一个大模型来理解你的自然语言指令。你可以接本地模型也可以接云端 API。如果你希望开箱即用、不折腾显卡用 TaoToken 的 API 是最省事的路径——它兼容主流模型调用格式OpenClaw 的config.toml里填上 base_url 和 key 就能通。先做两件事第一注册并拿到 API Key。打开 https://taotoken.net/api-keys 登录后创建一个新 Key复制保存。这个 Key 只显示一次丢了就重建。第二确认你要用的模型名。TaoToken 支持多款主流大模型你在模型对话页 https://taotoken.net/models 能看到可用列表。记下你要填进配置的模型标识比如gpt-4o或claude-sonnet这类。如果你打算长期用 OpenClaw 做编码或 Agent 任务可以看下 Coding Plan https://taotoken.net/coding-plan 额度更划算。只是想先验证能不能跑通用按量 API 就行。注意OpenClaw 的配置文件里 base_url 填https://taotoken.net/api不要加多余路径。Key 填你刚创建的那串。3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 安装完成后安装目录下会生成一个config文件夹。你需要在这里放两个文件。下面是我实测能跑通的骨架你直接复制改 Key 即可。3.1 config.toml 骨架# OpenClaw v2.7.9 主配置 [agent] name local-claw workspace D:/OpenClaw/workspace language zh-CN max_steps 30 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model gpt-4o temperature 0.3 timeout 60 [tools] enable_file_ops true enable_browser true enable_shell false enable_clipboard true [security] allow_paths [D:/OpenClaw/workspace, D:/Downloads] confirm_dangerous true几个关键点解释workspace是智能体默认操作目录建议单独建一个别直接指向 C 盘用户目录。enable_shell我默认关掉因为 shell 权限太大办公场景用文件操作和浏览器就够了。allow_paths是白名单智能体只能碰这些路径下的文件防止它乱翻你整个硬盘。3.2 settings.json 骨架{ gateway: { host: 127.0.0.1, port: 8765, auto_start: true }, ui: { theme: light, show_logs: true, language: zh-CN }, runtime: { max_concurrent_tasks: 2, task_timeout_seconds: 300, log_level: info }, storage: { history_dir: D:/OpenClaw/history, max_history: 200 } }gateway.port默认 8765如果这个端口被占用改成 8766 或别的。auto_start设为 true启动 OpenClaw 时 Gateway 会自动拉起省得你手动点。log_level排查问题时可以临时改成debug平时用info就行。把这两个文件放进D:/OpenClaw/config/下注意文件名必须完全一致config.toml和settings.json。扩展名别被记事本偷偷加成.txt。4. 启动验证确认 Gateway 在线并跑通第一条指令配置写好后双击安装目录里的Openclaw Windows 一键启动.exe。第一次启动会初始化 Gateway界面显示“正在等待 Gateway 就绪...”等 1 到 3 分钟。右上角状态变成“Gateway 在线”就说明服务起来了。如果超过 5 分钟还是离线先别急着重装按第 5 节的排查走。验证模型是否接通最简单的办法是在对话框输入帮我列出 D:/OpenClaw/workspace 下的所有文件如果智能体返回文件列表说明模型调用和文件工具都正常。如果它回复“无法访问”或报模型错误说明config.toml里的 api_key 或 base_url 有问题。再测一条稍微复杂的在 workspace 下新建一个 test 文件夹里面放一个 hello.txt内容写“OpenClaw 跑通”执行完你去D:/OpenClaw/workspace/test/看文件在就说明写操作也通了。想单独验证模型对话是否正常可以打开 https://taotoken.net/chat 用同一个 Key 发一条消息对比返回是否正常。这样能快速区分是模型侧问题还是 OpenClaw 配置问题。5. 本篇常见错排查5.1 Gateway 一直离线最常见原因是端口被占。打开 PowerShell 跑netstat -ano | findstr 8765如果有进程占用把settings.json里的 port 改成 8766重启 OpenClaw。另一个原因是安全软件拦截了 Gateway 进程把 OpenClaw 安装目录加入白名单或者临时关闭实时防护再启动。5.2 模型调用返回 401 或 403说明 api_key 不对或没权限。检查config.toml里 key 有没有多余空格base_url 是不是https://taotoken.net/api。如果 Key 刚创建等 10 秒再试。还不行就去 https://taotoken.net/api-keys 重新生成一个。5.3 智能体说“路径不在允许范围”这是allow_paths白名单没包含你要操作的目录。比如你想让它整理D:/Downloads但白名单里只写了 workspace。打开config.toml在allow_paths数组里加上对应路径重启生效。5.4 启动时报 config.toml 解析错误TOML 对格式敏感。检查有没有用中文引号、有没有漏掉等号、数组括号是否闭合。一个快速办法是把config.toml内容贴到在线 TOML 校验器里过一遍。另外确认文件编码是 UTF-8不是 GBK。5.5 第一次启动卡在初始化超过 5 分钟先看D:/OpenClaw/history/下的日志文件把log_level改成debug重启日志会告诉你卡在哪一步。多数情况是 Gateway 在下载浏览器控制组件时网络超时换个网络环境或等几分钟重试即可。6. 跑通之后把 OpenClaw 用进日常办公配置跑通只是起点。你可以把常用操作写成固定指令模板比如“每周一整理下载文件夹”“把桌面所有 xlsx 合并成一张表”直接丢给 OpenClaw 执行。需要长期跑编码或 Agent 任务的建议走 Coding Plan https://taotoken.net/coding-plan 额度更稳。接入文档在 https://taotoken.net/doc 里面有完整的参数说明和示例。如果你在配置过程中遇到本文没覆盖的报错先去 https://taotoken.net/api-keys 确认 Key 状态再对照日志定位。大部分问题出在路径、端口、Key 这三处逐个排除基本都能解决。
