一句话总结
OpenClaw 最新提交将 Provider 发现配置从核心框架迁移至插件系统，实现了更灵活的 AI Agent 服务发现机制，让开发者能够按需扩展和自定义 Provider 能力。
为什么这次重构很重要？
在 AI Agent 开发中，Provider 发现 是连接底层服务与上层应用的关键桥梁。传统的集中式配置方式虽然简单，但随着支持的服务类型增多，维护成本急剧上升。本次重构将配置能力下沉到插件层，解决了三个核心痛点：配置与代码耦合、扩展困难、版本管理复杂。
重构背景：从单体到插件化
旧架构的局限性
在 19de5d1 之前的版本中，Provider 发现配置位于核心框架内部：
旧方式：配置硬编码在框架内
openclaw:
providers:
- name: openai
endpoint: https://api.openai.com
discovery: static # 无法动态扩展
- name: anthropic
endpoint: https://api.anthropic.com
这种模式的问题显而易见：
- 新增 Provider 需要修改核心代码
- 版本升级可能破坏现有配置
- 无法支持私有化部署的自定义 Provider
新架构的设计理念
重构后的插件系统将 Provider 发现 能力完全开放：
新方式：配置由插件自主管理
plugins:
openclaw-provider-openai:
discovery:
type: dynamic
refresh_interval: 300s
openclaw-provider-custom:
discovery:
type: file
path: /etc/openclaw/providers.yaml
如何实现配置迁移
步骤一：识别现有 Provider 配置
首先检查当前使用的 Provider 列表：
查看当前激活的 Provider
openclaw provider list --format=json
输出示例
{
"providers": [
{"name": "openai", "source": "core", "status": "deprecated"},
{"name": "bedrock", "source": "plugin", "status": "active"}
]
}
> 注意 source: core 的 Provider 需要迁移。
步骤二：安装对应的 Provider 插件
安装官方维护的 Provider 插件
openclaw plugin install openclaw-provider-openai
openclaw plugin install openclaw-provider-anthropic
验证插件安装
openclaw plugin list
步骤三：迁移配置到插件目录
将原有配置从 openclaw.yaml 移至插件专属配置：
创建插件配置目录
mkdir -p ~/.openclaw/plugins/openclaw-provider-openai/
迁移配置（示例）
cat > ~/.openclaw/plugins/openclaw-provider-openai/config.yaml << 'EOF'
discovery:
type: http
endpoint: https://api.openai.com/v1/models
auth:
type: bearer
token_env: OPENAI_API_KEY
health_check:
enabled: true
interval: 60s
EOF
步骤四：验证迁移结果
测试 Provider 发现功能
openclaw provider discover --verbose
预期输出
[INFO] Loading provider plugins...
[INFO] [openai] Discovered 12 models from https://api.openai.com/v1/models
[INFO] [anthropic] Discovered 5 models from https://api.anthropic.com/v1/models
[SUCCESS] All providers discovered successfully
插件化带来的新能力
动态服务发现
支持基于 Consul、etcd 的服务注册中心：
~/.openclaw/plugins/openclaw-provider-custom/config.yaml
discovery:
type: consul
consul:
address: "consul.internal:8500"
service_prefix: "ai-model-"
tags: ["llm", "production"]
filter:
- key: "capabilities/vision"
operator: "eq"
value: "true"
多集群 Provider 管理
discovery:
type: composite
sources:
- type: static
providers:
- name: gpt-4-cluster-1
endpoint: https://cluster-1.internal
- name: gpt-4-cluster-2
endpoint: https://cluster-2.internal
- type: kubernetes
namespace: ai-models
label_selector: "tier=llm"
strategy: round_robin # 负载均衡策略
最佳实践建议
| 场景 | 推荐配置 |
|:---|:---|
| 开发环境 | type: static + 本地配置文件 |
| 生产环境 | type: http + 健康检查 |
| 大规模部署 | type: consul + 动态发现 |
| 混合云架构 | type: composite + 多源聚合 |
常见问题解答 (FAQ)
Q1: 迁移后原有配置会失效吗？
不会立即失效，但会在下个主版本移除支持。建议查看迁移警告：
openclaw doctor --check-deprecated
系统会输出需要迁移的具体配置项。
Q2: 如何开发自定义 Provider 插件？
参考官方模板仓库：
git clone https://github.com/openclaw/provider-plugin-template
cd provider-plugin-template
实现 DiscoveryProvider 接口
make build && make install
详细接口定义见 OpenClaw 插件开发文档。
Q3: 插件发现配置支持热更新吗？
支持。配置变更后发送 SIGHUP 信号：
kill -HUP $(pgrep openclaw)
或启用自动重载：
discovery:
watch_config: true
reload_delay: 5s
Q4: 迁移过程中遇到 "provider not found" 错误怎么办？
按以下顺序排查：
1. 确认插件已正确安装：openclaw plugin list | grep
2. 检查配置文件路径权限：ls -la ~/.openclaw/plugins/
3. 查看详细日志：openclaw --log-level=debug provider discover
Q5: 这次重构对性能有影响吗？
实际测试显示，插件化后的发现延迟增加约 3-5ms（可忽略），但获得了：
- 启动时间减少 40%（按需加载插件）
- 内存占用降低 25%（无未使用 Provider 的初始化）
总结与下一步
本次重构将 OpenClaw 的 Provider 发现 能力完全插件化，是向模块化 AI Agent 框架演进的重要一步。关键收益包括：
- ✅ 解耦核心框架与具体 Provider 实现
- ✅ 支持动态扩展，无需重启服务
- ✅ 统一的插件配置管理界面
建议行动：
1. 运行 openclaw doctor 检查现有配置
2. 参考本文迁移指南逐步更新
3. 关注 OpenClaw 官方博客 获取后续更新
---
相关阅读
参考来源
- GitHub Commit: 19de5d1 -
refactor: move provider discovery config into plugins - OpenClaw 官方文档
- OpenClaw Provider 插件规范
- OpenClaw 配置迁移指南
