这篇解决什么：Key、额度与计费边界
OpeClaw 能打开、界面正常，但一调云端模型就失败——日志或弹窗里出现 401、429、「invalid api key」「quota exceeded」——问题多半不在杀毒或 Gatekeeper，而在密钥与额度。
本站「连接排查」指南覆盖来源、代理、端口等全链路；本文只把 API Key 怎么配、额度用完怎么处理、计费边界怎么分清写透。安装后双击没反应，请另看「打不开排查」；本地 Ollama/LM Studio 配置见「本地大模型」一文。
OpeClaw API Key 怎么配置
打开 OpeClaw 设置，找到模型或 Model Providers。为你要使用的云端服务（如 OpenAI 兼容端点、Claude、Gemini 等）新建或编辑一项：填入服务商控制台生成的 API Key，核对 Base URL / 区域与文档一致，保存后选该模型发一句短测试。
复制密钥时最容易踩坑：前后多空格、只复制了半段、把 Project ID 当成 Key、或把 A 厂商的 key 填进 B 厂商配置。测试失败时先原样对照服务商后台「Reveal」一次，而不是立刻换安装包。
若走环境变量注入，确认 OpeClaw 实际读取的变量名与当前版本说明一致，重启客户端后再测。密钥只留在本机配置或系统密钥环，不要写进公开仓库或截图。
- 在服务商控制台创建/轮换 API Key，确认未撤销。
- 在 OpeClaw 对应 Provider 粘贴密钥并保存。
- 用一条短对话验证；成功后再接长工作流。
401：先修密钥，不要当成额度问题
401 Unauthorized 的字面意思是「未授权」。实操里我见过最多的是：key 过期或被手动 revoke、粘贴损坏、账号没开通该模型权限、以及组织/项目级密钥绑错项目。
处理顺序建议固定：停掉自动重试 → 在服务商后台核对 key 状态与权限 → 必要时轮换新 key 并只更新 OpeClaw 一处配置 → 再测一次。同一错误连刷只会触发风控或更难读的日志。
若 401 只出现在某一个 Provider，而其他模型正常，几乎可以断定是该条密钥或端点配置问题，而不是「OpeClaw 整体坏了」。
429 与额度用完：先停再查账单
HTTP 429 以及带 quota、rate limit、billing 字样的提示，重点在用量与限流，不在重装客户端。先暂停并发 Agent、批量改写或循环调用，打开服务商用量/账单页看今日请求数、剩余额度与硬性 RPM/TPM 上限。
免费额度见底、试用过期、绑卡失败、组织共享额度被同事打满，都会表现为「突然连不上」。恢复方式通常是：等重置窗口、升级计划、或暂时切到仍有额度的模型——而不是改杀毒白名单。
OpeClaw 侧能做的是：降低并行、拉长重试间隔、把草稿步骤改走本地模型（见本地大模型配置），把贵价云端调用留给定稿。
计费边界：谁在收钱、什么不算 OpeClaw 故障
把三件事分开：本机是否装好 OpeClaw、云端模型是否用你的 API Key 计费、本站下载页是否只提供安装入口。云端 token 费用一般记在模型厂商；本站第三方下载导航不代替服务商客服改账单。
「连接失败」若伴随明确的 401/429/quota，优先按本文处理密钥与额度。若错误是超时、代理证书、EADDRINUSE 或程序根本打不开，应转到连接排查或打不开排查，避免在 Key 页里空转。
定价页适合判断本站/产品侧的版本差异；具体每千 token 价格以你所选服务商当前标价为准，本文不虚构数字以免误导 SEO 与用户预期。
连接失败的分流：何时离开本文
界面能进、只有调用模型失败且错误码是 401/429 → 留在本文，修 Key 与额度。
Base URL 指向 127.0.0.1、本地服务未启动、模型名与 ollama list 不一致 → 去「OpenClaw 本地大模型」配置文，而不是反复轮换云端 key。
下载来源不明、公司代理、端口占用、程序无法启动 → 分别看连接排查、FAQ 与下载页发布状态。把问题分到正确页面，比在一个词下堆全部症状更利于检索与排错。
Key / 额度对照表（不新增结论）
下表只归纳上文分流；不改变「401 先查密钥、429 先停再查账单、云端费用看服务商」的边界，也不替代连接排查中的代理与端口步骤。
| 现象 | 优先动作 | 常见误操作 |
|---|---|---|
| 401 / invalid api key | 核对、轮换密钥与 Provider 权限 | 当成额度用完或立刻重装 |
| 429 / quota / rate limit | 停重试，查用量与账单 | 疯狂重试触发更严限流 |
| 仅某一云端模型失败 | 查该条 Key 与端点 | 删除全部 Provider 重配 |
| 仅本地模型失败 | 查本地 API 与模型名 | 轮换云端 Key |
| 程序打不开 | 打不开排查 / 下载页 | 在 Key 设置里空改 |
具体后台菜单名以各服务商当前控制台为准；本文不承诺人工客服时效或固定套餐价格。
API Key 与额度常见问题
OpeClaw API Key 填在哪里？
一般在设置 → 模型 / Model Providers 里，为对应云端服务商填写 API Key（或环境变量指向同一密钥）。保存后发一条短消息测试；本地 Ollama 等通常只需占位 key，真正要校验的是云端厂商密钥。
出现 401 Unauthorized 是不是额度用完了？
通常不是。401 更像密钥无效、过期、复制多空格、权限不足或选错了服务商。额度用完、速率限制更常见的是 429 或明确的 quota / billing 提示。
HTTP 429 或提示额度用完怎么办？
先停止连续重试，到模型服务商后台核对用量、账单与速率限制。确认额度恢复或换可用计划后再在 OpeClaw 里重试；不要把限流当成软件损坏去反复重装。
OpeClaw 自己收费还是模型厂商收费？
多数情况下，云端推理费用记在你绑定的模型服务商账户上；OpeClaw 作为本机工作流入口调用你配置的密钥。具体以当前定价页与服务商账单为准，本文不编造套餐数字。