# nick-maximillien/openclaw-auth0-vault architecture

> Architecture diagram of the GitHub repository nick-maximillien/openclaw-auth0-vault, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nick-maximillien/openclaw-auth0-vault
- Repository: https://github.com/nick-maximillien/openclaw-auth0-vault

## Overview

CFO Shield is a delegated-identity gateway for autonomous agents: a user authorizes provider access in the Next.js vault, the frontend synchronizes the subject token to the Go proxy, and agent requests are exchanged for scoped downstream tokens before API execution. The repository also includes an OpenClaw workspace with service skills and a broader set of integrations documented in the README. Several provider handlers and workspace workflows are not fully excerpted, so those capabilities are shown at subsystem level; edges use README evidence where source wiring was not shown.

Main entry points: [`vault-api/main.go`](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/main.go) (Shield Middleware), [`next-vault/src/app/page.tsx`](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/app/page.tsx) (Vault Dashboard), [`openclaw-workspace/openclaw.json`](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/openclaw-workspace/openclaw.json) (OpenClaw Agent), [`vault-api/google`](https://github.com/nick-maximillien/openclaw-auth0-vault/tree/main/vault-api/google) (Google Workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delegation["User Delegation"]
  node_dashboard["Vault Dashboard<br/>[page.tsx]"]
  node_auth_config["Auth0 Session<br/>[auth0.ts]"]
  node_auth_proxy["Auth Routes<br/>[proxy.ts]"]
  node_management["Policy &amp; Audit UI<br/>[page.tsx]"]
  node_help["Help Guide<br/>[page.jsx]"]
end

subgraph group_gateway["Secure Gateway"]
  node_vault_api["HTTP Router<br/>[main.go]"]
  node_session[("Active Session<br/>[main.go]")]
  node_shield["Shield Middleware<br/>[main.go]"]
  node_token_exchange["Token Exchange<br/>[main.go]"]
end

subgraph group_integrations["Enterprise Integrations"]
  node_google["Google Workspace"]
  node_github["GitHub API<br/>[github.go]"]
  node_social["Social APIs"]
  node_notion["Notion API<br/>[notion.go]"]
  node_autobooks["Autobooks API<br/>[autobooks.go]"]
  node_tavily["Tavily Search<br/>[search.go]"]
end

subgraph group_agent_runtime["Agent Runtime"]
  node_openclaw["OpenClaw Agent<br/>[openclaw.json]"]
  node_skills["Service Skills"]
  node_login_skill["Login Skill<br/>[index.ts]"]
end

node_user(("Principal"))
node_auth0{{"Auth0"}}
node_enterprise_services{{"External Services"}}

node_user -->|"authorizes"| node_dashboard
node_dashboard -->|"loads session"| node_auth_config
node_auth_proxy -->|"mounts auth"| node_auth_config
node_dashboard -->|"exchanges tokens"| node_auth0
node_dashboard -->|"syncs subject token"| node_vault_api
node_management -->|"shows policies"| node_user
node_help -->|"explains operation"| node_user
node_openclaw -.->|"uses skills"| node_skills
node_skills -->|"includes login"| node_login_skill
node_openclaw -->|"requests APIs"| node_vault_api
node_vault_api -->|"synchronizes token"| node_session
node_vault_api -->|"routes protected calls"| node_shield
node_shield -->|"reads subject token"| node_session
node_shield -->|"requests scoped token"| node_token_exchange
node_token_exchange -->|"exchanges token"| node_auth0
node_shield -->|"dispatches requests"| node_google
node_shield -->|"dispatches requests"| node_github
node_shield -->|"dispatches requests"| node_social
node_shield -->|"dispatches requests"| node_notion
node_shield -->|"dispatches requests"| node_autobooks
node_shield -->|"dispatches requests"| node_tavily
node_google -.->|"proxies API calls"| node_enterprise_services
node_github -.->|"proxies API calls"| node_enterprise_services
node_social -.->|"proxies API calls"| node_enterprise_services
node_notion -.->|"proxies API calls"| node_enterprise_services
node_autobooks -.->|"proxies API calls"| node_enterprise_services
node_tavily -->|"searches"| node_enterprise_services

click node_dashboard "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/app/page.tsx"
click node_auth_config "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/app/lib/auth0.ts"
click node_auth_proxy "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/proxy.ts"
click node_management "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/app/vault-management/page.tsx"
click node_help "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/app/help/page.jsx"
click node_openclaw "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/openclaw-workspace/openclaw.json"
click node_skills "https://github.com/nick-maximillien/openclaw-auth0-vault/tree/main/openclaw-workspace/workspace/skills"
click node_login_skill "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/openclaw-workspace/workspace/skills/cfo-login/index.ts"
click node_vault_api "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/main.go"
click node_session "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/main.go"
click node_shield "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/main.go"
click node_token_exchange "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/main.go"
click node_google "https://github.com/nick-maximillien/openclaw-auth0-vault/tree/main/vault-api/google"
click node_github "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/github/github.go"
click node_social "https://github.com/nick-maximillien/openclaw-auth0-vault/tree/main/vault-api/social"
click node_notion "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/notion/notion.go"
click node_autobooks "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/autobooks/autobooks.go"
click node_tavily "https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/tavily/search.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_auth_config,node_auth_proxy,node_management,node_help toneBlue
class node_vault_api,node_session,node_shield,node_token_exchange toneAmber
class node_google,node_github,node_social,node_notion,node_autobooks,node_tavily toneMint
class node_openclaw,node_skills,node_login_skill toneRose
class node_user,node_auth0,node_enterprise_services toneIndigo
```

## Components

### User Delegation

- [Vault Dashboard](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/app/page.tsx): `next-vault/src/app/page.tsx`
- [Auth0 Session](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/app/lib/auth0.ts): `next-vault/src/app/lib/auth0.ts`
- [Auth Routes](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/proxy.ts): `next-vault/src/proxy.ts`
- [Policy & Audit UI](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/app/vault-management/page.tsx): `next-vault/src/app/vault-management/page.tsx`
- [Help Guide](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/next-vault/src/app/help/page.jsx): `next-vault/src/app/help/page.jsx`

### Secure Gateway

- [HTTP Router](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/main.go): `vault-api/main.go`
- [Active Session](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/main.go): `vault-api/main.go`
- [Shield Middleware](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/main.go): `vault-api/main.go`
- [Token Exchange](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/main.go): `vault-api/main.go`

### Enterprise Integrations

- [Google Workspace](https://github.com/nick-maximillien/openclaw-auth0-vault/tree/main/vault-api/google): `vault-api/google`
- [GitHub API](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/github/github.go): `vault-api/github/github.go`
- [Social APIs](https://github.com/nick-maximillien/openclaw-auth0-vault/tree/main/vault-api/social): `vault-api/social`
- [Notion API](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/notion/notion.go): `vault-api/notion/notion.go`
- [Autobooks API](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/autobooks/autobooks.go): `vault-api/autobooks/autobooks.go`
- [Tavily Search](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/vault-api/tavily/search.go): `vault-api/tavily/search.go`

### Agent Runtime

- [OpenClaw Agent](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/openclaw-workspace/openclaw.json): `openclaw-workspace/openclaw.json`
- [Service Skills](https://github.com/nick-maximillien/openclaw-auth0-vault/tree/main/openclaw-workspace/workspace/skills): `openclaw-workspace/workspace/skills`
- [Login Skill](https://github.com/nick-maximillien/openclaw-auth0-vault/blob/main/openclaw-workspace/workspace/skills/cfo-login/index.ts): `openclaw-workspace/workspace/skills/cfo-login/index.ts`

### Other components

- **Principal**
- **Auth0**
- **External Services**

## Connections

- Principal → Vault Dashboard: authorizes (evidence: `README.md`)
- Vault Dashboard → Auth0 Session: loads session (evidence: `next-vault/src/app/page.tsx`)
- Auth Routes → Auth0 Session: mounts auth (evidence: `next-vault/src/proxy.ts`)
- Vault Dashboard → Auth0: exchanges tokens (evidence: `next-vault/src/app/page.tsx`)
- Vault Dashboard → HTTP Router: syncs subject token (evidence: `next-vault/src/app/page.tsx`)
- Policy & Audit UI → Principal: shows policies (evidence: `next-vault/src/app/vault-management/page.tsx`)
- Help Guide → Principal: explains operation (evidence: `next-vault/src/app/help/page.jsx`)
- OpenClaw Agent → Service Skills: uses skills (evidence: `README.md`)
- Service Skills → Login Skill: includes login (evidence: `openclaw-workspace/workspace/skills/cfo-login/index.ts`)
- OpenClaw Agent → HTTP Router: requests APIs (evidence: `README.md`)
- HTTP Router → Active Session: synchronizes token (evidence: `vault-api/main.go`)
- HTTP Router → Shield Middleware: routes protected calls (evidence: `vault-api/main.go`)
- Shield Middleware → Active Session: reads subject token (evidence: `vault-api/main.go`)
- Shield Middleware → Token Exchange: requests scoped token (evidence: `vault-api/main.go`)
- Token Exchange → Auth0: exchanges token (evidence: `vault-api/main.go`)
- Shield Middleware → Google Workspace: dispatches requests (evidence: `vault-api/main.go`)
- Shield Middleware → GitHub API: dispatches requests (evidence: `README.md`)
- Shield Middleware → Social APIs: dispatches requests (evidence: `vault-api/main.go`)
- Shield Middleware → Notion API: dispatches requests (evidence: `README.md`)
- Shield Middleware → Autobooks API: dispatches requests (evidence: `README.md`)
- Shield Middleware → Tavily Search: dispatches requests (evidence: `README.md`)
- Google Workspace → External Services: proxies API calls
- GitHub API → External Services: proxies API calls
- Social APIs → External Services: proxies API calls
- Notion API → External Services: proxies API calls
- Autobooks API → External Services: proxies API calls
- Tavily Search → External Services: searches (evidence: `vault-api/tavily/search.go`)
