AI创业内参
Agent工坊

【Agent工坊】OpenClaw 2026.6.9 Beta 深度实战：独立 Provider 插件系统重构——从单体到微内核的架构进化

AI创业内参

OpenClaw 在 2026.6.9-beta.1 中将所有官方 Provider 拆分为独立 npm 包。这不仅是工程重构——对于一人公司的 AI 创业者来说，它意味着你可以按需加载模型提供商、减少启动开销、并自行开发和发布自定义 Provider 插件。本文带你从原理到实战，完整走通新插件系统的安装、配置和开发流程。

▲ OpenClaw架构对比：单体（左）vs 微内核+插件（右）——新架构将50+ Provider▲ ▲ OpenClaw架构对比：单体（左）vs 微内核+插件（右）——新架构将50+ Provider拆分为独立npm包

为什么这次重构值得你关注

OpenClaw 是一个多通道、多 Agent 的 AI 运营中枢，支持 WhatsApp、Telegram、Discord、Slack 等消息通道，以及 50+ 个大模型提供商（从 Anthropic 到 DeepSeek 到 Ollama）。

在 2026.6.9-beta.1 之前，所有 Provider 的代码都打包在主仓库中。这意味着：每次添加一个新模型提供商，所有用户都要下载全部代码；如果你只需要 Anthropic + DeepSeek 两个提供商，你仍然要带着其他 48 个提供商的代码运行。

6 月 19 日发布的 beta.1 彻底改变了这一点——官方 Provider 全部外化为独立 npm 包。Gateway 启动时自动发现已安装的 Channel 插件，每个 Provider 成为可选模块。这被称为 OpenClaw 从「单体应用」到「微内核+插件」的架构转型。

新架构的三个核心变化

变化一：Provider 成为一等公民的 npm 包

以前你需要这样配置一个模型：

// openclaw.jsonc（旧格式）

{

  agents: {

    defaults: {

      model: { primary: "anthropic/claude-opus-4-6" }

    }

  }

}

现在，Provider 本身就是一个独立的 npm 包。例如 DeepSeek Provider：

# 安装独立 Provider 包

npm install -g @openclaw/provider-deepseek

# Gateway 启动时自动发现

openclaw gateway start

# 输出：[plugin] discovered @openclaw/provider-deepseek v1.0.0

变化二：Gateway 插件发现机制

新版本的核心是 Gateway 的「Channel Plugin Discovery」——启动时扫描 node_modules 中所有 @openclaw/provider-* 和 @openclaw/channel-* 包，自动注册。

# 查看已安装的插件

openclaw plugins list

# 示例输出：

# @openclaw/provider-deepseek v1.0.0 ✅ active

# @openclaw/provider-gemini v1.0.0 ✅ active

# @openclaw/channel-telegram v1.2.0 ✅ active

# @openclaw/provider-stepfun — ⚠️ npm-only (ClawHub unavailable)

关键细节：StepFun Provider 因为 ClawHub 包名冲突，被设计为 npm 独占发布。这意味着某些 Provider 可能只在 npm 上可用，不在 ClawHub 中——这是你需要留意的发布渠道差异。

▲ Provider插件安装三步流程：npm install → config set → gate▲ ▲ Provider插件安装三步流程：npm install → config set → gateway start

变化三：Codex 集成获得自动插件审批

对于使用 OpenAI Codex 的用户，这次更新带来了一个非常实用的改进——自动插件审批。以前 Codex 每次调用插件都需要手动确认，现在可以在配置中设置自动审批规则：

// openclaw.jsonc — Codex 插件自动审批

{

  codex: {

    auto_approve_plugins: [

      "@openclaw/provider-deepseek",

      "@openclaw/channel-telegram"

    ]

  }

}

同时，Codex 现在还支持 远程节点执行（remote-node exec），当有节点连接时，可以把命令下发到远程机器执行——对于需要在多台服务器上运行 AI 任务的创业者来说，这意味着可以用一台机器管理整个集群。

