1. 为什么要在 macOS 上折腾 OpenClaw 本地智能体OpenClaw 是一个跑在你自己电脑上的 AI 智能体平台它能听懂自然语言指令然后直接帮你操作文件、控制浏览器、收发消息。所有数据都存在本地~/.openclaw/目录里默认不上传云端适合对隐私敏感、又想体验自动化办公的个人或小团队。macOS 因为自带 Unix 环境和 LaunchAgent 守护进程机制跑这类本地服务天然顺手10.15 以上系统都能装推荐 12 以上。但真正落地时很多人卡在同一个地方模型 Key 太分散。OpenClaw 本身支持 DeepSeek、GPT、Kimi 等多个模型每个模型都要单独申请 Key、单独填 baseUrl、单独管额度。一旦你想切换模型或者加一个备用模型就得翻好几个平台的控制台改配置改到怀疑人生。更麻烦的是有些模型接口地址不统一写死在openclaw.json里之后换环境就得重来一遍。这篇就聚焦 macOS 实操把 OpenClaw 的部署流程走通同时用 TaoToken 的统一 Key 把多模型接入这件事收口。你会拿到可直接复制的config.toml和settings.json骨架、TaoToken 接入步骤以及终端验证连通性的具体命令和预期输出。目标很明确从装完到能调用模型闭环跑通。2. TaoToken 统一 Key 的前置准备TaoToken 在这里扮演的角色是模型调用的统一入口。你不需要为每个模型单独维护一套 Key 和 baseUrl而是通过一个统一 Key 来路由到不同模型。对 OpenClaw 这种需要频繁切换模型的场景来说配置复杂度会明显下降。先做两件事。第一注册并登录 TaoToken 控制台拿到你的 API Key。第二确认你要用的模型在 TaoToken 的模型列表里比如 DeepSeek Chat、DeepSeek Reasoner 这些。拿到 Key 之后OpenClaw 的模型配置里 baseUrl 统一指向https://taotoken.net/apiapiKey 填你申请到的那一个。这里有个细节要注意OpenClaw 的模型配置节点在~/.openclaw/openclaw.json的models.providers下面。如果你之前已经配过 DeepSeek 官方地址现在要改成 TaoToken 的地址同时把 apiKey 换成 TaoToken 的 Key。改完之后不需要动 agents 里的模型引用因为模型 id 还是deepseek/deepseek-chat只是底层走的路由变了。如果你还没有 Key可以直接去控制台创建一个。创建时建议给 Key 起个能认出来的名字比如openclaw-mac方便后面排查问题时定位。注意TaoToken 的 API 地址是https://taotoken.net/api不要加多余的路径后缀。OpenClaw 会自动拼接/v1/chat/completions这类端点。3. macOS 环境准备与 OpenClaw 安装3.1 装 Node.js 和基础依赖OpenClaw 需要 Node.js v22 以上。macOS 上最省事的方式是用 Homebrewbrew install node22装完之后验证一下node -v预期输出类似v22.22.0。如果版本不对可能是系统里还有旧版 Node用which node看一下路径确保指向 Homebrew 装的那个。如果 brew 安装过程中报权限错误或者你不想动系统级 Node改用 nvm 管理curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash然后重新打开终端或者执行source ~/.zshrcmacOS 默认是 zsh。接着装指定版本nvm install 22.22.0 nvm use 22.22.0 node -v输出v22.22.0就对了。3.2 安装 OpenClaw 并初始化工作空间全局安装npm install -g openclaw-cn验证openclaw --version能输出版本号就说明装好了。接着初始化工作空间openclaw workspace init这一步会在~/.openclaw/下生成核心文件。重点看这几个文件名路径作用openclaw.json~/.openclaw/全局配置模型、通道、权限都在这IDENTITY.md~/.openclaw/workspace/定义 AI 助理身份SOUL.md~/.openclaw/workspace/设定行为准则MEMORY.md~/.openclaw/workspace/长期记忆存储TOOLS.md~/.openclaw/workspace/可用工具列表这些文件不用全部手改但openclaw.json是必须动的。4. 可复制的 config.toml 与 settings.json 配置骨架OpenClaw 的配置分两块一块是~/.openclaw/openclaw.json管模型和通道另一块是工作空间里的settings.json管智能体行为和工具权限。下面给的是可直接复制的骨架你只需要替换 Key 和 appId 这类占位符。4.1 openclaw.json 模型配置TaoToken 统一 Key打开~/.openclaw/openclaw.json找到models节点改成这样{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken-API-Key, models: [ { id: deepseek-chat, name: DeepSeek Chat, contextWindow: 16384 }, { id: deepseek-reasoner, name: DeepSeek Reasoner, contextWindow: 32768 } ] } } }, agents: { defaults: { model: { primary: taotoken/deepseek-chat, fallback: taotoken/deepseek-reasoner } } } }关键点baseUrl统一指向 TaoTokenapiKey只填一个。primary和fallback都走同一个 provider切换模型时只改 id 就行不用再动 Key。4.2 settings.json 工作空间配置在~/.openclaw/workspace/settings.json里控制智能体的行为边界{ agent: { name: Mac 办公助手, language: zh-CN, maxTokens: 4096, temperature: 0.7 }, tools: { file: { enabled: true, allowedPaths: [~/Desktop, ~/Documents/OpenClaw] }, browser: { enabled: true, headless: false }, shell: { enabled: false } }, memory: { enabled: true, maxEntries: 500 } }allowedPaths限制文件操作范围避免智能体乱翻目录。shell默认关掉需要时再开。4.3 飞书通道配置可选如果你要用飞书发指令在openclaw.json里加channels节点{ channels: { feishu: { accounts: { default: { appId: 你的飞书-appId, appSecret: 你的飞书-appSecret, enabled: true, permissions: [message:read, message:send] } } } } }飞书那边需要在开放平台创建企业自建应用启用消息接收权限并把事件订阅指向 OpenClaw 的网关地址。5. 启动网关与验证模型调用5.1 启动网关配置改完后启动 OpenClaw 网关openclaw gateway start检查状态openclaw gateway status预期输出会显示网关运行中端口 18789 监听正常。如果状态是 stopped先看日志openclaw gateway status --verbose5.2 验证 TaoToken 连通性直接用 OpenClaw 的模型测试命令指定 TaoToken 下的 DeepSeek Chatopenclaw model test taotoken/deepseek-chat --prompt用一句话说明当前目录下有哪些文件如果配置正确终端会返回模型生成的回答。第一次调用可能会慢几秒因为要建立连接。如果报错重点看错误信息里的状态码401 是 Key 不对404 是 baseUrl 或模型 id 写错429 是额度或频率限制。5.3 用 curl 直接验证 TaoToken 接口想绕过 OpenClaw 单独确认 TaoToken 通不通可以用 curlcurl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的TaoToken-API-Key \ -H Content-Type: application/json \ -d { model: deepseek-chat, messages: [{role: user, content: 回复 OK}] }预期返回 JSON 里choices[0].message.content包含OK。这一步能通说明 Key 和网络都没问题问题就缩小到 OpenClaw 配置层面了。5.4 测试技能调用装一个基础技能试试openclaw clawhub search apple-notes openclaw clawhub install apple-notes openclaw skill test apple-notes --prompt创建名为 OpenClaw 测试的笔记如果技能正常执行说明工具层也通了。6. 本篇常见错排查6.1 网关启动失败端口 18789 被占用macOS 上常见原因是之前启动的网关没退干净。查占用lsof -i :18789找到 PID 后杀掉kill -9 [PID]然后重新openclaw gateway start。6.2 模型调用返回 401先确认openclaw.json里的 apiKey 是不是 TaoToken 的 Key而不是 DeepSeek 官方的 Key。两者不通用。如果 Key 没错检查有没有多余空格或换行。改完配置后必须重启网关openclaw gateway restart6.3 模型调用返回 404大概率是 baseUrl 写错了。TaoToken 的地址是https://taotoken.net/api不要写成https://taotoken.net/api/v1OpenClaw 会自己拼/v1。另外确认模型 id 在 TaoToken 的模型列表里存在比如deepseek-chat和deepseek-reasoner是分开的两个 id。6.4 飞书消息发不出去按顺序查三件事飞书应用有没有开message:send权限事件订阅的请求地址是不是指向网关的公网地址网关有没有重启。改完飞书配置后执行openclaw channel test feishu看返回的具体错误码。6.5 技能安装后无法执行先看技能列表openclaw skill list确认技能状态是 installed。然后看技能文档openclaw skill docs apple-notes有些技能依赖外部工具比如 Apple Notes 技能需要 macOS 的自动化权限。去系统设置里给终端开一下辅助功能权限。7. 接入文档与后续操作入口配置跑通之后日常用起来就三件事改模型、加技能、看日志。改模型只动openclaw.json里的primary字段Key 不用换。加技能走openclaw clawhub install。看日志用openclaw gateway status --verbose或者直接翻~/.openclaw/logs/下的文件。如果你需要管理多个 Key 或者查看调用量去 TaoToken 控制台的 API Keys 页面。接入文档里有各模型的参数说明和错误码对照排障时比盲猜快很多。想先试试模型对话效果可以直接在模型对话页面发一条消息确认 Key 和模型都正常再回到 OpenClaw 里配。长期跑编码任务或者 Agent 工作流的话Coding Plan 的额度模型更适合高频调用不用每次担心按量计费的心跳感。先把这篇的闭环跑通后面扩模型、加通道都是在这个骨架上叠东西。
1. 为什么要在 macOS 上折腾 OpenClaw 本地智能体OpenClaw 是一个跑在你自己电脑上的 AI 智能体平台它能听懂自然语言指令然后直接帮你操作文件、控制浏览器、收发消息。所有数据都存在本地~/.openclaw/目录里默认不上传云端适合对隐私敏感、又想体验自动化办公的个人或小团队。macOS 因为自带 Unix 环境和 LaunchAgent 守护进程机制跑这类本地服务天然顺手10.15 以上系统都能装推荐 12 以上。但真正落地时很多人卡在同一个地方模型 Key 太分散。OpenClaw 本身支持 DeepSeek、GPT、Kimi 等多个模型每个模型都要单独申请 Key、单独填 baseUrl、单独管额度。一旦你想切换模型或者加一个备用模型就得翻好几个平台的控制台改配置改到怀疑人生。更麻烦的是有些模型接口地址不统一写死在openclaw.json里之后换环境就得重来一遍。这篇就聚焦 macOS 实操把 OpenClaw 的部署流程走通同时用 TaoToken 的统一 Key 把多模型接入这件事收口。你会拿到可直接复制的config.toml和settings.json骨架、TaoToken 接入步骤以及终端验证连通性的具体命令和预期输出。目标很明确从装完到能调用模型闭环跑通。2. TaoToken 统一 Key 的前置准备TaoToken 在这里扮演的角色是模型调用的统一入口。你不需要为每个模型单独维护一套 Key 和 baseUrl而是通过一个统一 Key 来路由到不同模型。对 OpenClaw 这种需要频繁切换模型的场景来说配置复杂度会明显下降。先做两件事。第一注册并登录 TaoToken 控制台拿到你的 API Key。第二确认你要用的模型在 TaoToken 的模型列表里比如 DeepSeek Chat、DeepSeek Reasoner 这些。拿到 Key 之后OpenClaw 的模型配置里 baseUrl 统一指向https://taotoken.net/apiapiKey 填你申请到的那一个。这里有个细节要注意OpenClaw 的模型配置节点在~/.openclaw/openclaw.json的models.providers下面。如果你之前已经配过 DeepSeek 官方地址现在要改成 TaoToken 的地址同时把 apiKey 换成 TaoToken 的 Key。改完之后不需要动 agents 里的模型引用因为模型 id 还是deepseek/deepseek-chat只是底层走的路由变了。如果你还没有 Key可以直接去控制台创建一个。创建时建议给 Key 起个能认出来的名字比如openclaw-mac方便后面排查问题时定位。注意TaoToken 的 API 地址是https://taotoken.net/api不要加多余的路径后缀。OpenClaw 会自动拼接/v1/chat/completions这类端点。3. macOS 环境准备与 OpenClaw 安装3.1 装 Node.js 和基础依赖OpenClaw 需要 Node.js v22 以上。macOS 上最省事的方式是用 Homebrewbrew install node22装完之后验证一下node -v预期输出类似v22.22.0。如果版本不对可能是系统里还有旧版 Node用which node看一下路径确保指向 Homebrew 装的那个。如果 brew 安装过程中报权限错误或者你不想动系统级 Node改用 nvm 管理curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash然后重新打开终端或者执行source ~/.zshrcmacOS 默认是 zsh。接着装指定版本nvm install 22.22.0 nvm use 22.22.0 node -v输出v22.22.0就对了。3.2 安装 OpenClaw 并初始化工作空间全局安装npm install -g openclaw-cn验证openclaw --version能输出版本号就说明装好了。接着初始化工作空间openclaw workspace init这一步会在~/.openclaw/下生成核心文件。重点看这几个文件名路径作用openclaw.json~/.openclaw/全局配置模型、通道、权限都在这IDENTITY.md~/.openclaw/workspace/定义 AI 助理身份SOUL.md~/.openclaw/workspace/设定行为准则MEMORY.md~/.openclaw/workspace/长期记忆存储TOOLS.md~/.openclaw/workspace/可用工具列表这些文件不用全部手改但openclaw.json是必须动的。4. 可复制的 config.toml 与 settings.json 配置骨架OpenClaw 的配置分两块一块是~/.openclaw/openclaw.json管模型和通道另一块是工作空间里的settings.json管智能体行为和工具权限。下面给的是可直接复制的骨架你只需要替换 Key 和 appId 这类占位符。4.1 openclaw.json 模型配置TaoToken 统一 Key打开~/.openclaw/openclaw.json找到models节点改成这样{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken-API-Key, models: [ { id: deepseek-chat, name: DeepSeek Chat, contextWindow: 16384 }, { id: deepseek-reasoner, name: DeepSeek Reasoner, contextWindow: 32768 } ] } } }, agents: { defaults: { model: { primary: taotoken/deepseek-chat, fallback: taotoken/deepseek-reasoner } } } }关键点baseUrl统一指向 TaoTokenapiKey只填一个。primary和fallback都走同一个 provider切换模型时只改 id 就行不用再动 Key。4.2 settings.json 工作空间配置在~/.openclaw/workspace/settings.json里控制智能体的行为边界{ agent: { name: Mac 办公助手, language: zh-CN, maxTokens: 4096, temperature: 0.7 }, tools: { file: { enabled: true, allowedPaths: [~/Desktop, ~/Documents/OpenClaw] }, browser: { enabled: true, headless: false }, shell: { enabled: false } }, memory: { enabled: true, maxEntries: 500 } }allowedPaths限制文件操作范围避免智能体乱翻目录。shell默认关掉需要时再开。4.3 飞书通道配置可选如果你要用飞书发指令在openclaw.json里加channels节点{ channels: { feishu: { accounts: { default: { appId: 你的飞书-appId, appSecret: 你的飞书-appSecret, enabled: true, permissions: [message:read, message:send] } } } } }飞书那边需要在开放平台创建企业自建应用启用消息接收权限并把事件订阅指向 OpenClaw 的网关地址。5. 启动网关与验证模型调用5.1 启动网关配置改完后启动 OpenClaw 网关openclaw gateway start检查状态openclaw gateway status预期输出会显示网关运行中端口 18789 监听正常。如果状态是 stopped先看日志openclaw gateway status --verbose5.2 验证 TaoToken 连通性直接用 OpenClaw 的模型测试命令指定 TaoToken 下的 DeepSeek Chatopenclaw model test taotoken/deepseek-chat --prompt用一句话说明当前目录下有哪些文件如果配置正确终端会返回模型生成的回答。第一次调用可能会慢几秒因为要建立连接。如果报错重点看错误信息里的状态码401 是 Key 不对404 是 baseUrl 或模型 id 写错429 是额度或频率限制。5.3 用 curl 直接验证 TaoToken 接口想绕过 OpenClaw 单独确认 TaoToken 通不通可以用 curlcurl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的TaoToken-API-Key \ -H Content-Type: application/json \ -d { model: deepseek-chat, messages: [{role: user, content: 回复 OK}] }预期返回 JSON 里choices[0].message.content包含OK。这一步能通说明 Key 和网络都没问题问题就缩小到 OpenClaw 配置层面了。5.4 测试技能调用装一个基础技能试试openclaw clawhub search apple-notes openclaw clawhub install apple-notes openclaw skill test apple-notes --prompt创建名为 OpenClaw 测试的笔记如果技能正常执行说明工具层也通了。6. 本篇常见错排查6.1 网关启动失败端口 18789 被占用macOS 上常见原因是之前启动的网关没退干净。查占用lsof -i :18789找到 PID 后杀掉kill -9 [PID]然后重新openclaw gateway start。6.2 模型调用返回 401先确认openclaw.json里的 apiKey 是不是 TaoToken 的 Key而不是 DeepSeek 官方的 Key。两者不通用。如果 Key 没错检查有没有多余空格或换行。改完配置后必须重启网关openclaw gateway restart6.3 模型调用返回 404大概率是 baseUrl 写错了。TaoToken 的地址是https://taotoken.net/api不要写成https://taotoken.net/api/v1OpenClaw 会自己拼/v1。另外确认模型 id 在 TaoToken 的模型列表里存在比如deepseek-chat和deepseek-reasoner是分开的两个 id。6.4 飞书消息发不出去按顺序查三件事飞书应用有没有开message:send权限事件订阅的请求地址是不是指向网关的公网地址网关有没有重启。改完飞书配置后执行openclaw channel test feishu看返回的具体错误码。6.5 技能安装后无法执行先看技能列表openclaw skill list确认技能状态是 installed。然后看技能文档openclaw skill docs apple-notes有些技能依赖外部工具比如 Apple Notes 技能需要 macOS 的自动化权限。去系统设置里给终端开一下辅助功能权限。7. 接入文档与后续操作入口配置跑通之后日常用起来就三件事改模型、加技能、看日志。改模型只动openclaw.json里的primary字段Key 不用换。加技能走openclaw clawhub install。看日志用openclaw gateway status --verbose或者直接翻~/.openclaw/logs/下的文件。如果你需要管理多个 Key 或者查看调用量去 TaoToken 控制台的 API Keys 页面。接入文档里有各模型的参数说明和错误码对照排障时比盲猜快很多。想先试试模型对话效果可以直接在模型对话页面发一条消息确认 Key 和模型都正常再回到 OpenClaw 里配。长期跑编码任务或者 Agent 工作流的话Coding Plan 的额度模型更适合高频调用不用每次担心按量计费的心跳感。先把这篇的闭环跑通后面扩模型、加通道都是在这个骨架上叠东西。
