1. 为什么我要在双平台折腾 OpenClawOpenClaw 是一个本地运行的 AI 自动化办公工具能读写本地文件、模拟键鼠操作、调用系统程序把「整理下载文件夹」「批量改表格」「定时推送消息」这类重复劳动交给自然语言指令完成。它适合两类人一类是每天被机械操作拖住的后勤、运营、财务岗另一类是想在本地跑通 Agent 链路但不想从零配 Python、Node.js 环境的开发者。我手头一台 macOS 12 的 MacBook 和一台 Windows 11 的台式机两边都要跑同一套自动化脚本所以这篇就把 macOS 与 Windows 的完整搭建流程、config.toml 骨架、settings.json 关键字段以及接入 TaoToken 统一 Key/API 通道的配置一次讲透。先说结论OpenClaw 的安装包已经把 Git、Node.js、Python 这些依赖封装进去了图形化交互部署耗时大概 5 分钟。真正容易卡住的地方不在安装而在配置文件写错、路径带中文、Gateway 起不来、模型通道没接对。下面按平台拆开讲每一步都给可复制的片段。2. TaoToken 前置统一 Key 与 API 通道OpenClaw 本身是执行壳真正干活的是背后的大模型。如果你在 macOS 和 Windows 上分别填不同的模型 Key管理起来会很乱。我的做法是统一走 TaoToken 的 API 通道一个 Key 两端复用。TaoToken 的定位是统一模型接入层你可以在它的控制台里创建 API Key然后在 OpenClaw 的配置里把 base_url 指向https://taotoken.net/api模型名按你开通的填。这样 macOS 和 Windows 用的是同一套凭证换模型只改一个字段。操作路径是这样先到控制台创建 Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建完在 API Keys 页面复制出来页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果你还没想好填哪个模型名可以先去模型对话页面试一下确认通道通了再写进配置地址 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。注意Key 只创建一次两端共用。不要把 Key 写进会提交到 Git 的公开仓库本地配置文件加好权限就行。如果你后面要长期跑编码类、Agent 类任务可以考虑 Coding Plan额度模型更适合高频调用入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节和字段说明看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。3. macOS 与 Windows 安装包获取与解压两个平台的安装包不一样别下错。Windows 对应 v2.9.0macOS 对应 v2.7.9包体都在 45MB 左右。Windows 端下载后建议用 7-Zip 或 WinRAR 解压系统自带解压工具偶尔会丢文件。解压出来是一个带龙虾图标的文件夹双击里面的一键启动程序。如果弹出 Windows SmartScreen 拦截点「更多信息」再点「仍要运行」。macOS 端下载的是压缩包解压后同样找到启动程序。首次打开如果提示「无法验证开发者」去「系统设置 - 隐私与安全性」里点「仍要打开」。macOS 12 及以上都支持。安装路径有个硬性要求必须纯英文不能有中文、空格、特殊符号。推荐D:\OpenClaw、E:\Tools\OpenClaw这种macOS 上推荐/Users/你的用户名/OpenClaw。不建议装到 C 盘或系统盘根目录后面技能插件和模型缓存会占空间留 5G 以上空闲比较稳。注意OpenClaw 有读写本地文件、模拟键鼠的能力这类行为容易被安全软件误判。部署前把 360、腾讯电脑管家、火绒、Windows Defender 实时防护暂时关掉装完再开。项目是开源的介意的话可以去 GitHub 核验源码。4. config.toml 骨架与 settings.json 关键字段安装程序会自动生成一份设备专属配置但默认的模型通道不一定是你想要的。我习惯手动改两个文件config.toml管服务与通道settings.json管界面与执行行为。先看config.toml骨架重点是[gateway]和[model]两段# config.toml [gateway] host 127.0.0.1 port 8765 auto_start true log_level info [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model_name 你的模型名 timeout 120 [workspace] root /Users/yourname/OpenClaw/workspace allow_write true [security] confirm_dangerous true max_file_size_mb 50Windows 上workspace.root换成D:/OpenClaw/workspace注意用正斜杠或者双反斜杠单反斜杠在 TOML 里会被当转义。再看settings.json这个文件控制界面语言、执行模式、快捷键这些{ ui: { language: zh-CN, theme: dark, show_token_usage: true }, execution: { mode: auto, confirm_before_run: true, max_steps: 20 }, shortcuts: { send: Enter, newline: ShiftEnter }, channel: { feishu_enabled: false, webhook_url: } }execution.mode有auto和normal两种auto 会让模型自己拆解任务连续执行normal 每步等你确认。新手建议先用 normal跑顺了再切 auto。max_steps是单次任务最大步数设太大容易跑飞20 步对办公场景够用。两个文件改完保存重启 OpenClaw 让配置生效。5. 验证请求从 Gateway 在线到第一条指令配置改完怎么确认真的通了分三步。第一步看界面右上角。显示「Gateway 在线」说明后台服务起来了。第一次启动会提示「正在等待 Gateway 就绪...」等 1 到 3 分钟正常后续再开就快了。如果一直离线先检查安装路径有没有中文再点右上角重启按钮还不行就关掉程序右键以管理员身份运行Windows或 sudo 启动macOS。第二步验证模型通道。在底部输入框发一句最简单的你好请回复你的模型名称如果返回正常说明 TaoToken 的 base_url 和 Key 都对了。如果报 401是 Key 错了报 404是 model_name 填错了报超时检查网络和 base_url 有没有多写斜杠。第三步跑一条真实自动化指令。我常用的测试指令是统计当前电脑各个磁盘的剩余存储空间整理成文字输出这条指令不涉及写文件安全能验证模型拆解任务和调用系统工具的能力。跑通之后可以试稍微复杂点的将 D 盘下载文件夹按照文件类型分类新建对应文件夹并归类文件macOS 上把路径换成/Users/yourname/Downloads。执行前confirm_before_run为 true 的话会弹确认看清楚再点。6. 本篇常见错排查安装后点击启动没反应。九成是安全软件把核心文件隔离了。把防护全关删掉解压出来的整个文件夹重新解压再装。别只删 exe要删干净。Gateway 一直离线。按顺序查安装路径是否纯英文、端口 8765 是否被占用、是否以管理员权限运行。端口占用的话改config.toml里的port换成 8766 或 8877。模型请求报错。对照错误码401 查 Key404 查 model_name429 是额度或频率问题超时查 base_url 和网络。TaoToken 的 base_url 是https://taotoken.net/api注意结尾不要多加/v1除非文档明确要求。config.toml 改了不生效。TOML 对格式敏感字符串必须用双引号布尔值是小写true/false。改完一定要重启程序热加载不一定支持。macOS 提示权限不足。去「系统设置 - 隐私与安全性 - 辅助功能」和「完全磁盘访问权限」里把 OpenClaw 加进去并勾选。模拟键鼠和读写文件都需要这两个权限。Windows 路径写错。TOML 里写D:\OpenClaw会被解析成转义字符要么写D:/OpenClaw要么写D:\\OpenClaw。这个坑我踩过报错信息还不明显就是找不到路径。指令发出去没响应。先确认 Gateway 是在线状态离线状态下输入框是发不出去的。在线还不行就重启程序再不行重装一遍配置文件先备份出来。7. 双平台跑通之后怎么继续用两端都跑通之后日常就是双击桌面快捷方式启动不用再解压。版本更新直接下新包覆盖原文件夹配置文件和 workspace 数据不会丢但覆盖前建议把config.toml和settings.json备份一份。需要对接飞书下发指令的话在设置里的聊天渠道填 webhooksettings.json里把feishu_enabled改成 true。这块配置和 API 接入是分开的模型通道还是走 TaoToken。如果你想把 OpenClaw 接到 Claude Code 这类编码工具的工作流里Anthropic 兼容通道的说明在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 字段和上面[model]段基本一致改 provider 和 model_name 就行。最后提醒一句security.confirm_dangerous别关。OpenClaw 能删文件能改系统auto 模式下模型判断失误是真会动手的。办公场景里多一次确认比少一次事故划算。