360 Secure SkillHub
360 安全技能中心

Workspace Guardian

面向 OpenClaw 工作区的自愈型技能:在启动和心跳时创建并检查 MEMORY.md、memory 目录与权限,校验 openclaw.json 的 URL、apiKey 和模型配置,并针对常见 LLM 错误执行重试或修复,同时提供健康检查与错误参考。

elontools
elontools
热度 53.34
最近更新 2026-05-11 17:34:06
分类:自动化依赖:代码执行 / 读写文件 / 第三方 API应用场景:自动化脚本 / 工作流 / DevOps

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add workspace-guardian
Metadata
name
workspace-guardian
description
Auto-healing e proteção para workspaces OpenClaw. Valida e corrige problemas comuns automaticamente no startup e durante a execução. Usar quando: (1) Workspace novo precisa de setup inicial (criar MEMORY.md, memory/, etc), (2) Agente falha com erros de LLM (retry/fallback automático), (3) Arquivos essenciais corrompidos ou ausentes, (4) Config openclaw.json precisa de validação, (5) Health check periódico do agente. Instalar em todo workspace OpenClaw para garantir estabilidade e reduzir churn de clientes.

Workspace Guardian

Skill de auto-healing para workspaces OpenClaw. Garante que o workspace está saudável e funcional.

Quando rodar

Esta skill é executada automaticamente:

  1. No startup — via HEARTBEAT.md (primeira execução)
  2. Periodicamente — a cada heartbeat, validação leve
  3. Sob demanda — quando o agente detecta erros recorrentes

Startup: Validação e Setup

No primeiro heartbeat após iniciar, executar o script de validação:

bash scripts/guardian-startup.sh

O script valida e corrige:

  • ✅ MEMORY.md existe (cria vazio se não)
  • ✅ memory/ diretório existe
  • ✅ memory/topics/ diretório existe
  • ✅ Permissões corretas nos arquivos
  • ✅ openclaw.json válido (JSON parseable)

Tratamento de Erros LLM

Quando receber erros do tipo:

  • "Only HTTPS URLs are supported" → Verificar e corrigir URLs no config
  • "Edit failed" → Arquivo não existe, criar primeiro com Write
  • "LLM request rejected" → Verificar apiKey e baseUrl no openclaw.json
  • timeout → Retry com backoff exponencial

Procedimento de auto-fix:

  1. Ler openclaw.json
  2. Validar que todas as URLs usam HTTPS
  3. Validar que apiKey está presente e não vazia
  4. Se encontrar problema: corrigir e reiniciar gateway

Validação de Config

Verificar no openclaw.json:

  • models.providers.*.baseUrl → deve começar com https://
  • models.providers.*.apiKey → deve existir e não estar vazia
  • models.providers.*.api → deve ser openai-completions ou anthropic
  • agents.list → deve ter pelo menos 1 agente

Referências

  • Ver references/common-errors.md para lista de erros conhecidos e soluções
  • Ver references/health-checks.md para detalhes dos health checks