clawapi

# ClawAPI — Model Switcher & Key Vault for OpenClaw

ClawAPI is a native macOS app that lets you switch AI models and manage API keys for OpenClaw.

## What It Does

- **One-click model switching** — Pick any model from any provider and apply it instantly
- **Touch ID** — Biometric authentication for adding and deleting API keys
- **16 providers** — OpenAI, Anthropic, xAI, Google, Groq, Mistral, OpenRouter, Cerebras, Kimi, MiniMax, Z.AI, OpenCode Zen, Vercel AI, HuggingFace, Ollama, LM Studio
- **Config safety** — JSON validation before writing, automatic `.bak` backups

## Installation

### Option 1: Download from GitHub Releases (recommended)

Download the latest signed and notarized `.zip` from [GitHub Releases](https://github.com/Gogo6969/clawapi/releases), unzip, and move `ClawAPI.app` to `/Applications`.

### Option 2: Install script

```bash
curl -fsSL https://raw.githubusercontent.com/Gogo6969/clawapi/main/install.sh | bash
```

The install script downloads the same signed `.zip` from GitHub Releases, verifies the SHA-256 checksum, unzips it, and moves the app to `/Applications`. You can [review the script source](https://github.com/Gogo6969/clawapi/blob/main/install.sh) before running it.

Requires macOS 14+. The app is signed with an Apple Developer ID and notarized by Apple.

## How It Works

1. **Add a provider** — Click `+`, pick a provider, paste your API key
2. **Pick a model** — Use the dropdown to choose a sub-model (GPT-4.1, Claude Sonnet 4, Grok 4, etc.)
3. **Done** — ClawAPI syncs everything to OpenClaw automatically

## Where API Keys Are Stored

API keys are managed in **two places** by design:

1. **macOS Keychain (master copy)** — The key you enter is stored in the macOS Keychain, protected by hardware encryption and Touch ID. This is the authoritative copy.
2. **`auth-profiles.json` (sync copy for OpenClaw)** — OpenClaw reads API keys from its own `auth-profiles.json` config file. ClawAPI writes a copy of the key there so OpenClaw can use it...

# ClawAPI — OpenClaw Skill

**Model Switcher & Key Manager for OpenClaw**

A native macOS app that lets you switch AI models and manage API keys for OpenClaw. Supports 16 providers including OpenAI, Anthropic, xAI, Google, Groq, Ollama, LM Studio, and more.

## Install

**Option 1 — Download from GitHub Releases (recommended):**
Download the latest `.zip` from [GitHub Releases](https://github.com/Gogo6969/clawapi/releases), unzip, and move `ClawAPI.app` to `/Applications`.

**Option 2 — Install script:**
```bash
curl -fsSL https://raw.githubusercontent.com/Gogo6969/clawapi/main/install.sh | bash
```
The script downloads the signed `.zip` from GitHub Releases, verifies the SHA-256 checksum, and installs the app. [Review the script source](https://github.com/Gogo6969/clawapi/blob/main/install.sh) before running.

## Features

- One-click model switching across 16 providers
- Touch ID authentication for adding/deleting keys (password fallback without Touch ID)
- API keys stored in macOS Keychain (master copy) with a sync copy written to OpenClaw's `auth-profiles.json`
- JSON validation and `.bak` backups for config safety
- Apple Developer ID signed and notarized by Apple

## Security & Privacy

- API keys are stored in the macOS Keychain with hardware encryption; a sync copy is written to `auth-profiles.json` so OpenClaw can read them
- Touch ID / password authentication for sensitive operations
- No telemetry, no analytics, no data leaves your machine
- Only network requests: update check (GitHub) and local model discovery (Ollama/LM Studio)

## Links

- [GitHub](https://github.com/Gogo6969/clawapi)
- [Wiki](https://github.com/Gogo6969/clawapi/wiki)
- [User Guide](https://github.com/Gogo6969/clawapi/blob/main/docs/USER_GUIDE.md)

## License

MIT