在 macOS 上配置 OpenClaw 连接本地 Ollama 完整指南：TaoToken 统一 Key 与 config.toml 骨架

1. macOS 上 OpenClaw 接本地 Ollama为什么还要 TaoToken 统一 Key如果你在 macOS 上折腾过 OpenClaw社区里也叫“小龙虾”这个开源 AI 助手框架大概率会遇到一个很别扭的场景本地 Ollama 跑得好好的ollama list能看到模型但 OpenClaw 的 Web UI 里就是调不通或者调通了却只能用一个模型想切到云端模型就得改一遍配置、换一套 Key。我实测下来最省心的做法是让 OpenClaw 走一个统一的 OpenAI 兼容入口本地 Ollama 和云端模型都挂在同一个 Key 下面config.toml只维护一份。这篇就聚焦 macOSApple Silicon环境把 OpenClaw 对接本地 Ollama 的完整链路走一遍Node.js 依赖怎么装、Web UI 怎么起、config.toml骨架怎么写、TaoToken 统一 Key 怎么接进去最后用curl验证一次请求确实打到了模型。适合已经装好 Ollama、想用 OpenClaw 做本地对话或轻量 Agent 的朋友。全程命令可直接复制配置片段也是我跑通后留下的骨架你按自己模型名改一下就能用。需要先明确一点Ollama 本身提供的是 OpenAI 兼容的/v1接口OpenClaw 支持自定义 Provider所以两者能接上。但如果你还想在同一个 OpenClaw 里用云端模型或者不想每个模型都单独配 Key那就需要一个统一入口。TaoToken 在这里扮演的就是这个统一入口的角色它提供 OpenAI 兼容的 API 地址你拿一个 Key 就能在 OpenClaw 里同时挂本地和云端模型。2. 前置准备Node.js 22、Ollama 与 TaoToken 统一 Key2.1 确认 Ollama 在跑并记下模型名先在终端确认 Ollama 服务活着并且知道你本地到底有哪些模型# 查看 Ollama 进程 ps aux | grep ollama # 列出已下载模型记下完整名称含标签 ollama list输出里类似qwen2.5:7b、llama3.1:8b这样的完整名称后面写进config.toml时必须一字不差包括:latest这类标签。很多人调不通就是栽在这里模型名少了个标签OpenClaw 报 404 但看不出原因。Ollama 默认监听127.0.0.1:11434它的 OpenAI 兼容端点是http://127.0.0.1:11434/v1。这个地址在 macOS 本机访问没问题不需要额外开网络暴露。2.2 安装 Node.js 22 与 OpenClawOpenClaw 需要 Node.js 22 及以上。用 Homebrew 装最省事# 安装 Node.js 22 brew install node22 # 确认版本必须 22 node -v # 可选设置 npm 镜像加速 npm config set registry https://registry.npmmirror.com # 全局安装 OpenClaw npm install -g openclaw如果npm install -g报权限错误别急着无脑sudo先检查 npm 全局目录归属。macOS 上用 Homebrew 装的 Node全局目录一般在/opt/homebrew下通常不需要 sudo。真要用 sudo装完记得把目录权限改回来否则后续openclaw写配置会失败。2.3 拿到 TaoToken 统一 Key打开 TaoToken 控制台创建 API Key地址是 https://taotoken.net/console 。创建后复制那串sk-开头的 Key先存到密码管理器里。这个 Key 后面会写进 OpenClaw 的config.toml作为统一入口的凭证。TaoToken 的 API 基地址是https://taotoken.net/apiOpenAI 兼容。也就是说OpenClaw 里配置 Provider 时Base URL 填这个Key 填你刚创建的就能通过它路由到不同模型。本地 Ollama 则继续走http://127.0.0.1:11434/v1两者在 OpenClaw 里是两个 Provider但共用一套管理逻辑。3. 可复制配置config.toml 骨架与 Web UI 启动3.1 先跑一次 onboard生成基础配置OpenClaw 的交互式配置向导能帮你生成初始config.toml但选项很多容易选错。建议先跑一遍拿到文件位置再手动改openclaw onboard向导里几个关键选择Onboarding mode 选 Manual方便一次性配全gateway 选 Local gatewayModel/auth provider 滚到底选 Custom ProviderAPI Base URL 先填 Ollama 的http://127.0.0.1:11434/v1API Key 随便填个占位符比如ollamaOllama 不校验但不能留空Endpoint compatibility 选 OpenAI-compatibleModel ID 填ollama list里的完整名称Gateway bind 选 Loopback只在本机监听最安全Gateway auth 选 Token。向导跑完配置文件通常在~/.config/openclaw/config.tomlmacOS 路径。先备份一份再改cp ~/.config/openclaw/config.toml ~/.config/openclaw/config.toml.bak3.2 config.toml 骨架本地 Ollama TaoToken 双 Provider下面是我跑通后的骨架把本地 Ollama 和 TaoToken 统一入口都写进去。你只需要替换模型名和 Key# ~/.config/openclaw/config.toml [gateway] port 18789 bind 127.0.0.1 auth token # 本地 Ollama Provider [[providers]] id local-ollama name Local Ollama base_url http://127.0.0.1:11434/v1 api_key ollama compatibility openai [[providers.models]] id qwen2.5:7b alias local # TaoToken 统一入口 Provider [[providers]] id taotoken name TaoToken Unified base_url https://taotoken.net/api api_key sk-你的TaoTokenKey compatibility openai [[providers.models]] id gpt-4o-mini alias cloud-fast [[providers.models]] id claude-3-5-sonnet alias cloud-smart几个要点base_url对 Ollama 是http://127.0.0.1:11434/v1对 TaoToken 是https://taotoken.net/api注意后者不带/v1后缀OpenClaw 会按 OpenAI 兼容规则拼接。api_key对 Ollama 是占位符对 TaoToken 是你真实的 Key。alias是给 Web UI 显示用的短名方便切换。注意config.toml里 Key 是明文存储确保这个文件权限是600命令chmod 600 ~/.config/openclaw/config.toml。3.3 启动 Web UI配置写好后重启 gateway 服务让配置生效# 重启服务 openclaw gateway restart # 生成访问 token openclaw token generate终端会输出访问地址http://localhost:18789和一个 token。浏览器打开这个地址粘贴 token 登录就能在 Web UI 里看到local、cloud-fast、cloud-smart三个模型别名切换即可。4. 验证请求curl 打通 Ollama 与 TaoToken配置对不对别急着在 UI 里点先用curl分别验证两个 Provider能快速定位问题。4.1 验证本地 Ollamacurl http://127.0.0.1:11434/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer ollama \ -d { model: qwen2.5:7b, messages: [{role: user, content: 用一句话介绍你自己}], stream: false }如果返回 JSON 里有choices[0].message.content说明 Ollama 的 OpenAI 兼容端点正常。如果报model not found回去核对ollama list的完整名称。4.2 验证 TaoToken 统一入口curl https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoTokenKey \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回复 OK 两个字母}], stream: false }返回正常说明 TaoToken 的 Key 和地址都没问题。这一步过了OpenClaw 里taotoken这个 Provider 基本就能用。4.3 在 OpenClaw 里发一条消息回到 Web UI选local别名发一句“你好”再切到cloud-fast发一句。两边都能回说明config.toml骨架生效统一 Key 也接进去了。如果本地能回、云端报 401多半是 Key 复制时带了空格或者base_url误加了/v1。5. 本篇常见错排查Ollama 连不上报 connection refused。先ps aux | grep ollama确认进程在跑。macOS 上 Ollama 有时会随系统休眠被挂起重新打开 Ollama 应用即可。另外确认config.toml里写的是127.0.0.1而不是localhost某些环境下 IPv6 解析会让localhost指向::1而 Ollama 只监听 IPv4。模型不响应报 404 model not found。九成是模型名不匹配。ollama list输出的名称必须完整复制包括标签。比如你写qwen2.5但实际是qwen2.5:7b就会 404。TaoToken 报 401 Unauthorized。检查 Key 是否完整、有没有多余空格、有没有过期。另外确认base_url是https://taotoken.net/api不要自己加/v1OpenClaw 会按兼容规则拼接路径加错了会 404。Web UI 打不开或提示 token 无效。先确认 gateway 在跑openclaw gateway status。token 每次openclaw token generate会重新生成旧 token 失效重新复制新的即可。如果端口 18789 被占用改config.toml里的port再重启。改了 config.toml 不生效。OpenClaw 不会热加载配置必须openclaw gateway restart。改完记得确认文件保存成功可以用openclaw config show看当前生效的配置。6. 后续怎么用统一 Key 的扩展与接入文档本地 Ollama 跑通后你可以把更多模型挂到 TaoToken 这个 Provider 下面config.toml里加几行[[providers.models]]就行不用再动 Key。想验证某个模型是否可用直接在模型对话页面发一条消息最快https://taotoken.net/model-chat 。如果你打算长期用 OpenClaw 做编码或 Agent 任务可以考虑 Coding Plan把常用模型固定下来https://taotoken.net/coding-plan 。接入过程中如果遇到报错优先查接入文档里的兼容性说明https://taotoken.net/doc 。Key 的管理和重新生成在控制台https://taotoken.net/api-keys 。Claude Code 相关的 Anthropic 兼容配置也有单独页面https://taotoken.net/claudecode-anthropic 。最后留一个我踩过的坑config.toml里 Provider 的顺序会影响 Web UI 默认选中的模型把常用的放前面。另外 macOS 上如果开了“低电量模式”Ollama 推理会明显变慢排查性能问题时先看这个。