smart_ide/docs/features/claw-harness-api.md
Nicolas Cantu ac96434351 docs: centralize README content under docs/repo/
**Motivations:**
- Single canonical documentation tree under docs/; reduce drift between README copies.

**Evolutions:**
- Add docs/repo/ with operational guides (cron, systemd, projects, logs, docv, ia_dev, services, scripts, extension).
- Replace scattered README.md files with pointers to docs/repo/*.md.
- Refresh docs/README.md index and cross-links across docs/, .cursor rules/agents.
- Bump ia_dev submodule to matching doc pointer commits.
2026-04-03 18:20:31 +02:00

2.2 KiB
Raw Blame History

Claw-code — harnais multi-modèles (services/claw-harness-api)

Objectif

Documenter et outiller lusage du dépôt claw-code (runtime type « harness » pour agents, outils, MCP selon les versions amont) dans le périmètre smart_ide, avec une politique sans Anthropic dans les gabarits fournis ici.

Sources amont

Le dépôt amont évolue (Rust / Python, binaires, serveur HTTP). Ce dépôt ne vend pas claw-code : seulement README, exemple de politique fournisseurs, et un proxy HTTP optionnel.

Fichiers locaux

Fichier / dossier Rôle
repo/service-claw-harness.md Clone, build résumé, variables du proxy
services/claw-harness-api/providers.example.yaml Exemple : Ollama activé ; Anthropic enabled: false
services/claw-harness-api/proxy/ Proxy 127.0.0.1 + Bearer → URL amont (CLAW_UPSTREAM_URL)

Anthropic

Les gabarits dans smart_ide nactivent pas Anthropic. Le bloc y figure explicitement avec enabled: false. Le contrôle daccès réseau (pas de résolution / pas de route vers api.anthropic.com) et labsence de secrets côté hôte complètent la politique si vous en avez besoin.

Intégration architecture

Positionnement par rapport à system-architecture.md : claw-code joue le rôle dexécution harnais (outils, session, éventuellement MCP) ; le proxy homogénéise laccès (token, bind local) pour un futur client type Lapce ou un gateway maison. Les agents métier ia_dev restent le noyau opératoire décrit ailleurs ; claw est un runtime optionnel à brancher explicitement.

Limites

  • Projet tiers ; licence et stabilité suivent lamont.
  • Le proxy relaye le trafic vers le serveur HTTP claw : il ne remplace pas la lecture des politiques de confidentialité des fournisseurs que vous activez (Ollama local vs API cloud).