实践openclaw-concepts
Control UI and API keys · OpenClaw — OpenClaw 把密钥存储、模型目录刷新和用量统计拆成独立步骤，这个设计值得借
OpenClaw 把密钥存储、模型目录刷新和用量统计拆成独立步骤，这个设计值得借鉴。
2026-09-21原文
本文为要点摘要，完整细节以原文为准。
🧭 一图看懂
由原文自动提炼 · 以原文为准点击任一分支，查看这一点的一句话解读
OpenClaw 密钥与模型控制台
密钥写入 auth store，配置的 provider 只引用已保存 profile
- 页面与 paste-api-key 共用同一 credential…
- 环境变量密钥仍由 Gateway 进程环境管理
- 页面只显示凭据来源，不暴露密钥
⚙️ 流程拆解
STEP 1在 Control UI 打开…
STEP 2添加/替换/移除 provider API…
STEP 3密钥写入 auth store 并保存…
STEP 4单独刷新模型目录
STEP 5用量与本地成本独立加载
STEP 6用 Test connection 探测…
🔗 涉及的概念与玩家
- OpenClaw产品
- Control UI产品
- Gateway产品
- auth store概念
- API key rotation方法
- provider plugins概念
- OAuth概念
- Control UI—属于→OpenClaw
- Control UI—写入密钥→auth store
- Gateway—管理环境密钥→OpenClaw
- provider plugins—扩展→OpenClaw
- API key rotation—用于→OpenClaw
- OAuth—由插件刷新→provider plugins
- 密钥写入与目录刷新解耦：保存 key 和刷新 catalog 是两个独立结果，刷新失败时已保存的 key 仍然保留，只需按提示执行恢复步骤。对 harness 的启示是凭证写入与状态同步应各自独立，避免一次失败回滚全部操作。
- 密钥轮换只在限流时触发：按 OPENCLAW_LIVE_<PROVIDER>_KEY、<PROVIDER>_API_KEYS、<PROVIDER>_API_KEY、编号列表的优先级选 key 并去重，仅对 429、quota、ThrottlingException 等限流响应换下一个 key，非限流错误立即失败。含义是重试策略应按错误分类，而非无差别重试。
- Provider 逻辑下沉到插件：registerProvider(...) 承担 onboarding、模型目录、环境变量映射、工具 schema 清理、故障分类、OAuth 刷新等，核心只保留通用推理循环。对 prompt/harness 设计的含义是 provider 差异应通过显式钩子暴露，而非共享逻辑里的静态能力标记。
🕸 顺着图谱继续读
- Session synchronization and attachment · — 多客户端共享同一会话状态，无需复制转录，附编码工具更高效。2026-08-17 · 共同涉及 OpenClaw、Gateway、Control UI
- Session management · OpenClaw — 会话管理是 agent 记忆的基石，本文教你如何隔离、重置和清理会话。2026-08-17 · 共同涉及 OpenClaw、Gateway、Control UI
- Presence · OpenClaw — 5分钟看懂OpenClaw多智能体在线状态机制，避免重复连接和内存泄漏。2026-08-10 · 共同涉及 OpenClaw、Gateway、Control UI
- openclaw v2026.7.1 — Control UI 大改版，GPT2026-07-13 · 共同涉及 OpenClaw、Control UI、Gateway