OpenClaw 기반 MCP Tool 아키텍처 (로컬 vs K8s)

아래는 동일한 MCP Tool 세트를 로컬 환경과 K8s 환경에서 실행할 때의 아키텍처 비교다.

1) 로컬 환경 아키텍처

flowchart LR
  subgraph LocalHost[Local Host]
    OC[OpenClaw Agent]
    Skills[Skills Registry]
    Tools["MCP Tools<br/>(helm_diff, breaking_check,<br/>generate_doc, update_docs, create_pr, deploy_validate)"]
    Repo["dip-catalog Repo<br/>(manifests/helm/...)"]
    Files["Docs/Outputs
(upgrade.md, PR metadata)]
    Secrets[Local Secrets
(.env / keychain)"]
  end

  OC -->|Skill 호출| Tools
  OC --> Skills
  Tools --> Repo
  Tools --> Files
  Tools --> Secrets

  OC -->|GitHub API| GH[GitHub]
  OC -->|LLM API| LLM[LLM Provider]

특징

OpenClaw와 MCP Tools가 같은 머신에서 실행
chart_path는 로컬 디렉토리 기준으로 바로 접근
Secrets는 로컬 파일/.env/키체인으로 관리
배포 검증이 필요하면 로컬 K8s(kind/k3d) 사용

2) K8s 환경 아키텍처

flowchart LR
  subgraph K8s["Kubernetes Cluster"]
    OC["OpenClaw Agent Pod"]
    Skills["Skills Registry"]
    Tools["MCP Tools<br/>(helm_diff, breaking_check,<br/>generate_doc, update_docs, create_pr, deploy_validate)"]
    Repo["Git Repo Volume
(dip-catalog)"]
    NS[Test Namespace]
  end

  OC -->|Skill 호출| Tools
  OC --> Skills
  Tools --> Repo
  Tools --> NS

  OC -->|GitHub API| GH[GitHub]
  OC -->|LLM API| LLM[LLM Provider]

  Secrets[Secrets/ConfigMap] --> OC
  Secrets --> Tools
  NP[NetworkPolicy] --- OC

특징

OpenClaw가 Pod로 실행되고 Tools는 같은 Pod 또는 별도 Service로 동작
repo는 볼륨으로 마운트하거나 git clone으로 동기화
secrets는 K8s Secret/ConfigMap으로 주입
deploy_validate는 테스트 네임스페이스에 실제 배포
NetworkPolicy/RBAC로 최소 권한 운영

차이 요약

구분	로컬 환경	K8s 환경
실행 위치	로컬 머신	K8s Pod/Service
repo 접근	로컬 파일 시스템	볼륨 마운트/클론
secrets	.env/키체인	Secret/ConfigMap
배포 검증	kind/k3d	테스트 네임스페이스
보안 통제	OS 권한	RBAC/NetworkPolicy

필요하면 이 문서를 design/에 이동하거나, 시스템 설계 문서에 통합해도 돼.

2.3 KiB Raw Permalink Blame History

OpenClaw 기반 MCP Tool 아키텍처 (로컬 vs K8s)

1) 로컬 환경 아키텍처

2) K8s 환경 아키텍처

차이 요약

2.3 KiB

Raw Permalink Blame History