OpenClaw 作为企业 Agent 平台底座:优缺点与二次开发边界¶
OpenClaw 已经不只是一个聊天机器人:它把消息渠道、Agent Runtime、会话与记忆、工具、Skill、插件、模型适配、定时任务、Web 控制台和设备节点放进了一个可自托管系统。因此,一些团队会直接部署它,或者把它包装成内部 Agent 产品。
但“能运行多个 Agent”不等于“已经是企业多租户平台”。OpenClaw 官方仍把核心安全模型定义为一个可信操作者边界内的个人助理,并明确说明同一个 Agent 或 Gateway 不是面向互不信任用户的安全隔离边界。更准确的定位是:
OpenClaw 适合做企业 Agent 平台的渠道接入层和 Agent Runtime;企业身份、租户、策略、审批、工具授权、成本治理和强隔离通常仍需要独立控制面。
公开资料很难证明究竟有多少公司把 OpenClaw 用于生产,因为内部平台通常不会公开架构、规模和事故数据。GitHub 热度、演示案例和二次开发项目可以说明关注度,不能代替生产采用证据。本文因此分析产品边界,而不使用无法复核的“客户数量”作为结论依据。
1. OpenClaw 提供了什么¶
OpenClaw 官方将其定义为连接聊天应用与 AI Agent 的自托管 Gateway。一个常驻 Gateway 负责渠道连接、会话、路由和节点控制;CLI、Web UI、桌面端和移动节点通过它工作。参考:OpenClaw 官方文档、Gateway Architecture。
主要能力包括:
- Discord、Google Chat、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp 等消息渠道;
- 文件、Shell、浏览器、Web、消息、媒体、子 Agent 和设备节点等工具;
- 用
SKILL.md表达工作方法,用插件扩展工具、渠道、模型 Provider、Hook 和 UI; - 多 Agent 工作区、独立状态与会话,以及按渠道、账号和发送者进行确定性路由;
- 托管模型、本地模型、认证配置轮换和模型失败切换;
- Cron、Heartbeat、Webhook 和生命周期 Hook;
- 工具策略、执行审批、可选沙箱、SecretRef、安全审计和策略合规检查;
- 健康检查、审计记录、Prometheus 指标与 OpenTelemetry 导出;
- Docker 和 Kubernetes 部署起点。
工具、Skill 和插件的职责划分见 Capabilities Overview,多 Agent 的状态与路由方式见 Multi-Agent Routing。项目采用 MIT License,允许企业使用、修改和分发,但仍需保留许可证声明并检查第三方依赖与商标要求。
2. 为什么适合做底座¶
2.1 从零到可用的路径短¶
企业内部 Agent 的第一批需求通常不是复杂的多 Agent 算法,而是“让模型接入企业聊天、知识、代码、浏览器和内部 API”。OpenClaw 已经提供渠道、会话、工具循环、模型适配和控制台,可以显著减少 PoC 阶段的胶水代码。
2.2 扩展面清晰¶
可以按变更性质选择扩展方式:
| 需求 | 优先扩展面 |
|---|---|
| 固化提示、步骤、检查清单 | Skill |
| 新增企业 API 或能力 | Plugin / Tool |
| 接入新的聊天或事件入口 | Channel Plugin / Webhook |
| 接入模型或认证方式 | Model Provider Plugin |
| 监听生命周期和消息事件 | Hook |
| 在外围增加租户、审批和策略 | 独立企业控制面 |
这种分层比直接修改 Agent Loop 更容易跟随上游升级。
2.3 自托管和模型选择自由¶
Gateway、工作区和会话状态可以留在企业控制的主机或 Kubernetes 中;模型可以使用公有云 API,也可以接入本地 OpenAI 兼容服务。模型认证轮换与 Failover 能降低单一 Provider 故障的影响,但企业仍需在上层统一模型准入、数据分级、预算和跨团队配额。参考:Model Providers、Model Failover。
2.4 渠道优先,适合内部协作入口¶
员工不一定愿意打开新的 Agent 门户。直接从 Slack、Teams 或其他已有入口触发 Agent,有利于低成本验证真实需求。渠道路由和每 Agent 独立工作区也适合把客服、研发、运维和知识助手分开。
2.5 已有一批安全和运维构件¶
OpenClaw 已提供工具 Allow/Deny、执行审批、沙箱、SecretRef、安全审计、审计账本、健康检查和指标。这些能力不能自动组成企业安全平台,但比从空白 Agent Loop 开始补控制要省力。官方 Kubernetes 文档也提供了 Kustomize 起点,不过明确注明它不是生产就绪部署。参考:Security、Kubernetes Installation、Prometheus Metrics。
3. 主要缺点和风险¶
3.1 多 Agent 不等于多租户¶
多 Agent 可以隔离工作区、状态目录和会话,但它解决的是运行时组织和路由,不是对抗型租户隔离。官方建议混合信任或互不信任的用户使用独立 Gateway、独立凭据,并进一步使用独立 OS 用户或主机。
因此不能只创建多个 agentId,就宣称已经完成租户隔离、数据隔离和权限隔离。
3.2 单 Gateway 架构限制横向扩展和故障模型¶
Gateway 是渠道连接、会话和路由的事实源,并持有本地状态。这个架构简单、适合单用户和小团队,但企业需要额外验证:
- 一个 Gateway 故障会影响哪些渠道、Agent 和定时任务;
- 有状态渠道连接能否安全漂移;
- SQLite、工作区和凭据如何备份、恢复和迁移;
- 如何做滚动升级、Canary、连接排空和回滚;
- 是否按部门、业务或风险域拆成多个 Gateway,而不是追求一个超大实例。
OpenClaw 提供备份、健康检查和状态恢复能力,但这不等于已经具备任意规模的 Active-Active 控制面。企业应按目标 SLO 实测,不应从“运行在 Kubernetes”推导出“天然高可用”。参考:Backup CLI、Gateway Runbook。
3.3 安全效果高度依赖配置¶
官方 README 提醒:主会话的工具默认可以在宿主机运行,除非显式配置沙箱。沙箱也是可选能力,且官方说明它不是完美安全边界。Prompt Injection 既可能来自消息,也可能来自网页、邮件、附件、仓库和工具返回值;系统提示本身不能形成硬授权边界。
更需要注意的是:
- Plugin 与 Gateway 同进程运行,应视为可信代码;
- Skill 会影响 Agent 行为,能修改 Skill 的人实际拥有高权限配置能力;
exec、浏览器、文件写入和网络访问组合后,风险不是各项简单相加;- 审批可以降低误操作,但官方明确说明它不是逐用户认证边界;
- Policy 插件用于检查配置是否符合策略,不会在每次工具调用时替代运行时强制控制。
OpenClaw 过去也出现过网络绑定和路径处理类 CVE;这不代表项目不可用,但说明企业必须固定版本、持续跟踪安全公告并建立紧急升级路径。参考:CVE-2026-28395、CVE-2026-26972。
3.4 企业身份和治理不能只靠 Gateway Token¶
企业平台通常还需要:
- 对接 OIDC/SAML、员工、服务账号、组织和用户组;
- Agent、Skill、Tool、数据源和模型的细粒度 RBAC/ABAC;
- 开发、测试、生产环境分离;
- 申请、审批、临时授权、双人复核和紧急权限;
- 数据分级、保留、删除、Legal Hold 和跨境策略;
- 每部门、用户、Agent、模型和工具的预算、配额与 Chargeback;
- 可导出到 SIEM 的不可抵赖审计;
- Agent/Skill/Plugin 的目录、负责人、版本和下线流程。
OpenClaw 的 operator scope、渠道 Allowlist、工具策略和审计是可复用基础,但不能直接替代组织级 IAM 与治理系统。
3.5 插件和 Skill 带来供应链风险¶
插件可来自 ClawHub、npm、Git、本地目录或压缩包,而且安装或更新可能执行代码。企业不能让 Agent 或普通用户直接从公共市场把组件安装到生产 Gateway。
建议建立内部镜像与目录,只允许经过以下流程的版本进入生产:来源验证、许可证检查、代码审查、依赖锁定、恶意代码扫描、SBOM、签名、沙箱回归和发布批准。Plugin 应使用明确 Allowlist,镜像和依赖使用不可变版本或 Digest。
3.6 深度 Fork 容易形成长期维护负担¶
MIT License 让 Fork 很容易,但 OpenClaw 发布频繁,Gateway 协议、插件 SDK、渠道和状态迁移都会变化。把租户、IAM、审批和计费直接写进 Fork 的核心路径,短期快,长期会不断解决上游合并、数据库迁移和安全补丁冲突。
更稳妥的原则是:外围控制面 + 稳定扩展接口优先,核心 Fork 最后考虑。
4. 三种采用方式¶
| 方式 | 做法 | 优点 | 主要风险 | 适合场景 |
|---|---|---|---|---|
| 直接部署 | 配置渠道、模型、Skill 和少量插件 | 最快、改动少、升级简单 | 企业治理和隔离不足 | 单人或同一信任域的小团队助手 |
| 外围平台化 | 自建企业控制面,OpenClaw 作为受管 Runtime | 保留上游能力,企业边界清晰 | 需要平台工程投入 | 大多数公司内部平台,推荐路线 |
| 深度 Fork | 修改 Gateway、状态、UI 和 Agent Loop | 产品体验和能力完全可控 | 上游合并、安全补丁和迁移成本最高 | 核心商业产品且现有扩展接口确实不够 |
如果目标是对外 SaaS、客户之间互不信任,或者 Agent 可以操作生产资金、身份和基础设施,不建议把一个共享 OpenClaw Gateway 直接暴露为平台。至少应采用外围控制面,并按信任边界拆分 Runtime;高风险执行还要使用独立沙箱或虚机。
5. 推荐的企业架构¶
员工 / 内部系统 / 消息渠道
│
▼
企业接入层:SSO、设备与服务身份、限流、WAF
│
▼
Agent Control Plane(企业自建或现有平台)
├── Tenant / User / Group / RBAC
├── Agent、Skill、Plugin、Model Catalog
├── Policy、Quota、Budget、Approval
├── 发布、版本、审计、评测与回滚
└── 按信任域把请求路由到 Runtime Pool
│
▼
OpenClaw Gateway Pool
├── 每个信任边界独立 Gateway 与凭据
├── Channel / Session / Memory / Agent Loop
├── 固定版本的内部 Plugin 与 Skill
└── Tool Policy + Human Approval
│ │
▼ ▼
隔离执行环境 Tool Gateway / Broker
├── gVisor/Kata/VM ├── 参数级授权与短期身份
├── 临时 Workspace ├── Egress、速率和预算控制
└── 默认拒绝网络 └── Git、DB、SaaS、生产 API
│ │
└────────┬───────────┘
▼
Model Gateway / 数据与知识系统
核心设计点是把 OpenClaw 当成受管数据面/运行时:企业控制面决定谁能创建什么 Agent、能用什么模型和工具、预算多少、是否需要审批;OpenClaw 负责会话、渠道、Agent Loop 和具体工具编排。
6. 企业如何部署在 Kubernetes 上¶
不少企业会把 OpenClaw 部署在 Kubernetes,而不是员工电脑或单台虚机上,原因通常不是 Gateway 本身需要 GPU,而是希望复用 Kubernetes 的命名空间、Secret、网络策略、持久卷、发布、监控和故障迁移能力。
6.1 官方示例是什么形态¶
OpenClaw 官方 Kubernetes 示例是一个最小 Kustomize 部署:
Namespace/openclaw
├── Deployment/openclaw # 单 Pod,Init Container + Gateway
├── Service/openclaw # ClusterIP,端口 18789
├── PersistentVolumeClaim # 默认 10 Gi,保存状态和配置
├── ConfigMap/openclaw-config # openclaw.json + AGENTS.md
└── Secret/openclaw-secrets # Gateway Token + 模型 API Key
默认 Gateway 只监听 Pod 内 Loopback,通过 kubectl port-forward 访问;如果要经过 Service 或 Ingress,必须改为适合 Pod 网络的 Bind,并保持 Gateway 认证、TLS 和 Control UI Origin 校验。官方 Manifest 已设置非 Root、只读根文件系统和 Drop All Capabilities,但文档明确说明它只是起点,不是生产就绪方案。参考:OpenClaw Kubernetes Installation。
6.2 小团队的最小可用架构¶
同一信任域的小团队可以先使用单 Gateway:
企业用户 / Slack / Teams / Webhook
│
▼
Ingress / Gateway API
├── TLS
├── 企业认证或受控代理
└── WebSocket 长连接与限流
│
▼
Service:18789
│
▼
OpenClaw Gateway Pod(replicas: 1)
├── ConfigMap:配置、Agent 指令
├── Secret/CSI:Gateway、Channel、Model 凭据
├── PVC:SQLite、Session、Workspace、Plugin 状态
├── /healthz、/readyz
└── Prometheus / OpenTelemetry
│
┌───────┴────────┐
▼ ▼
模型服务 / Model Gateway Tool Gateway / Sandbox
这种模式适合内部试点和单一部门。Pod 可以在节点故障后重新调度并重新挂载 PVC,但恢复速度取决于卷挂载、SQLite 恢复、渠道重连和定时任务恢复;它不是 Active-Active。
6.3 生产环境按信任域拆 Gateway¶
不要把同一份状态和渠道账号挂到多个普通副本后面,期望 Kubernetes Service 自动获得水平扩展。Gateway 是会话、渠道连接和路由的事实源,官方也要求每个额外 Gateway 使用独立配置、状态目录、工作区、端口和渠道凭据。
企业更适合采用分片架构:
Enterprise Agent Control Plane
├── 租户、用户、Agent Catalog、策略、配额
├── 创建/升级/备份/回收 Gateway Cell
└── 将入口路由到明确的 Trust Domain
│
├── Namespace/Cell: rd-agent
│ ├── Gateway Pod × 1
│ ├── PVC / Secret / ServiceAccount
│ └── NetworkPolicy
│
├── Namespace/Cell: ops-agent
│ ├── Gateway Pod × 1
│ ├── 独立 PVC / Secret / Channel Account
│ └── 更严格 Tool Policy + Approval
│
└── Namespace/Cell: finance-agent
├── Gateway Pod × 1
├── 独立节点池或独立集群
└── 只允许访问受控 Tool Gateway
官方多租户文档把每个独立完整实例称为 cell,并明确要求互不信任的租户使用不同 Gateway、状态、凭据、工作区和渠道账号;当前 openclaw fleet 仍是实验性、单机 Docker/Podman 管理器,不是 Kubernetes 多集群控制面。企业可以借鉴 cell 模型,但通常要用自己的 Operator、GitOps 或平台控制面在 Kubernetes 上实现生命周期。参考:Multi-Tenant Hosting、Multiple Gateways。
6.4 Kubernetes 生产化要补什么¶
| 层面 | 建议 |
|---|---|
| Workload | 一个 Gateway 信任域保持一个 Active Pod;设置资源请求/限制、启动/就绪/存活探针和合理的终止宽限时间 |
| 存储 | 每 Gateway 独立 PVC;使用支持快照和加密的 StorageClass;用 OpenClaw 在线备份接口生成一致性快照,不直接复制活跃 SQLite 文件 |
| 配置 | ConfigMap/GitOps 管理非敏感配置;变更经过 Schema、Policy 和 Canary 检查;避免运行时漂移覆盖声明式配置 |
| 密钥 | 使用 External Secrets、Secrets Store CSI 或 SecretRef 对接企业密钥系统;不要把长期 Token 写进镜像、Git 或普通 ConfigMap |
| 网络入口 | Ingress/Gateway API 支持 WebSocket、TLS、认证和限流;管理 UI 与普通消息入口分离;不公开无认证端点 |
| 网络出口 | NetworkPolicy 默认拒绝;只允许 DNS、模型入口、批准的消息渠道和 Tool Gateway;显式阻断元数据、节点和 Kubernetes API |
| 执行隔离 | 不要为了内置 Docker 沙箱而把节点 Docker Socket 挂进 Gateway Pod;代码执行放到独立 Pod、gVisor/Kata/VM 或专门 Sandbox 平台 |
| 身份 | 每 Gateway 使用独立、最小权限 ServiceAccount,并默认关闭自动挂载 Kubernetes API Token;业务权限通过短期身份和 Tool Gateway 获取 |
| 可观测性 | 使用 /healthz、/readyz;Prometheus 指标端点需要 Gateway 认证,不能通过 Ingress 公开成匿名 /metrics |
| 可用性 | PDB 只能降低主动驱逐,不会把单 Gateway 变成 HA;定义 PVC 挂载、渠道重连、SQLite 恢复和 Cron 补偿的 RTO |
| 发布 | 镜像固定 Digest;使用测试渠道账号或合成流量做 Canary;确认新旧实例不会同时争用同一个有状态渠道连接 |
OpenClaw 提供的 /healthz 和 /readyz 可分别作为 Liveness 与 Readiness 起点;Prometheus 插件还能暴露模型调用、Token、成本、工具执行、队列和会话恢复指标。参考:Health Checks、Prometheus Metrics。
6.5 Kubernetes 带来的和没有带来的¶
Kubernetes 能提供自动重启、重新调度、资源限制、Secret 挂载、网络策略、PVC、GitOps 和观测接入,但不会自动提供:
- OpenClaw 状态的 Active-Active 一致性;
- 渠道连接和定时任务的无损主备切换;
- Gateway 内部的强多租户授权边界;
- Prompt Injection 防护;
- 业务工具的参数级授权和短期凭据;
- SQLite、Workspace 和 Channel Credential 的正确备份恢复语义。
因此,“部署到 Kubernetes”是生产化的一部分,不是生产就绪的充分条件。
7. 哪些能力复用,哪些能力自己建设¶
| 能力 | 建议责任方 | 原因 |
|---|---|---|
| 渠道适配、消息收发、会话路由 | OpenClaw | 已有成熟抽象,重复建设价值低 |
| Agent Loop、会话、记忆、子 Agent | OpenClaw | 属于 Runtime 核心能力 |
| Skill/Plugin SDK 和模型 Provider | OpenClaw + 内部扩展 | 复用接口,内部版本需审核 |
| 企业 SSO、组织、用户组、租户 | 企业控制面 | 必须接组织身份源并形成统一边界 |
| Agent/Tool/Model 目录与发布 | 企业控制面 | 需要负责人、版本、环境和审批 |
| 业务 API 授权和短期凭据 | Tool Gateway | 不应把长期生产密钥交给 Agent 工作区 |
| 强多租户执行隔离 | Sandbox 平台 | Gateway 内多 Agent 不是强安全边界 |
| 预算、配额、Chargeback | 企业控制面 / Model Gateway | 需要跨 Agent、模型和 Provider 汇总 |
| 审计归档、SIEM、合规保留 | 企业安全平台 | 本地记录需集中、防篡改和按政策保留 |
| Gateway、SQLite、工作区备份 | 平台运维 | 需要加密、恢复演练和明确 RPO/RTO |
8. 上线前最低安全基线¶
身份与租户¶
- 按部门、环境或风险等级定义信任边界;互不信任的用户不共享 Gateway;
- 渠道使用 Pairing/Allowlist,群组默认要求 Mention;
- 多人私信入口使用按渠道和发送者隔离的 Session Scope;
- 管理入口只通过企业认证后的私网、VPN、零信任代理或受控隧道开放。
工具与执行¶
- 默认禁用宿主机
exec、文件写入和 Elevated;按 Agent 明确 Allowlist; - 需要执行代码时默认进入沙箱,并限制 CPU、内存、PID、磁盘、时间和网络;
- Shell、生产变更、外发消息和高价值业务操作必须采用参数级策略与人工审批;
- 审批超时或 UI 不可用时 Fail Closed;不能把 LLM 自审当作高风险操作的唯一审批人。
密钥与网络¶
- 使用 SecretRef 对接 Vault/KMS/Secret Manager,清除配置和工作区中的明文凭据;
- Agent 只获得短期、窄范围身份;生产 API 通过 Tool Gateway 调用;
- 默认拒绝出站,阻断云元数据、Kubernetes API、节点网段和未批准公网地址;
- 把网页、邮件、附件、仓库和工具返回值全部视为不可信输入。
供应链与发布¶
- 只允许内部审核和固定版本的 Plugin/Skill/镜像;
- 每次升级先读 Release Notes 和安全公告,在影子流量或 Canary Gateway 验证;
- 对渠道重连、会话恢复、Cron、审批、状态迁移和回滚建立自动化测试;
- 不自动跟随
latest,生产使用签名制品和不可变 Digest。
审计与恢复¶
- 集中采集身份、会话、模型、工具、审批、策略拒绝、成本和结果状态;敏感正文单独分级;
- 为 SQLite、配置、凭据和工作区分别制定备份、加密、保留与删除策略;
- 定期恢复到隔离环境,验证会话、渠道、Agent 和定时任务,而不只验证压缩包能解开;
- 监控队列深度、会话卡死、模型错误、工具拒绝、成本、事件循环和内存压力。
更完整的执行隔离方法见 Agent Sandbox 选型与架构分析 和 AI Agent、沙箱与工具执行。
9. PoC 不应只验证“能聊天”¶
建议用真实企业场景评估,并把结果记录为证据:
| 维度 | 最低验收问题 |
|---|---|
| 功能 | 三个高频场景能否稳定完成,失败时是否给出可操作错误? |
| 隔离 | 用户 A 能否看到用户 B 的会话、文件、记忆、Token 或工具结果? |
| Prompt Injection | 恶意网页、邮件和仓库能否诱导 Agent 读取密钥、执行命令或外传数据? |
| 权限 | 未审批的高风险工具是否确定性拒绝,而不是只靠 Prompt 提醒? |
| 恢复 | Gateway 重启、Pod 漂移、模型超时和渠道断线后,会话和任务怎样恢复? |
| 升级 | 固定版本升级后,配置、数据库、Plugin、Skill 和渠道是否兼容? |
| 观测 | 能否把一次用户请求关联到模型调用、工具、审批、成本和最终状态? |
| 成本 | 单任务 Token、工具、浏览器、存储和人工审批成本是多少? |
| 运维 | 备份能否恢复,安全补丁能否在目标时限内完成,是否有回滚路径? |
PoC 通过标准应是“风险和运维边界可测量”,而不是“演示时 Agent 成功执行过一次”。
10. 什么时候值得采用¶
更适合采用 OpenClaw:
- 目标是内部员工助手、渠道自动化、研发或运维 Copilot;
- 用户属于相同或可拆分的信任域;
- 希望自托管,并需要快速接入多种模型、渠道和工具;
- 团队愿意维护 Runtime、安全策略、插件供应链和升级流程;
- 能接受在外围补企业 IAM、控制面、Tool Gateway 和 Sandbox。
不宜直接采用,或需要先做更严格评估:
- 面向公网和互不信任客户的共享多租户 SaaS;
- 强监管数据,且缺少完整数据流、删除证明和合规控制;
- Agent 可直接操作生产基础设施、支付、身份或高价值资产;
- 要求跨地域 Active-Active、严格 RPO/RTO,却不愿建设有状态 Runtime 运维体系;
- 团队希望“安装一个开源项目就获得完整企业 Agent 平台”。
11. 最终建议¶
对于多数公司,优先选择“外围平台化,不深度 Fork”:
- 先用原生 OpenClaw 在单一信任域验证 2~3 个高价值场景;
- 再把身份、目录、策略、审批、预算和审计放进企业控制面;
- 把生产 API 放在 Tool Gateway 后,把不可信执行放进独立 Sandbox;
- 按信任边界拆 Gateway,固定版本并建立 Canary、备份和恢复;
- 只有稳定扩展接口无法满足核心产品需求时,才维护小范围 Fork。
OpenClaw 的最大价值是缩短 Agent Runtime、渠道和扩展生态的建设时间;最大风险是把这种开发效率误认为企业控制面、强多租户隔离和生产治理已经完成。只要边界划分正确,它可以是很有生产力的底座;如果边界划分错误,它也会把消息、模型、工具、密钥和宿主执行风险集中到同一个 Gateway 中。