1. 为什么要在 Win/Mac 上折腾 OpenClaw 2.7.9 离线部署OpenClaw 2.7.9 是一款本地运行的 AI 智能体工具社区里因为它的龙虾图标习惯叫它「小龙虾」。它能做的事情很具体接管键鼠模拟、批量整理本地文件、跑浏览器自动化、把重复的办公流程串成一条指令执行。和云端 Agent 最大的区别是它的操作数据全部留在本机不往外传这对处理合同、报表、内部文档这类场景比较友好。但真正上手时很多人卡在同一个地方装是装上了可模型通道没配通Gateway 一直显示离线指令发出去没反应。尤其是离线或内网环境没法直接调公网模型服务这时候就需要一个统一的 Key/API 通道来兜底。我这次的做法是OpenClaw 2.7.9 负责本地执行TaoToken 负责提供统一的模型调用入口两边通过配置文件对接Win 和 Mac 用同一套 Key切换成本几乎为零。这篇教程面向的是想一次部署成功的人不管你是 Windows 11 还是 macOS跟着走完配置骨架、CC Switch 切换、连通性验证三步就能让全办公场景跑起来。下面所有配置片段都可以直接复制路径和参数我会标清楚哪些必须改、哪些保持默认。2. 部署前准备与 TaoToken 统一 Key 前置先说清楚 TaoToken 在这里的角色。它是一个统一的模型 API 通道你只需要申请一个 Key就能在 OpenClaw 里调用对话模型不用为每个模型单独配一套鉴权。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。拿 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 新建一个 Key 并复制保存。这个 Key 只显示一次丢了只能重建。第二步确认你要用的模型。如果你只是日常办公自动化模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 可以先试跑几条指令确认响应正常再写进配置。第三步如果你打算长期跑编码类或 Agent 类任务建议看一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它的额度模型更适合高频调用比按次计费省心。注意Key 属于敏感凭证不要写进会提交到 Git 的公开仓库。本地配置文件建议放在用户目录下权限设为仅当前用户可读。环境侧的准备Win 和 Mac 略有差异。Windows 11 需要临时关闭 Defender 实时防护和第三方安全软件因为 OpenClaw 要调用键鼠模拟和文件读写接口容易被误判。Mac 则需要在「系统设置 - 隐私与安全性 - 辅助功能」里给 OpenClaw 授权否则键鼠控制会失效。安装路径统一用纯英文别带中文和空格这是后面很多报错的根源。3. 可复制的 config.toml 与 settings.json 配置骨架OpenClaw 2.7.9 的配置分两层主配置用 config.toml界面和切换相关的用 settings.json。下面这份骨架我按 Win/Mac 通用写的你只需要替换 Key 和路径。先看 config.toml放在 OpenClaw 安装目录的 config 子目录下# OpenClaw 2.7.9 主配置 [gateway] host 127.0.0.1 port 8765 auto_start true [model] # TaoToken 统一通道 provider taotoken base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_name claude-sonnet timeout 60 max_retries 3 [agent] workspace D:/OpenClaw/workspace allow_file_write true allow_browser_control true log_level info [security] local_only true telemetry falseMac 用户把 workspace 改成/Users/你的用户名/OpenClaw/workspace即可其余不变。base_url 这里填的是 TaoToken 的 API 根地址不要在后面加多余的斜杠。再看 settings.json它管的是 CC Switch 的通道切换和界面偏好{ cc_switch: { active_profile: taotoken-default, profiles: [ { name: taotoken-default, provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet }, { name: taotoken-coding, provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-opus } ] }, ui: { language: zh-CN, theme: dark, show_gateway_status: true } }这两个文件的关系是config.toml 决定 Gateway 启动时加载哪套模型参数settings.json 决定你在界面里能切换到哪些 profile。CC Switch 切换的本质就是改 settings.json 里的 active_profile 字段然后让 Gateway 重载。配置写完后检查三个点Key 有没有多余空格、base_url 是不是 https 开头、workspace 路径是否存在。这三点占了我遇到的配置类报错的一大半。4. CC Switch 切换步骤与离线连通性验证配置骨架搭好后先别急着发指令走一遍切换和验证流程。CC Switch 切换有两种方式。界面方式打开 OpenClaw 主界面右上角找到通道切换入口下拉选择 taotoken-default点击应用界面会提示 Gateway 重载。命令行方式更适合脚本化# 进入 OpenClaw 安装目录 cd /path/to/openclaw # 查看当前激活的 profile ./openclaw cc-switch --list # 切换到指定 profile ./openclaw cc-switch --use taotoken-default # 重载 Gateway ./openclaw gateway reloadWindows 下把./openclaw换成openclaw.exe即可。切换完成后界面右上角状态应该从「Gateway 离线」变成「Gateway 在线」。接下来做连通性验证。最直接的方式是用 curl 打一次 TaoToken 的接口确认 Key 和网络都通curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet, messages: [{role: user, content: 回复 ok}] }如果返回里有正常的 choices 字段说明通道没问题。如果返回 401检查 Key返回 404检查 base_url 有没有写错超时则看本机网络策略是否拦了出站请求。通道通了之后回到 OpenClaw 界面发一条真实指令验证端到端帮我整理 D 盘下载文件夹内所有图片文件按月份归类到子文件夹正常情况下OpenClaw 会先解析指令调用模型生成执行计划然后通过本地键鼠和文件接口执行。你会在界面上看到每一步的动作日志。如果指令发出后卡在「思考中」不动多半是模型通道没通回到上一步重新验证。离线环境下的验证要额外注意如果你的机器完全不能出网那 TaoToken 通道本身也调不通这时候需要确认你的部署场景是否允许访问 https://taotoken.net/api 。如果允许访问但走的是内网出口检查出口有没有做 TLS 拦截拦截会导致证书校验失败。5. 本篇常见错误排查部署过程中高频出现的几个问题我按现象归类整理方便你对号入座。Gateway 一直离线。先看 config.toml 里 auto_start 是不是 true再看端口 8765 有没有被占用。Windows 下用netstat -ano | findstr 8765查Mac 用lsof -i :8765。端口被占就改 port 字段改完重启 Gateway。权限不足键鼠控制失效。Windows 右键启动程序选「以管理员身份运行」Mac 去「系统设置 - 隐私与安全性 - 辅助功能」勾选 OpenClaw。这一步不做文件读写和浏览器控制都会静默失败。中文路径导致启动报错。OpenClaw 对路径里的中文和空格兼容不好安装目录和 workspace 都改成纯英文。已经装到中文目录的卸载后换路径重装别想着改配置绕过。API 返回 401 或 403。九成是 Key 问题复制时带了空格、Key 被删除、或者用了别的通道的 Key。去 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 重新生成一个替换后重载。模型响应很慢或超时。先确认 timeout 设的是 60 秒以上再看是不是选了体量大的模型。日常办公用 claude-sonnet 就够需要复杂推理再切 claude-opus。如果长期高频调用考虑上 Coding Plan额度模型比单次调用更稳。CC Switch 切换后不生效。检查 settings.json 里 active_profile 的名字和 profiles 数组里的 name 是否完全一致大小写和连字符都不能差。改完记得执行 gateway reload光改文件不重载是不生效的。6. 全办公场景落地与后续接入配置跑通之后OpenClaw 能覆盖的办公场景比想象中多。文件批量归类、浏览器数据抓取、表格生成、本地冗余文件清理这些都可以用自然语言下发。我自己的用法是把常用指令存成模板每天开工前跑一遍省掉大量重复点击。如果你要把它接到更复杂的流程里比如让 OpenClaw 调用外部工具链或者做多步 Agent 编排建议先看接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面把 API 参数和返回结构讲得比较细。需要长期跑编码类任务的Coding Plan 的额度模型更适合不用每次担心调用次数。最后提醒一句离线部署的核心不是装得多快而是配置骨架搭得对不对。config.toml 和 settings.json 这两个文件理顺了Win 和 Mac 就是同一套逻辑换机器只需要改路径和 Key。把连通性验证做成习惯每次切换通道后先 curl 一次能省掉后面大量排查时间。
