Install 导读

K8s 部署:一条命令拉起 OpenClaw,先配好 API Key

这页不是生产级部署,而是让你在已有集群上快速跑起来的最小配置。先执行 `./scripts/k8s/deploy.sh` 并设置好模型提供商的 API Key,部署后记得用 `kubectl get secret` 拿 Control UI 的共享密钥,默认开启了 token 认证。

先讲这一页到底在解决什么

K8s 部署:一条命令拉起 OpenClaw,先配好 API Key

这页不是生产级部署,而是让你在已有集群上快速跑起来的最小配置。先执行 `./scripts/k8s/deploy.sh` 并设置好模型提供商的 API Key,部署后记得用 `kubectl get secret` 拿 Control UI 的共享密钥,默认开启了 token 认证。

原文共 19 节,先看 Start Here 路径:/install/kubernetes 查看官方原文

第一站

🏗️ 为什么官方没先给 Helm?因为这页觉得“房间里的内容”比“房子模板”更重要

官方这里的态度很明确,值得直接翻译成人话。

📦 OpenClaw 本体不复杂

单容器、少量配置文件,本体不像那种需要巨大模板系统的超级集群应用。

🧩 真正常变的是内容

agent 文档、skills、配置覆盖这些东西,比基础资源模板更常改。

🪶 Kustomize 更轻

像用轻量叠层贴纸做变体,而不是先背一整本 Helm 法典。

🎈 一句话

这页先给你骨架,不先给你一整套厚重模板机器。

第二站

🚀 Quick start 就是在说:“先把 provider 钥匙塞进环境,再让脚本把骨架架起来”

比想象中简单。

export <PROVIDER>_API_KEY=\"...\"

像先把模型商店钥匙塞进口袋,不然后面搭好的 Gateway 也只是空壳。

./scripts/k8s/deploy.sh

像让脚手架队进场,一次把 Namespace、Deployment、Service、PVC、Secret 都立起来。

kubectl port-forward svc/openclaw 18789:18789 -n openclaw

像拉一条本地临时电话线,把集群里的控制台窗口牵到你眼前。

kubectl get secret ... | base64 -d

像从集群保险柜里把 Gateway 门票取出来,粘贴到控制台登录框。

第三站

📦 What gets deployed 那段,就是“仓库里到底立了哪些柜子”

理解这一段以后,Kubernetes 就没那么像黑魔法。

🏷️

Namespace

像先给 OpenClaw 划出一个单独区域,别和别的应用混在一堆箱子里。

🚚

Deployment

真正跑 Gateway 的那台工作车。

🚪

Service

像集群内部固定门牌,别人要找它先走这里。

💾

PVC + Secret + ConfigMap

一个管储物柜,一个管钥匙,一个管说明书。

第四站

🧪 Kind 本地测试那段,是“先在自己电脑上搭一个迷你练习仓库”

这对没现成集群的人很友好。

./scripts/k8s/create-kind.sh

像先在本机摆一个小号练习场,给你排练整套部署动作。

./scripts/k8s/create-kind.sh --delete

练完了就拆台,不留临时仓库占地。

🎈 收尾一句

Kubernetes 这页的重点不是炫复杂,而是给你一副最小骨架,让你能先站起来。