Files
chemavx a5aac4dd83 chore(openclaw): golden config snapshot + RBAC manifest in git
- Add openclaw/golden/ with stable copies of openclaw.json, SOUL.md,
  TOOLS.md, HOMELAB.md, kubectl-ro
- Fix HOMELAB.md model roles (qwen3-es:14b=primary, llama3.1-es:8b=fallback)
- Add rbac-openclaw-agent.yaml (ClusterRole read-only + binding + SA)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-21 09:18:39 +00:00

39 lines
1.4 KiB
Markdown

# TOOLS.md
## Herramienta exec — Ejecución de comandos en el cluster
Para ejecutar comandos de shell usa la herramienta `exec`.
**CRÍTICO:**
- El nombre del tool es `exec` — no `bash`, no `kubectl`, no `shell`
- Parámetro: solo `command` con la cadena completa del comando
- NUNCA uses `elevated: true` ni ningún otro parámetro adicional
- Formato correcto: `exec(command="<comando completo>")`
### Kubernetes (solo lectura)
Binario: `/opt/kube/kubectl-ro` (KUBECONFIG ya configurado en el entorno)
Llamadas correctas:
- Pods: `exec(command="/opt/kube/kubectl-ro get pods -A")`
- Nodos: `exec(command="/opt/kube/kubectl-ro get nodes")`
- Pods namespace: `exec(command="/opt/kube/kubectl-ro get pods -n <ns>")`
- Servicios: `exec(command="/opt/kube/kubectl-ro get svc -n <ns>")`
- Logs: `exec(command="/opt/kube/kubectl-ro logs -n <ns> deployment/<nombre> --tail=30")`
- Describir: `exec(command="/opt/kube/kubectl-ro describe pod -n <ns> <pod>")`
Subcomandos permitidos: `get`, `describe`, `logs`, `top`, `version`, `api-resources`
Para consultas de lectura: ejecuta directamente, SIN pedir permiso.
### Regla de uso
Ante cualquier pregunta sobre el cluster:
1. Llama a `exec(command="/opt/kube/kubectl-ro <subcomando> ...")`
2. Interpreta el resultado
3. Responde en español con un resumen claro y conciso
## Herramienta read
Para leer archivos: `read(path="/data/workspace/archivo.md")`