# System Architecture

### Design Philosophy

Clawcloud Run aims to build a Kubernetes-based cloud operating system that maximally abstracts Kubernetes complexity from general users during system interaction, while delivering simple and intuitive functionality. Concurrently, it provides cloud computing professionals with specialized, high-efficiency tools to accomplish advanced tasks.

To achieve this dual objective, Clawcloud Run adopts an "Everything-as-an-Application" paradigm. Each system capability is abstracted as independent yet interoperable applications. Users with varying requirements and objectives interact with distinct applications to fulfill specific functions, maintaining an operational experience consistent with single-machine operating system interactions. This design ensures both accessibility for novice users and extensibility for expert practitioners.

### Overall Architecture

The high-level architecture of Clawcloud Run is structured as follows:

<figure><img src="/files/o5IBUvME9zClcmuPgowE" alt=""><figcaption><p>System Architecture</p></figcaption></figure>

Thus, Clawcloud Run can be defined as Kubernetes + a suite of applications.

### Application Architecture

Applications on Clawcloud Run adopt a frontend-backend decoupled architecture, with frontends supporting Server-Side Rendering (SSR). This design allows applications to operate as standalone services independent of the monolithic Clawcloud Run system.

Application Architecture and Interactions (illustrated via App Launchpad and Terminal applications):

<figure><img src="/files/7hXBdHFkyKN6pDL05CkU" alt=""><figcaption><p>Application Architecture</p></figcaption></figure>

Each application’s frontend interacts with multiple APIs:

* Kubernetes Native API for basic operations
* Kubernetes CRD API for complex logic execution
* Database APIs for data persistence and retrieval
* Service APIs from cluster-deployed specialized applications for domain-specific workflows

Consequently, Clawcloud Run can be expressed as:\
Clawcloud Run = Kubernetes + a suite of applications = "Frontend systems + Kubernetes API + Kubernetes CRD API + Database API + Service API".


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.run.claw.cloud/clawcloud-run/architecture/system-architecture.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.