AI-900备考：用Word样式与VBA宏打造可检索的docx工具书
2026/9/18 10:55:14
在 Mac 上把 Ollama 和 OpenClaw 串起来之后，最容易卡住的不是模型拉不下来，而是openclaw models status里突然冒出一行Missing auth - ollama。本地qwen2.5:7b明明在 11434 端口跑着，openclaw agent --agent main却告诉你 provider 认证缺失。这个报错的根因通常不在 Ollama，而在 OpenClaw 把models.providers.ollama.apiKey里的占位串ollama-local当成了需要真实验证的凭据。要排掉它，可以到 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=openclaw_missing_auth 创建一把真实 Key，再把models.providers.ollama.baseUrl改成https://taotoken.net/api，让 OpenClaw 的 provider 认证走统一 API 通道。这样 main agent 请求远程模型时，不再依赖本地 Ollama 的占位符。
1.Missing auth - ollama出现在 Mac 本地模型跑通之后
1.1 复现现场：Ollama 正常，OpenClaw 状态却标红
先按原路径确认本地推理是好的。Mac 上开一个终端启动 Ollama：
ollama serve再开一个新终端，确认模型已经拉取并且能被列出：
ollama pull qwen2.5:7b ollama listollama list里能看到qwen2.5:7b，说明本地模型服务没有问题。接着给 OpenClaw 配本地 provider。原文里的做法是写一个占位 key，再把 baseUrl 指向本机 11434：
openclaw config set models.providers.ollama.apiKey "ollama-local" openclaw config set models.providers.ollama.baseUrl "http://127.0.0.1:11434" openclaw config set models.providers.ollama.api "ollama" openclaw models set ollama/qwen2.5:7b openclaw models status按理说，成功标准是Default显示ollama/qwen2.5:7b，并且不再出现Missing auth - ollama。但实际排障时经常看到的是：模型名对上了，状态栏却仍然写着Missing auth - ollama。更迷惑的是，ollama serve没报错，ollama list也正常，为什么 OpenClaw 还认为认证缺失？
1.2 占位 key 为什么会在状态检查里变成 Missing auth
本地 Ollama 本身通常不会强校验 API Key。你在 curl 里随便写个Authorization: Bearer ollama-local，它也可能正常返回推理结果。但 OpenClaw 的 provider 抽象层和 Ollama 直连不是一回事。OpenClaw 会把models.providers.ollama.apiKey当作 provider 认证状态的一部分来检查，尤其是openclaw models status这种汇总命令。
ollama-local只是一段占位字符串，它没有在 TaoToken 这类统一 API 通道里被创建过，也没有对应的模型访问权限。OpenClaw 在状态检查时看到这个 provider 的 key 不是有效凭据，就把它标记成Missing auth - ollama。这个标记不一定代表本地请求立刻失败，但它说明 OpenClaw 没有把该 provider 视为已完成认证的通道。
所以排障思路不是反复重装 Ollama，也不是去改ollama serve的启动参数，而是把 OpenClaw 的 provider 认证从「本地占位」换到「真实 Key + 统一 API 地址」。下面这套改法不要求你卸载本地模型，Ollama 还可以留着做对照测试，但 main agent 走远程模型时不再依赖ollama-local。
2. 把 OpenClaw 的 ollama provider 接到 TaoToken 统一通道
2.1 去官网创建 API Key，并摘出模型广场里的模型 ID
先打开 TaoToken 注册并登录。进入控制台后创建 API Key，把它复制到安全的地方。本文所有配置里的 Key 都写成占位符YOUR_API_KEY，你实际操作时替换成刚创建的那一串。不要把真实 Key 提交进 Git 仓库，也不要贴在聊天记录里。
创建完 Key 后，不要急着关页面。再到模型广场看当前可用的模型 ID。OpenClaw 最后要设置的默认模型格式是provider/model-id，例如ollama/YOUR_MODEL_ID。其中YOUR_MODEL_ID必须从模型广场当时列表里复制，不要凭记忆写一个带日期后缀或不存在版本号的名字。本文不编造任何具体模型 ID，统一用YOUR_MODEL_ID代替；如果你的模型广场里确实有qwen2.5:7b对应的远程模型，那就把它复制进去，否则换成列表里实际可用的那个。
这一步的实质是：本地 Ollama 负责继续提供你已经拉下来的模型，而 OpenClaw 的 provider 认证改由 TaoToken 接管。baseUrl 从http://127.0.0.1:11434换成https://taotoken.net/api之后，OpenClaw 发请求时会走统一 API 通道，认证头里带的是真实 Key，不再是本地占位串。
2.2 改 baseUrl 之前先记录当前 provider 配置
在覆盖配置前，先把当前值看一眼。不同版本的 OpenClaw 在配置查询命令上可能有细微差别，可以先用帮助命令确认：
openclaw config --help如果当前版本支持get，就分别查看这几个字段：
openclaw config get models.providers.ollama.apiKey openclaw config get models.providers.ollama.baseUrl openclaw config get models.providers.ollama.api如果版本只支持list，那就用openclaw config list找到models.providers.ollama这一段。把输出记在便签里，万一后面想切回纯本地 Ollama，可以按原值改回去。回滚路径通常就是：
openclaw config set models.providers.ollama.apiKey "ollama-local" openclaw config set models.providers.ollama.baseUrl "http://127.0.0.1:11434" openclaw config set models.providers.ollama.api "ollama" openclaw models set ollama/qwen2.5:7b记录旧值不会影响排障，但能让你在远程通道不可用时快速回到本地模型。注意，这里只是记录和回滚，不是让你继续用ollama-local作为正式认证。
3. 三条openclaw config set改掉 baseUrl 和 apiKey
3.1 把 apiKey 从 ollama-local 换成 YOUR_API_KEY
第一刀先改认证。原来写的是：
openclaw config set models.providers.ollama.apiKey "ollama-local"现在把它换成从 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=openclaw_missing_auth 创建的真实 Key：
openclaw config set models.providers.ollama.apiKey "YOUR_API_KEY"双引号保留，Key 里一般不会有空格，但加上引号可以避免 shell 截断特殊字符。改完之后可以用上一节的openclaw config get models.providers.ollama.apiKey确认它不再是ollama-local。如果输出里还带着引号或前后有空格，重新执行一次，确保值干净。
这一步是排掉Missing auth - ollama的关键。OpenClaw 状态里之所以显示缺失认证，就是因为它拿不到有效凭据；换成 TaoToken 控制台里创建的真实 Key 后，provider 认证状态才有机会变成已配置。
3.2 baseUrl 填 https://taotoken.net/api，末尾不要带 /v1
第二刀改地址。原来指向本机：
openclaw config set models.providers.ollama.baseUrl "http://127.0.0.1:11434"现在改成：
openclaw config set models.providers.ollama.baseUrl "https://taotoken.net/api"这里有两个容易写错的地方。第一，Base URL 只填https://taotoken.net/api，末尾不要加/v1，也不要加?utm_source=...。UTM 是给人点的官网页面用的，不是给 OpenClaw 请求接口用的。第二，不要写成https://taotoken.net/api/这种带尾斜杠的形式，除非你的 OpenClaw 版本明确要求。保持和上面一致最稳。
如果你在官网页面复制地址，注意区分「控制台页面地址」和「接口 Base URL」。控制台、模型广场、Key 管理页面是给人看的，接口地址是填进 OpenClaw 的。两者不要混。
3.3 provider 协议和默认模型：以模型广场为准
第三刀是协议类型和默认模型。原来 provider 的 api 字段是：
openclaw config set models.providers.ollama.api "ollama"当 baseUrl 还指向本机 Ollama 时，这个值是合理的。但 baseUrl 改成 TaoToken 的兼容通道后，请求应当按 OpenAI 兼容方式发出。如果你的 OpenClaw 版本支持在 provider 上声明openai类型，就执行：
openclaw config set models.providers.ollama.api "openai"然后设置默认模型：
openclaw models set ollama/YOUR_MODEL_IDYOUR_MODEL_ID仍然以 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=openclaw_missing_auth 模型广场当时列表为准。不要自己编一个gpt-5或带随意日期后缀的 ID 当正式配置。模型广场里写什么，就复制什么。
如果你当前版本的 OpenClaw 对api字段只认ollama，或者改成openai后请求格式对不上，可以新建一个 provider 名，例如taotoken，用同样的 Base URL 和 Key，再把默认模型切到taotoken/YOUR_MODEL_ID。主排障路径仍然是改models.providers.ollama的 baseUrl 和 apiKey；新建 provider 只是给需要区分本地与远程的场景留后路。
4. 用openclaw models status确认 Missing auth - ollama 消失
4.1 状态检查看 Default 和 auth 两栏
配置改完后回到最开始的检查命令：
openclaw models status成功标准有两条：Default显示你设置的ollama/YOUR_MODEL_ID，并且输出里不再出现Missing auth - ollama。如果 Default 对了但 auth 仍然标红，先查 Key 是否真的是控制台创建的那把，而不是还残留ollama-local：
openclaw config get models.providers.ollama.apiKey再查 baseUrl 是否准确写成：
openclaw config get models.providers.ollama.baseUrl确认输出是https://taotoken.net/api，没有多/v1，没有 UTM 参数，也没有空格。只要这三项对，Missing auth - ollama通常会消失。这个状态命令不会真正发起复杂推理，但它会汇总 provider 认证配置，所以排障时非常值得先跑。
4.2 启动 gateway，用 main agent 发一条消息
状态通过后，开一个终端保持网关运行：
openclaw gateway --force再开另一个终端查看 agent id：
openclaw agents list本地测试时，把main换成你实际的 agent id：
openclaw agent --agent main --message "你好，测试远程模型"如果这条消息能正常返回，说明 OpenClaw 的 provider 已经通过 TaoToken 的兼容通道接上了远程模型。最后打开 dashboard：
openclaw dashboard它会自动打开浏览器里的 Control UI，你可以继续和 main agent 对话。此时 main agent 走的是远程模型，不再依赖本机 11434 上的占位 key。本地 Ollama 可以继续开着做备用，但Missing auth - ollama的根因已经被移除。
5. 排障对照：401、404、模型不存在和回退本地
5.1 401 和 404 分别对应哪一步
改完 baseUrl 后如果请求报 401，优先查 Key。常见原因是复制时漏了尾部字符、前后带了空格、或者把控制台页面的 UTM 地址误当成 Key。重新到 控制台 API Keys 创建或复制一次，再用openclaw config set写入。
如果报 404 或not found，大概率是 Base URL 写错。检查是不是写成了https://taotoken.net/api/v1，或者手动拼了别的路径。OpenClaw 这边只填https://taotoken.net/api，末尾不要带/v1。如果模型名报不存在，就去模型广场重新核对YOUR_MODEL_ID，不要用记忆里的名字。
5.2 想切回本地 Ollama 怎么做
远程通道临时不可用，或者你只是想拿本地qwen2.5:7b做对照，可以回滚到本地配置：
openclaw config set models.providers.ollama.apiKey "ollama-local" openclaw config set models.providers.ollama.baseUrl "http://127.0.0.1:11434" openclaw config set models.providers.ollama.api "ollama" openclaw models set ollama/qwen2.5:7b openclaw models status注意，回滚后Missing auth - ollama可能会再次出现，因为占位 key 又回到了 provider 配置里。这正好说明这个报错和本地 Ollama 服务本身无关，而是 OpenClaw 对 provider 认证状态的判断。要长期走远程模型，就保留真实 Key 和https://taotoken.net/api。
6. 配通之后去控制台对一下这次 OpenClaw 调用
6.1 用同一把 Key 在模型对话里发测试消息
OpenClaw 的 main agent 能回复之后，建议再做一个最小验证：打开 TaoToken 模型对话，用同一把YOUR_API_KEY发一条测试消息。这样可以把问题范围压到最小：如果模型对话里正常、OpenClaw 里也正常，说明 Base URL 和 Key 都没问题；如果模型对话正常、OpenClaw 报错，就回到openclaw config get models.providers.ollama.baseUrl检查是不是多写了路径。
这一步也顺便确认模型 ID。模型对话页面里能选的模型，和模型广场、OpenClaw 配置里的YOUR_MODEL_ID应当对得上。对不上就换回实际可用的 ID，不要硬填。
6.2 长期让 main agent 走远程模型，去看 Coding Plan 和 Key 管理
如果你只是偶尔排障，按上面的改法已经够用。如果你准备让 main agent 长期走远程模型写代码、跑长对话，可以打开 Coding Plan 看当前套餐是否适合你的使用节奏。Key 的创建、轮换和删除都在 控制台 API Keys 里管理。
回到这次排障本身：Missing auth - ollama不是本地模型坏了，而是 OpenClaw 的 provider 还拿着ollama-local这个占位串。把models.providers.ollama.apiKey换成真实 Key，把models.providers.ollama.baseUrl改成https://taotoken.net/api，再跑一次openclaw models status，状态栏干净了，main agent 也就从本地占位认证切到了统一 API 通道。后面再动 OpenClaw 配置时，先看openclaw models status，再看 Key 和 Base URL，基本能少绕很多弯。