1. OpenClaw 双平台部署到底解决什么问题
OpenClaw 是一个本地运行的桌面智能体，能理解自然语言指令并操控电脑完成文件整理、表格处理、网页抓取、文档汇总这类重复性工作。它和普通聊天 AI 最大的区别在于：任务数据全部留在本机，不需要把敏感文件上传到云端，同时具备键鼠模拟和第三方程序调用能力，可以真正“动手”帮你干活。适合谁用？办公场景里经常要批量处理文件、整理表格、抓取网页信息的人，以及想在自己电脑上跑一个可控 AI 助手的开发者。
这次要跑通的是 Windows 2.9.0 和 macOS 2.7.9 两个版本。两个平台的安装逻辑不一样：Windows 走的是预封装整合包，解压后双击启动程序，全程图形界面，不需要敲命令；macOS 因为系统权限机制更严格，需要先处理 Gatekeeper 拦截和可执行权限，再启动安装器。很多人卡住不是因为 OpenClaw 本身有问题，而是前置准备没做对——安全软件把核心文件隔离了、安装路径带了中文、macOS 没给执行权限，这些都会让部署直接中断。
我实测下来，Windows 端从解压到 Gateway 在线大概 5 到 8 分钟，macOS 端因为要过权限校验，首次启动会多花 2 到 3 分钟。两个平台装完之后，都需要接一个模型通道才能真正跑任务。这里用 TaoToken 的统一 Key 来配置，一个 Key 同时管 Windows 和 macOS 两边的模型调用，不用分别申请、分别记。下面按平台拆开讲，每一步都给可复制的命令和校验动作。
2. TaoToken 统一 Key 的前置准备与通道说明
在装 OpenClaw 之前，先把模型通道准备好，这样装完就能直接接上跑任务，不用回头补配置。TaoToken 在这里的角色是统一 API 通道：你拿到一个 Key，填到 OpenClaw 的模型配置里，Windows 和 macOS 两边用同一个 Key 就能调用模型，省掉多平台分别管理的麻烦。
先拿 Key。打开 https://taotoken.net/api-keys ，登录后创建一个 API Key，复制保存。这个 Key 后面要填进 OpenClaw 的配置文件，格式类似sk-xxxxxxxx。注意不要把它提交到 Git 仓库或者贴在公开地方。
然后确认你要用的模型 ID。TaoToken 的模型对话页面在 https://taotoken.net/model-chat ，可以在那里先测一下模型能不能正常返回，确认模型 ID 写对。常见的模型 ID 形如claude-sonnet-4-20250514这种，具体以你账号里可用的为准。
Base URL 统一用https://taotoken.net/api，不要加 UTM 参数，也不要带尾部斜杠。这个地址在 Windows 和 macOS 的配置里是一样的。
如果你后面要长期跑编码类任务或者 Agent 工作流，可以看一下 Coding Plan：https://taotoken.net/coding-plan ，它针对高频调用场景做了额度优化。接入文档在 https://taotoken.net/doc ，里面有各语言的调用示例，配置卡住的时候可以对照查。
这里要提醒一点：TaoToken 是合规的 API 通道，不是灰色中转，配置的时候按正常 API 接入流程走就行。Key 的权限范围在控制台 https://taotoken.net/console 里可以查看和调整。
3. Windows 2.9.0 与 macOS 2.7.9 可复制安装配置
3.1 Windows 2.9.0 安装步骤
Windows 端用整合包，内置全部依赖，不需要单独装 Python、Node 之类的运行时。安装包大小约 45.8MB，下载后是一个 zip 压缩包。
第一步，解压。不要用系统自带的解压工具，容易出文件缺失和权限异常。用 7-Zip 或 WinRAR，右键压缩包选择“解压到当前文件夹”，等 1 到 2 分钟。解压后生成Openclaw-win文件夹，里面有一个红色龙虾图标的启动程序，说明解压成功。
第二步，关安全软件。这一步很关键。360 安全卫士、腾讯电脑管家、火绒、Windows Defender 实时防护，全部关掉，后台相关进程也结束掉。OpenClaw 需要文件读写、键鼠模拟、启动第三方程序的权限，容易被判定为风险程序，核心文件一旦被隔离，安装直接中断。
第三步，启动安装程序。双击Openclaw Windows 一键启动.exe。如果弹出 Windows SmartScreen 提示，点“更多信息”再点“仍要运行”。没有弹窗就直接进路径配置。
第四步，设置安装路径。路径只能用纯英文，不能有中文、空格、特殊符号。优先选 D 盘或 E 盘，别装 C 盘。比如D:\OpenClaw这种。勾选用户协议和免责声明，点开始安装。程序会自动检测环境、补齐依赖、部署核心文件、安装网页自动化组件、生成配置文件、创建桌面快捷方式。全程 3 到 5 分钟，别关窗口。
第五步，首次启动等 Gateway 初始化。安装完自动打开主程序，第一次运行要初始化 Gateway 后台服务，页面加载 1 到 3 分钟是正常的。右上角显示“Gateway 在线”就说明部署完成。
3.2 macOS 2.7.9 安装步骤
macOS 端因为 Gatekeeper 机制，需要多几步权限处理。安装包同样约 45.8MB。
第一步，解压。用系统自带的归档工具或者 Keka 都行，解压后得到Openclaw-mac文件夹。
第二步，给执行权限。打开终端，cd 到解压目录，执行：
cd ~/Downloads/Openclaw-mac chmod +x Openclaw\ macOS\ 一键启动.app/Contents/MacOS/*如果提示“无法打开，因为来自身份不明的开发者”，执行：
xattr -dr com.apple.quarantine Openclaw\ macOS\ 一键启动.app第三步，启动安装器。双击Openclaw macOS 一键启动.app。如果系统弹“无法验证开发者”，去“系统设置 → 隐私与安全性”，点“仍要打开”。
第四步，设置安装路径。macOS 下路径同样建议纯英文，比如/Users/你的用户名/OpenClaw。不要放在带中文的目录里。勾选协议，点开始安装。程序会自动完成依赖检测和文件部署，大概 3 到 5 分钟。
第五步，首次启动。安装完自动打开主程序，等 Gateway 初始化完成，右上角显示在线状态。
3.3 统一 Key 配置片段
两个平台装完后，都要在 OpenClaw 的模型配置里填 TaoToken 的通道信息。配置文件位置：
Windows：D:\OpenClaw\config\settings.jsonmacOS：/Users/你的用户名/OpenClaw/config/settings.json
用文本编辑器打开，填入以下 JSON：
{ "model": { "provider": "taotoken", "base_url": "https://taotoken.net/api", "api_key": "sk-你的TaoToken密钥", "model_id": "claude-sonnet-4-20250514", "max_tokens": 4096, "temperature": 0.7 }, "gateway": { "port": 18789, "auto_start": true } }三个关键字段对齐：Base URL 填https://taotoken.net/api，API Key 填你从 https://taotoken.net/api-keys 拿到的 Key，Model ID 填你在模型对话页面确认过的模型标识。保存后重启 OpenClaw，让配置生效。
如果你用的是 Claude Code 类的编码场景，配置方式类似，Base URL 和 Key 填法一致，Model ID 换成对应的编码模型即可。接入文档 https://taotoken.net/doc 里有 ClaudeCodeAnthropic 的配置示例，可以对照。
4. 验证请求与成功结果确认
配置填完，怎么确认真的通了？分两步：先验模型通道，再验 OpenClaw 任务执行。
验模型通道，在终端里直接发一个请求：
curl -X POST https://taotoken.net/api/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-你的TaoToken密钥" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 100, "messages": [{"role": "user", "content": "回复 OK"}] }'如果返回里有content字段且文本是“OK”之类的正常回复，说明 Key 和 Base URL 都对。如果返回 401，说明 Key 有问题；如果返回 404，检查 Base URL 是不是多写了路径。
验 OpenClaw 任务执行，在 OpenClaw 主界面底部输入框输入一条简单指令，比如：
在桌面新建一个文件夹，命名为 OpenClaw测试按 Enter 发送。如果 OpenClaw 能理解指令并在桌面创建文件夹，说明模型通道和本地执行链路都通了。右上角 Gateway 状态保持在线，左侧任务记录里能看到这次执行的历史。
再测一条稍微复杂的：
整理 D 盘下载文件夹内所有图片，按照拍摄日期新建文件夹分类存放这条会触发文件扫描、日期读取、文件夹创建、文件移动一系列动作。执行过程中可以在运行日志里看到每一步。如果卡在某一步，看日志里的报错信息，对照下一节的排查表处理。
macOS 端验证方式一样，只是路径换成 macOS 的路径。比如测试指令改成“在桌面新建文件夹”，执行结果在 macOS 桌面可见。
两个平台都验证通过后，你的 OpenClaw 基础环境就算跑通了。后面可以继续配自定义技能、接本地模型、联动飞书或微信渠道。
5. 本篇常见错误排查
部署过程中最容易碰到这几类报错，对照处理。
401 Unauthorized / invalid api key
这是模型通道验证失败。检查三处：API Key 是不是复制完整，有没有多余空格；Base URL 是不是https://taotoken.net/api，不要带尾部斜杠；请求头里x-api-key字段名有没有写错。如果用的是 OpenAI 兼容格式，字段名可能是Authorization: Bearer sk-xxx，按文档里的格式来。改完保存，重启 OpenClaw。
local proxy failed / connection refused
这个报错通常出现在 OpenClaw 启动时，Gateway 起不来。先确认端口 18789 没有被其他程序占用。Windows 下用netstat -ano | findstr 18789查，macOS 下用lsof -i :18789查。如果被占用，改 settings.json 里的gateway.port换一个端口。另外确认安全软件没有拦截 Gateway 进程，Windows 下把 OpenClaw 目录加入 Defender 排除项。
reading choices / unexpected end of JSON
这个报错一般是模型返回格式不对，或者请求被截断。检查max_tokens是不是设得太小，设成 4096 试试。如果用的是流式输出，确认 OpenClaw 版本支持。还有一种可能是模型 ID 写错了，去 https://taotoken.net/model-chat 确认可用的模型 ID，填对再试。
OAuth / authentication failed
如果你在配置里误开了 OAuth 模式，但 TaoToken 用的是 API Key 模式，就会报这个。检查 settings.json 里有没有oauth相关字段，删掉，只保留api_key。Claude Code 类工具如果走 OAuth 登录，需要单独配置，不要和 API Key 混用。
安装路径非法 / path contains invalid characters
Windows 和 macOS 都要求纯英文路径。检查路径里有没有中文、空格、特殊符号。比如D:\我的软件\OpenClaw不行，改成D:\OpenClaw。macOS 下/Users/张三/OpenClaw不行，改成/Users/zhangsan/OpenClaw。改完重新启动安装程序。
文件被安全软件隔离删除
关掉所有防护软件，去隔离区恢复文件。如果恢复不了，删掉现有文件夹，用原始压缩包重新解压。解压前先把防护软件关干净，包括后台进程。
Gateway 持续离线
确认防护软件全关、路径格式规范。点界面上的重启网关按钮。如果还是不行，重启程序重新部署。macOS 下还要确认给执行权限的步骤做了，chmod +x和xattr -dr两条命令都执行过。
首次启动加载缓慢
第一次运行要加载大量资源，等 1 到 3 分钟正常。后续启动会快很多。如果超过 5 分钟还没好，看运行日志里卡在哪一步。
6. 跑通之后怎么继续用
两个平台都装好、Key 也配通之后，OpenClaw 的基础环境就稳了。日常用的时候，直接在底部输入框写自然语言指令，Enter 发送，Shift+Enter 换行。左侧区域可以切换本地对话、查看历史任务记录。右上角能看到 Gateway 状态、重启按钮、运行日志和调用额度。
如果你要长期跑编码类任务或者 Agent 工作流，建议把 Coding Plan 配上，额度更划算：https://taotoken.net/coding-plan 。模型调用量大的话，在控制台 https://taotoken.net/console 里可以看用量明细。
接入文档 https://taotoken.net/doc 里有各场景的配置示例，包括 ClaudeCodeAnthropic 的接法。遇到配置问题先去文档里对照，大部分报错都有说明。模型对话页面 https://taotoken.net/model-chat 可以随时测模型通不通，换模型 ID 之前先在那里验一下。
API Key 管理在 https://taotoken.net/api-keys ，可以创建多个 Key 分别给不同设备用，也可以随时吊销。Windows 和 macOS 用同一个 Key 就行，不用分开申请。
后面要加自定义技能、接本地模型、联动飞书或微信渠道，都是在基础环境跑通之后的事。先把这一层稳住，再往上叠功能，出问题的时候好定位。
