` | Pour chaque exécution d'outil | `gen_ai.tool.name`, `gen_ai.tool.call.id` |
## Référence de configuration
Cette section présente la référence de configuration complète de l’entrée du plugin `weave` dans `openclaw.json`.
Le champ `apiKey` prend en charge quatre sources d’authentification, résolues dans cet ordre :
1. Un objet `SecretRef` avec `source: "env"` ou `source: "file"` (voir la ligne 10 dans l’exemple suivant).
2. Une chaîne littérale `apiKey` (prise en charge, mais non recommandée).
3. La variable d’environnement `WANDB_API_KEY`.
4. Une entrée `~/.netrc` pour l’hôte Weave, renseignée par `wandb login`.
```json lines theme={null}
{
plugins: {
entries: {
weave: {
enabled: true,
config: {
entity: "YOUR-TEAM",
project: "YOUR-PROJECT",
// Reads WANDB_API_KEY from env if apiKey is omitted.
// SecretRef supports source: "env" or "file":
// { source: "env", provider: "default", id: "WANDB_API_KEY" }
// { source: "file", provider: "default", id: "/run/secrets/wandb" }
// Plain string is supported but discouraged.
apiKey: { source: "env", provider: "default", id: "WANDB_API_KEY" },
serviceName: "openclaw-agent",
// Optional, improves Agents tab grouping.
agentName: "my-agent",
agentVersion: "v1.0",
agentDescription: "What my agent does.",
// ON by default. Set to false for a hard off (compliance or
// retention policy). The plugin does not redact captured
// strings; scrub upstream if needed.
captureContent: true,
flushIntervalMs: 1000,
},
hooks: { allowConversationAccess: true },
},
},
},
}
```
`captureContent` est défini sur `true` par défaut. Lorsque `captureContent` est `true`, le plugin émet également les messages d’entrée et de sortie, les arguments des outils et les résultats des outils selon le format de charge utile `gen_ai.input.messages` et `gen_ai.output.messages`. Le plugin consigne les sous-agents, les événements de compactage, la détection de boucle, les tentatives de réessai et le dimensionnement du contexte sous forme d’attributs supplémentaires et d’événements de span.
Définissez `captureContent` sur `false` pour désactiver la capture afin de respecter les politiques de conformité ou de conservation.
### Cloud dédié de W\&B ou instances auto-hébergées
Le plugin délègue le point de terminaison et l'authentification au [SDK Node de Weave](https://github.com/wandb/weave/tree/master/sdks/node). Il lit les variables d'environnement suivantes selon les mêmes conventions que les SDK Python et Node de Weave :
| Variable | Description |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `WANDB_BASE_URL` | URL de base de l'API W\&B. Par défaut : `https://api.wandb.ai`. Définissez cette variable pour les installations en Cloud dédié ou auto-hébergées. |
| `WF_TRACE_SERVER_URL` | Remplacement complet de l'URL du serveur de traces. À utiliser pour les configurations autogérées ou derrière un proxy. |
## Dépannage
Si les traces n’atteignent pas Weave ou si les champs de contenu sont vides, utilisez les sections suivantes pour diagnostiquer les causes les plus fréquentes.
Le journal de la passerelle correspond à la sortie du terminal du processus qui exécute `openclaw`, ou au flux de logs de votre gestionnaire de processus si vous l'avez lancé en tant que démon.
### Le plugin est chargé, mais aucun span ne s’affiche
1. Exécutez `/weave status`. Si le cycle de vie est `disabled`, `config-error` ou `not-started`, le plugin ne s’est pas activé. Vérifiez le journal de la passerelle pour y trouver `weave: config.entity is required`, `weave: configuration error` ou `[weave] incompatible plugin SDK`.
2. Vérifiez que vous n’avez pas défini `diagnostics.enabled: false` dans la configuration de la passerelle. Ce champ doit être défini sur `true`.
3. Vérifiez que l’entité et le projet correspondent au slug de l’URL du projet Weave que vous inspectez. `/weave status` doit afficher `project=[YOUR-TEAM]/[YOUR-PROJECT]`.
4. Vérifiez la source d’authentification. `/weave status` doit afficher `auth=...`. Si `WANDB_API_KEY env` s’affiche alors que vous avez défini la clé dans une autre variable d’environnement, le plugin lit la mauvaise clé.
### Les spans arrivent, mais le texte d’entrée et de sortie est vide
Recherchez dans le journal de la passerelle :
```text theme={null}
[plugins] typed hook "llm_input" blocked because non-bundled plugins must set
plugins.entries.weave.hooks.allowConversationAccess=true
[plugins] typed hook "llm_output" blocked ...
[plugins] typed hook "agent_end" blocked ...
```
OpenClaw soumet les hooks qui donnent accès au contenu à une activation explicite par l’opérateur. Définissez `plugins.entries.weave.hooks.allowConversationAccess: true` dans votre configuration, puis redémarrez la passerelle. La structure des spans ainsi que les données de coût et d’utilisation transitent via des événements de diagnostic, et non via des hooks ; elles continuent donc de fonctionner même lorsque `allowConversationAccess` est défini sur `false`.
### Erreurs lors de l'envoi de traces vers Weave
Si le plugin est actif et génère des spans, mais qu'ils n'apparaissent pas dans Weave, consultez le journal de la passerelle pour repérer une erreur d'exportation et comparez-la au tableau suivant.
| Symptôme | Cause la plus probable | Correctif |
| ----------------------------------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `401` ou `403` depuis `trace.wandb.ai` | Clé API non valide ou à portée limitée | Vérifiez que la clé est toujours valide et que l'équipe possède l'entité et le project. `wandb login` actualise `~/.netrc`. |
| `404` depuis le point de terminaison des agents | URL de base ou URL du serveur de traces incorrecte | Pour les installations dédiées, définissez `WANDB_BASE_URL` sur l'hôte de votre installation. Pour un déploiement autogéré ou derrière un proxy, définissez `WF_TRACE_SERVER_URL` sur l'URL du serveur de traces. |
| Connexion refusée ou erreur DNS | DNS, proxy ou pare-feu | Vérifiez que l'hôte de la passerelle peut joindre `trace.wandb.ai` (cloud) ou l'hôte de votre installation (dédiée) sur le port `443`. |