# claw-harness-api (`services/claw-harness-api/`)

Notes d’intégration et **proxy HTTP mince** pour un harnais **claw** (agent terminal, binaire `claw`).

## Amont Rust (sous-module optionnel)

Un clone **shallow** du dépôt **[chinanpc/claude-code-rust](https://github.com/chinanpc/claude-code-rust)** est disponible sous **`services/claw-harness-api/upstream`** (sous-module Git, licence **MIT** selon le dépôt amont). Après `git clone` du monorepo : `git submodule update --init services/claw-harness-api/upstream`. Builder et lancer le binaire selon le `README` amont (workspace Rust, `cargo build --release`, etc.).

## Autres références claw (hors sous-module)

- [gitlawb — claw-code](https://gitlawb.com/node/repos/z6Mks1jg/claw-code)
- [instructkr/claw-code](https://github.com/instructkr/claw-code) (accès réseau selon visibilité du dépôt)

Le proxy **`proxy/`** du monorepo n’embarque pas le runtime : il attend une URL **`CLAW_UPSTREAM_URL`** vers un serveur HTTP claw déjà démarré.

## Politique : pas d’Anthropic dans les gabarits

**`providers.example.yaml`** : Ollama et placeholders OpenAI-compatibles / Gemini ; **Anthropic `enabled: false`**. L’application opérationnelle (pare-feu, absence de clé) reste de votre ressort.

## Proxy (`proxy/`)

| Variable | Obligatoire | Description |
|----------|-------------|-------------|
| `CLAW_PROXY_TOKEN` | oui | Bearer côté client du proxy. |
| `CLAW_PROXY_HOST` | non | Défaut `127.0.0.1` |
| `CLAW_PROXY_PORT` | non | Défaut `37142` |
| `CLAW_UPSTREAM_URL` | oui | URL du serveur HTTP claw |

```bash
cd services/claw-harness-api/proxy
npm install
npm run build
export CLAW_PROXY_TOKEN='…'
export CLAW_UPSTREAM_URL='http://127.0.0.1:37143'
npm start
```

## Spécification smart_ide

[API/claw-harness-proxy.md](../API/claw-harness-proxy.md), [features/claw-harness-api.md](../features/claw-harness-api.md).