1. OpenClaw v2.7.9 到底解决什么问题OpenClaw 是一款本地 AI 自动化工具能在 Windows 和 macOS 上把自然语言指令转成实际的电脑操作比如整理文件夹、批量重命名、自动填表、键鼠模拟。它适合不想折腾 Python、Node.js 环境又想在本机跑自动化任务的人。v2.7.9 这个版本最大的变化是把模型通道配置收敛到一份settings.json里配合 TaoToken 的统一 Key可以做到装完即用、不写一行代码。我试过在 Windows 11 和 macOS Sonoma 上各跑一遍整个流程从解压到 Gateway 在线大概 5 分钟真正需要手动填的只有一份配置骨架。下面按「装包 → 配 Key → 验证 → 排障」的顺序拆开讲每一步都给可复制的命令和参数。2. 安装包落地与首次启动2.1 Windows 侧解压与目录规范下载完压缩包后用 7-Zip 或 WinRAR 解压系统自带解压工具偶尔会丢文件。解压出来是Openclaw-win文件夹双击里面的Openclaw Windows 一键启动.exe。如果弹出 SmartScreen 拦截点「更多信息 → 仍要运行」。安装目录有个硬性要求全英文、无空格、无特殊符号。推荐D:\OpenClaw或E:\AI\OpenClaw别用D:\软件\OpenClaw这种带中文的路径后面 Gateway 起不来八成是这里踩的坑。勾选协议后点开始安装工具会自动补齐 Git、Node.js、Python 依赖耗时 3 到 5 分钟期间别关窗口。2.2 macOS 侧拖拽安装macOS 下载的是.dmg打开后把 OpenClaw 拖进「应用程序」。首次启动如果提示「无法验证开发者」去「系统设置 → 隐私与安全性」点「仍要打开」。macOS 不需要手动配依赖工具内置了运行组件。2.3 首次启动的状态核验第一次启动会显示「正在等待 Gateway 就绪」等 1 到 3 分钟右上角变成Gateway 在线就算部署完成。后续重启只要几秒。界面分四块右上角是 Gateway 状态和 Tokens 余额左侧是会话和渠道面板中间是对话区底部是输入框。3. TaoToken 统一 Key 前置准备OpenClaw 本身不带模型能力它需要一个模型通道。TaoToken 的作用就是把多家模型的调用收敛成一个 Key、一个 Base URL省得你在settings.json里来回换地址。先去控制台拿 Key打开 TaoToken 控制台在 API Keys 页面新建一个 Key复制出来。这个 Key 就是后面settings.json里apiKey字段的值。如果你打算长期跑编码类或 Agent 类任务可以看下 Coding Plan额度模型更适合高频调用。只是想先验证通道通不通用普通 Key 就够。注意Key 只显示一次复制后先存到本地文本里别直接贴到聊天窗口。4. settings.json 配置骨架可复制OpenClaw v2.7.9 的配置文件在安装目录下的config/settings.json。Windows 路径类似D:\OpenClaw\config\settings.jsonmacOS 在~/Library/Application Support/OpenClaw/config/settings.json。用记事本或 VS Code 打开替换成下面这份骨架{ gateway: { host: 127.0.0.1, port: 8765, autoStart: true }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelName: claude-sonnet-4-20250514, timeout: 60000, maxRetries: 2 }, automation: { allowFileSystem: true, allowKeyboardMouse: true, workspaceDir: D:/OpenClaw/workspace }, ui: { language: zh-CN, theme: dark } }几个字段说明一下。baseUrl填https://taotoken.net/api不要带路径后缀。modelName按你实际要用的模型填上面只是示例。workspaceDir是自动化任务的工作目录Windows 用正斜杠或双反斜杠都行别用单反斜杠JSON 会解析失败。改完保存回到 OpenClaw 界面点右上角的重启按钮让 Gateway 重新加载配置。5. 验证模型通道是否连通配置写完别急着跑任务先用一条命令确认通道通。打开终端Windows 用 PowerShellmacOS 用 Terminal执行curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 ok}], max_tokens: 10 }返回里出现content: ok或类似结构说明 Key 和通道都正常。如果返回 401是 Key 错了返回 404检查baseUrl是不是多写了/v1返回超时看本机网络。通道验证通过后回到 OpenClaw 主界面在底部输入框敲一句「列出当前工作目录下的文件」能正常返回结果就说明整条链路打通了。想单独测模型对话可以打开 模型对话 页面直接发消息对比。6. 本篇常见报错排查Gateway 一直离线九成是安装目录带中文或空格。把整个OpenClaw文件夹移到纯英文路径下重启程序。还不行就右键「以管理员身份运行」。settings.json 保存后不生效JSON 格式错了。用 VS Code 打开看有没有红色波浪线常见问题是末尾多了逗号、用了中文引号。curl 返回 401Key 复制时带了空格或者 Key 已经被删。去 API Keys 页面重新生成一个。输入框发指令没反应等 Gateway 状态变在线再操作。如果一直离线看config目录下的gateway.log里面会写具体报错。自动化任务执行到一半停住检查workspaceDir指向的目录是否存在不存在的话 OpenClaw 不会自动创建手动建一个空文件夹即可。macOS 提示权限不足去「系统设置 → 隐私与安全性 → 辅助功能」把 OpenClaw 勾上键鼠模拟需要这个权限。配置和排障都走完之后如果还想看更细的接入参数可以翻 接入文档里面列了各模型对应的modelName写法。整套流程里最容易翻车的就是目录中文和 JSON 格式这两处把这两点盯住剩下的基本一次过。