OpenClaw Provider Icons 资源治理与许可署名指南从 ATTRIBUTION.md 到 Control UI 图标渲染链路【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文以 ui/public/provider-icons/ATTRIBUTION.md 为基准完整梳理 OpenClaw 控制界面Control UI中 80 个模型厂商品牌图标的来源、清洗规则与许可证署名要求并结合 provider-icon 组件、公共资源路径工具 与 根资源清单 的源码实现说明这些 SVG 从仓库静态文件到浏览器渲染的完整链路。读完本文你可以准确回答三类问题这批图标各自来自哪里、为什么可以放心复用OpenClaw 在分发前对 SVG 做了哪些标准化处理新增一个厂商图标时需要遵守哪些署名与合规约束。图标目录总体格局80 个 SVG 与四组来源ui/public/provider-icons/ 目录当前包含 80 个形如ProviderIcon-name.svg的文件从ProviderIcon-abacus.svg到ProviderIcon-zed.svg以及一份署名文档 ATTRIBUTION.md。署名文档将其中绝大多数图标按上游来源划分为四组CodexBar 批次52 个文件文档明确写道 “52 of theProviderIcon-*.svgfiles in this directory were copied one-for-one fromSources/CodexBar/Resources/ProviderIcon-*.svgin CodexBar commit215efbd39ad58acb4b0cd637c407d63e6183bc8d”。这批图标与上游文件逐一对应几何与视觉内容保持一致上游许可证为 MITCopyright (c) 2026 Peter Steinberger。三个单点品牌图标Pi、LM Studio、LongCat各自单独记录来源与清洗方式见下文。llama.cpp 图标来自官方 llama.cpp 仓库的media/llama1-icon-transparent.svg上游 MIT LicenseCopyright (c) 2023-2026 The ggml authors。Lobe Icons 批次24 个文件来自 npm 包lobehub/icons-static-svg1.94.0MITCopyright (c) 2023 LobeHub中的单色 SVG文档给出了逐文件的上游图标名映射表。80 个文件减去上述 52 3 1 24 80恰好与目录实际文件数吻合——这说明署名文档与目录内容是一一对应的没有任何“无主”图标。CodexBar 批次来源 commit215efbd39ad58acb4b0cd637c407d63e6183bc8d来源目录Sources/CodexBar/Resources上游许可MIT文档末尾完整收录了 CodexBar 的 MIT License 文本Copyright (c) 2026 Peter Steinberger。Pi 图标ProviderIcon-pi.svg是官方 Pi logohttps://pi.dev/logo.svg的元数据清洗副本官方 press kit 见https://pi.dev/press-kit。LM Studio 图标ProviderIcon-lmstudio.svg是 LM Studio 官方发布的单色轮廓图标lm-studio-icon-outline-white.svg品牌规范见https://lmstudio.ai/brand。LongCat 图标ProviderIcon-longcat.svg是 LongCat 团队美团官方品牌标的元数据清洗副本用于 LongCat API 平台的 favicon 与文档品牌。文档特别记录了两处改造白色背景底板被移除内部字形重新着色为currentColor使该图标在浅色与深色主题下都能正确渲染几何形状与来源保持一致。这一“重着色”改造在仓库中可以得到验证ProviderIcon-longcat.svg 内部确实用到了currentColor填充而同一目录下的其他图标如 ProviderIcon-llamacpp.svg仍保留白色fillwhite——后者依赖渲染容器提供深色背景这正是两者处理策略不同的体现。llama.cpp 图标ProviderIcon-llamacpp.svg取自官方 llama.cpp 仓库 commit2cfef4d117d67ab1dec002915b48a15d11ee1973中的media/llama1-icon-transparent.svg上游许可证为 MIT文档完整收录了该 MIT 文本。Lobe Icons 批次24 个文件的完整映射文档以表格形式逐一列出 Lobe Icons 批次中每个文件对应的上游图标名这是合规审查时最有价值的部分其中byteplus映射自bytedance.svg、qianfan映射自baiducloud.svg属于“子品牌映射到母品牌图标”的情形文件上游图标ProviderIcon-arcee.svgarcee.svgProviderIcon-baseten.svgbaseten.svgProviderIcon-byteplus.svgbytedance.svgBytePlus 是字节的enterprise品牌ProviderIcon-cerebras.svgcerebras.svgProviderIcon-cloudflare.svgcloudflare.svgProviderIcon-cohere.svgcohere.svgProviderIcon-comfy.svgcomfyui.svgProviderIcon-deepinfra.svgdeepinfra.svgProviderIcon-fal.svgfal.svgProviderIcon-featherless.svgfeatherless.svgProviderIcon-fireworks.svgfireworks.svgProviderIcon-huggingface.svghuggingface.svgProviderIcon-meta.svgmeta.svgProviderIcon-microsoft.svgmicrosoft.svgProviderIcon-novita.svgnovita.svgProviderIcon-nvidia.svgnvidia.svgProviderIcon-pixverse.svgpixverse.svgProviderIcon-qianfan.svgbaiducloud.svg千帆是百度云的模型平台ProviderIcon-runway.svgrunway.svgProviderIcon-tencent.svgtencent.svgProviderIcon-together.svgtogether.svgProviderIcon-vercel.svgvercel.svgProviderIcon-vllm.svgvllm.svgProviderIcon-volcengine.svgvolcengine.svg上游包为lobehub/icons-static-svgMITCopyright (c) 2023 LobeHub文档同样完整收录了对应的 MIT 许可文本。“元数据清洗”原则分发前对 SVG 做了哪些标准化署名文档反复使用 “metadata-cleaned copy” 这一表述并给出明确定义CodexBar 批次“OpenClaw removes XML declarations, external DTD declarations, and generator metadata before serving the files as public assets. The SVG geometry and visual content otherwise match the cited upstream files.”——即只移除 XML 声明?xml ...?、外部 DTD 声明和生成器元数据如编辑器注释SVG 几何与视觉内容保持不变Lobe Icons 批次“XML declarations andtitleelements removed; geometry unchanged”——额外移除了title元素几何不变。这条规则可以在当前仓库中直接验证对 ui/public/provider-icons/ 下全部 80 个 SVG 检查没有任何文件包含?xml声明也没有任何文件包含!DOCTYPE或外部 DTD 实体声明——清洗规则与署名文档的描述完全一致。这一做法的工程价值在于消除外部引用移除外部 DTD 可避免 SVG 加载时发起意外的网络请求外部实体是已知的一类安全与性能隐患体积与一致性去掉生成器元数据后文件更小且同一批次内结构风格统一可审计性因为“几何不变”署名文档可以承诺这些文件与引用上游文件一一对应第三方审计者可以逐文件比对验证。同时文档还有一句重要的合规声明“Provider names and marks remain the property of their respective owners.”——厂商名称与商标仍归其各自所有者所有。也就是说MIT 许可覆盖的是图形文件本身不代表 OpenClaw 获得了任何厂商商标的使用权在品牌图标的使用场景上应遵循各厂商的品牌规范如 LM Studio 的https://lmstudio.ai/brand。从静态文件到 UI 渲染provider-icon 组件的实现图标资产只是链路的一半。ui/src/components/provider-icon.ts 文件头注释说明了它的职责“Shared model-provider brand icon resolution and rendering for surfaces that show provider rows (chat model picker, model providers settings page)”即聊天模型选择器与“模型提供商”设置页中展示厂商行的公共组件。其解析逻辑分为三层1. 图标名白名单组件维护了一个 80 项的PROVIDER_ICON_NAMES集合abacus、alibaba、…、zed与 ui/public/provider-icons/ 目录中的 SVG 文件名严格一一对应。解析函数resolveProviderIconName的逻辑是先把 provider id 归一化为小写查别名表再查白名单——任何一步失败都返回nullfunction resolveProviderIconName(provider: string): string | null { const normalized provider.trim().toLowerCase(); const icon PROVIDER_ICON_ALIASES[normalized] ?? normalized; return PROVIDER_ICON_NAMES.has(icon) ? icon : null; }2. 厂商 id 到图标名的别名映射由于很多模型目录里的 provider id 与品牌标的 slug 不同名组件内置了PROVIDER_ICON_ALIASES映射例如const PROVIDER_ICON_ALIASES: ReadonlyRecordstring, string { anthropic: claude, amazon-bedrock: bedrock, google: gemini, github-copilot: copilot, llama-cpp: llamacpp, openai: codex, // CodexBar names its bundled OpenAI knot asset codex. qwen: alibaba, xai: grok, xiaomi: mimo, // Xiaomi ships its AI models under the MiMo brand mark. vertex-ai: vertexai, // ... };这里的注释与署名文档相互印证openai映射到codex图标是因为 CodexBar 将其内置的 OpenAI knot 资产命名为codex——正是 ATTRIBUTION.md 中所述 CodexBar 批次的一部分。此外组件还提供providerDisplayLabel处理显示名如llama-cpp→ “llama.cpp”、zai→ “Z.AI”无品牌显示名时由formatRawProviderLabel生成 Title-case 回退标签。3. 渲染与回退renderProviderBrandIcon为解析成功的 provider 输出一个内联样式指向 SVG 资产的span并附加data-provider-icon属性供样式系统使用return html span classprovider-brand-icon${surfaceClass} >type ControlUiPublicAsset | ControlUiRootPublicAsset | fonts/${string}.css | themes/${string}.css | provider-icons/ProviderIcon-${string}.svg | file-icons/${string}.svg | app-art/${string}.webp | community-art/${string}.webp;controlUiPublicAssetPath会在资源 URL 后附加构建版本号读取html上的data-openclaw-control-ui-build-id属性拼成?vbuildId从而实现“内容绑定”的缓存失效图标 SVG 一旦随构建更新浏览器即拉取新版本。这个 build-id 机制由 src/gateway/control-ui-root-assets.ts 定义其中isControlUiVersionedPublicAsset的正则同样把(provider-icons|file-icons...)/...svg列为受版本化缓存管辖的资产——从源码结构看网关侧对控制 UI 静态资源的校验、UI 侧的路径推断共享同一份资产清单保证“服务端认可的静态文件”与“前端会请求的静态文件”两侧不漂移。合规清单新增厂商图标时应做什么结合署名文档与上述实现向该目录新增一个ProviderIcon-name.svg需要同时满足三条约束这也是署名文档存在的直接意义来源可署名图标要么来自 MIT 等宽松许可的上游需在 ATTRIBUTION.md 中记录来源 commit/包版本与上游许可文件路径如同 CodexBar 批次记录 commit hash、Lobe 批次记录包名与版本1.94.0要么是厂商官方发布的品牌资产需记录官方下载源如 Pi、LM Studio且厂商名称与商标仍归所有者所有元数据清洗到位移除 XML 声明、外部 DTD 声明、生成器元数据以及 Lobe 批次所示范的title元素保持几何不变如需适配明暗双主题参照 LongCat 的做法将内部字形改为currentColor接入解析链路在 provider-icon.ts 的PROVIDER_ICON_NAMES白名单中加入新 slug若 provider id 与 slug 不同名在PROVIDER_ICON_ALIASES中补充映射需要特定品牌显示名时在PROVIDER_DISPLAY_LABELS中登记。完成这三步后renderProviderBrandIcon与带版本号的 public asset 分发链路即可自动覆盖新图标。最后要再次强调署名文档中的一句总括性事实所有 52 个 CodexBar 来源图标、24 个 Lobe Icons 图标以及 llama.cpp 图标均以 MIT 许可文本随 ATTRIBUTION.md 一并保留在仓库中而 Pi、LM Studio、LongCat 三个图标则依赖“官方发布 清洗不改几何”的来源记录。任何后续变更图标目录的行为都应保持这份“文件—来源—许可”三方对应关系不丢失这正是该署名文档的核心价值所在。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