实战：安装并使用一个新的 Provider

假设你需要让 OpenClaw 支持 DeepSeek V4，以下是完整步骤：

步骤 1：安装 Provider 包

npm install -g @openclaw/provider-deepseek

步骤 2：配置 API 密钥

openclaw config set providers.deepseek.apiKey "sk-your-key-here"

步骤 3：设置为默认模型

// openclaw.jsonc

{

  agents: {

    defaults: {

      model: { primary: "deepseek/deepseek-v4-pro" }

    }

  }

}

步骤 4：验证

openclaw gateway start

# 输出应包含：[plugin] discovered @openclaw/provider-deepseek

openclaw plugins list

# 确认 deepseek provider 状态为 active

步骤 5：发送测试消息

openclaw chat --model deepseek/deepseek-v4-pro "你好，当前是什么模型？"

踩坑与排障

坑 1：ClawHub 与 npm 的包名不一致

某些 Provider（如 StepFun）在 ClawHub 上的包名已被占用，只能从 npm 安装。如果你在 ClawHub 搜索不到某个 Provider，先去 npm 查找：

npm search @openclaw/provider-

▲ Codex远程节点执行架构：Gateway通过exec命令调度多台服务器上的AI任务▲ ▲ Codex远程节点执行架构：Gateway通过exec命令调度多台服务器上的AI任务

坑 2：Gateway 启动后插件未加载

如果 openclaw plugins list 看不到刚安装的包，检查：

# 确认包在全局 node_modules 中

npm list -g --depth=0 | grep openclaw

# 确认 package.json 中有 openclaw 的 peerDependency

cat $(npm root -g)/@openclaw/provider-xxx/package.json | grep -A5 peerDependencies

Gateway 只会加载声明了正确 peerDependencies（指向当前 OpenClaw 版本）的插件。

坑 3：Codex 远程节点连接但 exec 失败

如果你看到 remote-node exec 报错，检查：

  • 远程节点的 OpenClaw 版本是否与 Gateway 匹配（需要同为 2026.6.9-beta.1+）
  • 远程节点是否在 Gateway 的 nodes 配置中正确注册

对一人公司创业者的实际意义

这次架构重构直接影响了三个实际场景：

场景一：轻量化部署 如果你的业务只需要 3 个模型提供商，你只需要安装 3 个 npm 包。旧架构下你要带着全部 50+ 提供商的代码。对于运行在低配 VPS 上的 AI Agent，减少的启动开销是实实在在的。

场景二：自定义 Provider 开发 现在你可以独立开发、测试、发布你自己的 Provider 插件。比如连接公司内部的私有模型服务，只需写一个 @yourcompany/provider-internal 包，组织内通过 npm private registry 分发。

场景三：渐进式升级 Provider 包和 OpenClaw 核心可以独立升级。某个 Provider 出了安全补丁，不影响其他模块。这对生产环境非常重要——你不需要因为一个小 Provider 的安全更新就升级整个 OpenClaw。

常见问题

Q：旧配置需要迁移吗？ A：不需要。Provider 配置格式（provider/model）保持不变。唯一变化的是 Provider 代码从主仓库移到了独立包。

Q：可以用 npm 之外的方式安装 Provider 吗？ A：可以。Gateway 支持 plugin_paths 配置，你可以指定本地目录作为插件来源——适合开发中的自定义 Provider。

Q：插件系统是否支持热加载？ A：当前版本不支持。安装新 Provider 后需要重启 Gateway。

行动建议

  1. 立即升级：npm install -g openclaw@2026.6.9-beta.1
  2. 清理冗余：只保留你实际使用的 Provider 包
  3. 关注 StepFun：如果你在国内，这个 npm-only 的 Provider 值得关注
  4. 备份配置：升级前 cp openclaw.jsonc openclaw.jsonc.bak

本文由AI辅助创作，经人工审核编辑发布

更多一人公司案例与工具 → 微信公众号搜索「AI创业内参」→ 菜单栏「官方网站」即可访问 xopcx.com