什么是 Kubernetes 集群 API (CAPI) 管理器？

k8s-capi 技能是一个专门的工具集，旨在通过集群 API (CAPI) 范式管理 Kubernetes 集群的全生命周期。通过利用 kubectl-mcp-server，该技能使 AI 代理能够与管理集群交互，从而在各种基础设施提供商之间配置、扩展和升级工作负载集群。对于在多集群环境中运行、需要将基础设施视为代码同时保持对机器健康和集群配置的高级控制的团队来说，它是 Openclaw Skills 的重要组成部分。

下载入口:https://github.com/openclaw/skills/tree/main/skills/rohitg00/k8s-capi

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Kubernetes 集群 API (CAPI) 管理器 应用场景

• 自动化配置新的生产或开发 Kubernetes 集群。
• 通过调整 MachineDeployment 副本数动态扩展工作节点池。
• 在机器集中执行 Kubernetes 版本的滚动升级。
• 获取安全的 kubeconfig 凭据以实现自动化工作负载集群访问。
• 通过详细的资源检查诊断基础设施故障或配置瓶颈。

1. 该技能首先通过 capi_detect_tool 验证环境，以确保集群 API 组件处于活动状态。
2. 用户可以查询管理集群以列出并检查集群、机器和部署的状态。
3. 通过与 MachineDeployment 和 MachineSet 资源交互来执行扩展或升级等生命周期操作。
4. 基础设施更改通过声明式清单应用，该技能会监控这些清单的完成情况。
5. 通过机器状态检查和事件日志促进持续的健康监测，以确保维持所需的基础设施状态。

Kubernetes 集群 API (CAPI) 管理器 配置指南

要开始使用 Openclaw Skills 库的这一新增功能，请确保您拥有一个已安装集群 API 提供程序的管理集群。

1. 如果尚未安装，请安装 kubectl-mcp-server。
2. 在环境中验证您的 CAPI 安装：

capi_detect_tool()

3. 确保您的管理集群拥有管理目标基础设施（AWS、Azure、GCP 等）所需的权限。

Kubernetes 集群 API (CAPI) 管理器 数据架构与分类体系

k8s-capi 技能将基础设施数据组织为几种关键资源类型：

name: k8s-capi
description: Cluster API lifecycle management for provisioning, scaling, and upgrading Kubernetes clusters. Use when managing cluster infrastructure or multi-cluster operations.

Cluster API Lifecycle Management

Manage Kubernetes clusters using kubectl-mcp-server's Cluster API tools (11 tools).

Check Installation

capi_detect_tool()

List Clusters

# List all CAPI clusters
capi_clusters_list_tool(namespace="default")

# Shows:
# - Cluster name
# - Phase (Provisioning, Provisioned, Deleting)
# - Infrastructure ready
# - Control plane ready

Get Cluster Details

capi_cluster_get_tool(name="my-cluster", namespace="default")

# Shows:
# - Spec (control plane, infrastructure)
# - Status (phase, conditions)
# - Network configuration

Get Cluster Kubeconfig

# Get kubeconfig for workload cluster
capi_cluster_kubeconfig_tool(name="my-cluster", namespace="default")

# Returns kubeconfig to access the cluster

Machines

List Machines

capi_machines_list_tool(namespace="default")

# Shows:
# - Machine name
# - Cluster
# - Phase (Running, Provisioning, Failed)
# - Provider ID
# - Version

Get Machine Details

capi_machine_get_tool(name="my-cluster-md-0-xxx", namespace="default")

Machine Deployments

List Machine Deployments

capi_machinedeployments_list_tool(namespace="default")

# Shows:
# - Deployment name
# - Cluster
# - Replicas (ready/total)
# - Version

Scale Machine Deployment

# Scale worker nodes
capi_machinedeployment_scale_tool(
    name="my-cluster-md-0",
    namespace="default",
    replicas=5
)

Machine Sets

capi_machinesets_list_tool(namespace="default")

Machine Health Checks

capi_machinehealthchecks_list_tool(namespace="default")

# Health checks automatically remediate unhealthy machines

Cluster Classes

# List cluster templates
capi_clusterclasses_list_tool(namespace="default")

# ClusterClasses define reusable cluster configurations

Create Cluster

kubectl_apply(manifest="""
apiVersion: cluster.x-k8s.io/v1beta1
kind: Cluster
metadata:
  name: my-cluster
  namespace: default
spec:
  clusterNetwork:
    pods:
      cidrBlocks:
      - 192.168.0.0/16
    services:
      cidrBlocks:
      - 10.96.0.0/12
  controlPlaneRef:
    apiVersion: controlplane.cluster.x-k8s.io/v1beta1
    kind: KubeadmControlPlane
    name: my-cluster-control-plane
  infrastructureRef:
    apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
    kind: AWSCluster
    name: my-cluster
""")

Create Machine Deployment

kubectl_apply(manifest="""
apiVersion: cluster.x-k8s.io/v1beta1
kind: MachineDeployment
metadata:
  name: my-cluster-md-0
  namespace: default
spec:
  clusterName: my-cluster
  replicas: 3
  selector:
    matchLabels:
      cluster.x-k8s.io/cluster-name: my-cluster
  template:
    spec:
      clusterName: my-cluster
      version: v1.28.0
      bootstrap:
        configRef:
          apiVersion: bootstrap.cluster.x-k8s.io/v1beta1
          kind: KubeadmConfigTemplate
          name: my-cluster-md-0
      infrastructureRef:
        apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
        kind: AWSMachineTemplate
        name: my-cluster-md-0
""")

Cluster Lifecycle Workflows

Provision New Cluster

1. kubectl_apply(cluster_manifest)
2. capi_clusters_list_tool(namespace)  # Wait for Provisioned
3. capi_cluster_kubeconfig_tool(name, namespace)  # Get access

Scale Workers

1. capi_machinedeployments_list_tool(namespace)
2. capi_machinedeployment_scale_tool(name, namespace, replicas)
3. capi_machines_list_tool(namespace)  # Monitor

Upgrade Cluster

1. # Update control plane version
2. # Update machine deployment version
3. capi_machines_list_tool(namespace)  # Monitor rollout

Troubleshooting

Cluster Stuck Provisioning

1. capi_cluster_get_tool(name, namespace)  # Check conditions
2. capi_machines_list_tool(namespace)  # Check machine status
3. get_events(namespace)  # Check events
4. # Check infrastructure provider logs

Machine Failed

1. capi_machine_get_tool(name, namespace)
2. get_events(namespace)
3. # Common issues:
   # - Cloud provider quota
   # - Invalid machine template
   # - Network issues

Related Skills

• k8s-multicluster - Multi-cluster operations
• k8s-operations - kubectl operations