1. 为什么要在 Mac 本地折腾 OpenClaw 这套部署链路OpenClaw 是一个可以跑在本地、通过聊天工具远程调用的 AI Agent 网关简单说就是你在 Mac 上把它跑起来它帮你把「模型调用」和「聊天入口」这两件事串成一条线。适合谁适合手里只有一台 Mac、想在自己机器上跑一个可复现 Agent 实例、又不想把 Key 散落在各个工具里的开发者。我这次的目标很明确Mac 本地从零部署 OpenClawNode.js 版本校验、Docker 容器编排、本地端口映射全部跑通最后用 TaoToken 的统一 Key 把模型通道接上再用 curl 验证本地服务和 Key 通道都活着。很多人卡住不是因为 OpenClaw 本身难而是环境太碎Node 版本不对、pnpm 没装、Docker 没起、端口被占、Key 填错位置。这篇就按「先环境、再容器、再配置、再验证、再排障」的顺序走一遍每一步都给可复制的命令和配置。你跟着敲基本能复现出一个能用的本地实例。核心检索词先摆出来OpenClaw 在 Mac 本地部署本质是 Node.js 服务 Docker 沙箱 网关端口 模型通道四件事。Node.js 负责跑 OpenClaw 主进程Docker 负责隔离执行环境端口映射负责让本地 curl 和聊天工具能访问到网关TaoToken 统一 Key 负责把模型调用收敛到一个入口。这四件事任何一件没通后面都会报错所以顺序不能乱。我实测下来Mac 上最容易翻车的点是 Node 版本低于 22、Docker Desktop 没启动、以及网关端口和别的服务撞车。下面按步骤来每一步都有校验动作别跳。2. TaoToken 前置准备统一 Key 与 Base URL 怎么拿在动 OpenClaw 之前先把模型通道准备好。OpenClaw 支持 Custom Provider也就是你可以填任意兼容 OpenAI 接口的 Base URL 和 Key。这里用 TaoToken 做统一入口好处是后面不管换哪个模型只改 Model IDBase URL 和 Key 不用动。第一步打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进控制台找到 API Keys 页面创建一个新的 Key。这个 Key 就是后面填进 OpenClaw 配置里的凭证复制出来先存好别截图发群里。第二步确认 Base URL。TaoToken 的 API 地址是 https://taotoken.net/api 注意这里不带任何查询参数填配置的时候就用这个。OpenClaw 里配置 Custom Provider 时Base URL 填这个兼容性类型选 OpenAI 兼容。第三步确认 Model ID。你可以在模型对话页面先试一下想用的模型确认能正常返回再把 Model ID 抄到 OpenClaw 配置里。Model ID 的格式一般是厂商/模型名这种具体以你控制台里看到的为准。别凭记忆写写错了会报 model not found。这里有个细节OpenClaw 的配置向导里会让你填 Endpoint ID 和模型别名这两个默认即可不用改。真正要改的是 Base URL、API Key、Model ID 这三件套。我建议你在一个临时文件里先把这三行写好Base URL: https://taotoken.net/api API Key: 你的 TaoToken Key Model ID: 你选定的模型 ID这样后面填向导的时候直接复制减少手抖。如果你后面要用 Claude Code 或者 Coding Plan 做长期编码任务也可以在同一套 Key 体系下切换不用重新配环境。需要看接入细节的话接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。3. 可复制配置Node.js 校验 docker-compose.yml 环境变量模板这一节是全文最核心的部分所有配置都给全你直接复制改路径就行。3.1 Node.js 与 pnpm 版本校验OpenClaw 要求 Node.js 22。先检查node -v如果输出 v22.x.x 或更高跳过安装。如果低于 22 或者提示 command not found用 Homebrew 装brew install node node -vpnpm 的依赖管理比 npm 稳装一下npm install -g pnpm pnpm -vgit 一般 Mac 自带没有就brew install git。Docker 用 Desktop 版brew install --cask docker装完一定要手动打开 Docker Desktop等右上角鲸鱼图标稳定再执行docker info能看到 Server 信息才算 Docker 真的起来了。这一步很多人漏掉后面容器起不来就是这里的问题。3.2 docker-compose.yml 完整片段在你想放项目的目录下建一个文件夹比如~/openclaw-local进去创建docker-compose.ymlversion: 3.9 services: openclaw-gateway: image: node:22-alpine container_name: openclaw-gateway working_dir: /app volumes: - ./workspace:/app/workspace - ./config:/app/config ports: - 18789:18789 environment: - NODE_ENVproduction - OPENCLAW_GATEWAY_PORT18789 - OPENCLAW_WORKSPACE/app/workspace - OPENCLAW_CONFIG/app/config/openclaw.json - TAOTOKEN_BASE_URLhttps://taotoken.net/api - TAOTOKEN_API_KEY${TAOTOKEN_API_KEY} - TAOTOKEN_MODEL_ID${TAOTOKEN_MODEL_ID} command: sh -c npm install -g openclaw openclaw gateway start --port 18789 restart: unless-stopped注意端口 18789 是网关端口你可以改成别的但要和后面配置里一致。volumes 把 workspace 和 config 挂出来方便你在 Mac 上直接改文件。3.3 环境变量模板同目录建.env文件TAOTOKEN_API_KEY你的TaoTokenKey TAOTOKEN_MODEL_ID你选定的模型ID这个.env不要提交到 git加进.gitignore。3.4 OpenClaw 配置文件模板建config/openclaw.json{ gateway: { port: 18789, bind: 127.0.0.1, auth: token }, workspace: /app/workspace, provider: { type: custom, compatibility: openai, baseUrl: https://taotoken.net/api, apiKey: ${TAOTOKEN_API_KEY}, modelId: ${TAOTOKEN_MODEL_ID} } }这份配置里Base URL、API Key、Model ID 三件套齐全兼容性类型是 openai对应 OpenClaw 向导里的 Custom Provider。如果你不用容器直接在 Mac 上跑openclaw onboard --install-daemon向导里填的也是这三样选 Custom ProviderBase URL 填https://taotoken.net/apiKey 填你的 TaoToken KeyModel ID 填你选的模型。3.5 启动命令cd ~/openclaw-local docker compose up -d docker compose logs -f openclaw-gateway看到日志里出现 gateway listening on 18789 就说明起来了。如果日志报端口占用改.env和 compose 里的端口再docker compose down docker compose up -d。4. 验证请求curl 打通本地服务与 TaoToken Key 通道容器起来不代表通道通必须验证两件事本地网关能响应TaoToken Key 能调通模型。4.1 验证本地网关curl -s http://127.0.0.1:18789/health正常返回类似{status:ok}。如果返回 connection refused说明容器没起或者端口没映射回去看docker compose ps和日志。4.2 验证 TaoToken Key 通道直接用 curl 打 TaoToken 的接口确认 Key 和 Base URL 没问题curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: $TAOTOKEN_MODEL_ID, messages: [{role: user, content: ping}], max_tokens: 16 }如果返回里有choices字段和内容说明 Key 通道通了。如果返回 401检查 Key 有没有复制全、有没有多余空格。如果返回 model not found检查 Model ID 是不是和控制台里一致。4.3 验证 OpenClaw 走通模型通过 OpenClaw 网关发一条测试请求curl -s http://127.0.0.1:18789/v1/chat/completions \ -H Authorization: Bearer local-token \ -H Content-Type: application/json \ -d { model: $TAOTOKEN_MODEL_ID, messages: [{role: user, content: hello}] }这一步如果返回正常内容说明 OpenClaw 已经把请求转发到 TaoToken 并拿到结果整条链路通了。如果这一步报错但 4.2 是通的问题在 OpenClaw 配置里的 provider 段重点看 baseUrl 和 apiKey 有没有被正确读取。4.4 成功结果长什么样成功的返回结构里会有id、object、choices数组choices[0].message.content就是模型回复。你看到这个就可以去配聊天工具了。飞书那边创建机器人、拿 App ID 和 App Secret、配事件订阅这些在 OpenClaw 向导里按提示填即可核心还是前面这三件套先通。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来遇到哪个查哪个。401 Unauthorized最常见。原因有三种Key 复制不全、Key 前后有空格、Key 已经失效。解决重新在 API Keys 页面生成一个用echo $TAOTOKEN_API_KEY确认环境变量里没有换行和空格。如果是 OpenClaw 容器里报 401检查.env有没有被 compose 正确加载docker compose config可以看到最终解析的环境变量。local proxy failed这个通常出现在 OpenClaw 网关转发阶段说明网关进程活着但连不上上游。检查config/openclaw.json里的 baseUrl 是不是https://taotoken.net/api注意不要多写/v1OpenClaw 会自己拼路径。另外确认容器网络能出网docker exec -it openclaw-gateway ping -c 2 taotoken.net试一下。reading choices 报错一般是返回体不是预期 JSON可能是上游返回了错误页或者空响应。先用 4.2 的 curl 单独验证 TaoToken 通道确认通道本身没问题。如果通道没问题检查 OpenClaw 配置里的 compatibility 是不是 openai写错会导致解析失败。OAuth 相关报错如果你在配飞书或者别的聊天工具时看到 OAuth 错误重点检查 App ID、App Secret、回调地址三样。飞书开放平台里权限要开 P2P 消息、message、resource 这几项事件订阅的地址要指向你 OpenClaw 网关暴露的地址。本地测试时如果聊天工具回调不到 127.0.0.1需要用内网穿透或者把网关绑到可访问地址但注意别把网关直接暴露到公网。端口占用docker compose up报 port is already allocated用lsof -i :18789查谁占了改端口或者停掉占用进程。Node 版本不对openclaw命令报语法错误或者 engine 不匹配node -v确认 22用brew upgrade node升级。Docker 没启动docker compose up报 Cannot connect to the Docker daemon打开 Docker Desktop 等它稳定再docker info确认。排查顺序建议先 4.1 本地网关再 4.2 TaoToken 通道再 4.3 OpenClaw 转发。哪一层断就查哪一层别一上来就改配置。6. 把 Key 通道固定下来后续接入与长期使用建议链路跑通之后建议把配置固定成可复现的状态。.env和config/openclaw.json都留在项目目录里换机器时复制这两个文件加docker-compose.yml就能重建。Key 不要硬编码进 JSON用环境变量注入这样换 Key 只改.env。如果你后面要做长期编码或者 Agent 任务可以在 TaoToken 的 Coding Plan 页面看一下适合的套餐地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。模型对话调试在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。Claude Code 相关的接入在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 。一个实用技巧把 4.2 那条 curl 存成一个check.sh每次改完配置先跑一遍确认 Key 通道没坏再去动 OpenClaw。这样排障范围能缩小一半。另一个坑是 Docker 容器里的环境变量不会自动读.env里的所有变量只有 compose 文件里显式引用的才会注入所以新增变量记得同步改 compose。最后OpenClaw 的 workspace 目录挂出来之后你可以在 Mac 上直接用编辑器改里面的文件容器里会实时看到。网关端口建议固定一个不常用的避免和本地其他服务撞车。整套跑下来你得到的是一个本地可复现的 OpenClaw 实例模型通道走 TaoToken 统一 Key后面换模型只改一个 Model ID。