| name | k8s-ops-plugin |
| description | Kubernetes operations plugin — 32 tools for cluster management, monitoring, troubleshooting, and security auditing |
| version | 2.1.2 |
| metadata | {"openclaw":{"requires":{"bins":["kubectl"]},"emoji":"☸️","homepage":"https://github.com/CN-big-cabbage/k8s-ops-agent"}} |
K8s Ops Plugin
Kubernetes operations plugin for OpenClaw. Provides 32 tools covering the full lifecycle of K8s cluster management.
⚠️ 安全警告
重要：本插件具有强大的集群操作能力，使用前请仔细阅读以下安全建议：
-
凭据安全：kubeconfig 文件包含集群端点、用户身份、令牌和客户端证书等敏感信息。请勿在不安全的环境中存储或共享 kubeconfig 文件。
-
最小权限原则：建议使用最小权限的 kubeconfig，避免使用 cluster-admin 凭据。建议先在非生产环境中测试。
-
操作风险：exec、rollout、scale、restart、namespace 等操作可能对生产集群造成破坏性影响。请在执行前确认操作目标。
-
SSH 访问：配置中的 hosts 字段用于 SSH 主机访问（sys-monitor 工具），请仅配置受信任的主机，避免在生产环境中使用密码认证。
-
参数验证：所有工具接受任意参数并直接传递给处理程序。请确保参数正确，避免误操作。
-
依赖审查：本插件的实际工具行为委托给 @k8s-ops/core。请在安装前审查该依赖的实现。
Tools
- Pod Management: list, inspect, exec, logs, port-forward
- Deployments: status, rollout, scale, restart
- Services & Networking: services, ingress, gateway, network policies
- Workloads: jobs, cronjobs, daemonsets, statefulsets, HPA
- Storage: PV/PVC management
- Security: RBAC audit, security scanning, pod security policies
- Observability: events, metrics, health checks, cost analysis
- Troubleshooting: diagnostics, topology, event analysis
- Advanced: CRDs, Helm releases, PDB, YAML generation, namespace management
Requirements
kubectl installed and configured with cluster access- Valid kubeconfig (defaults to
~/.kube/config)
- 建议：使用最小权限的 ServiceAccount，避免使用集群管理员凭据
Configuration
Optional plugin config:
| Field | Description | 安全建议 |
|---|
kubeconfigPath | Custom path to kubeconfig file | 确保文件权限为 600，仅当前用户可读 |
defaultContext | Default Kubernetes context to use | 建议使用非生产环境的 context |
hosts | SSH target hosts for sys-monitor tool | 仅配置受信任的主机，建议使用 SSH 密钥认证 |
最佳实践
- 环境隔离：建议为不同环境（开发、测试、生产）使用不同的 kubeconfig
- 审计日志：启用 Kubernetes 审计日志，记录所有操作
- 定期轮换：定期轮换 kubeconfig 中的凭据和令牌
- 权限审查：定期审查 RBAC 权限，移除不必要的权限
- 操作确认：对于破坏性操作（如 delete、scale、restart），建议在执行前进行人工确认
- 命名空间限制：建议限制插件只能访问特定的命名空间，避免集群级别的操作
