Um kit de ferramentas de diagnóstico especializado para validar a compatibilidade do protocolo API LLM, detecção do primeiro token e drift de desempenho para agentes de codificação.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install api-quality-check
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o api-quality-check usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é API Quality Check?
O API Quality Check é um utilitário focado em scripts projetado para garantir que os modelos de IA para codificação e seus respectivos endpoints de API atendam aos requisitos técnicos para fluxos de trabalho agênticos avançados. Ele se concentra especificamente na verificação da detecção do primeiro token, rastreamento de logprob e verificações de drift base-vs-atual usando as metodologias LT-lite e B3IT-lite. Ao incorporar essas Openclaw Skills em seu pipeline, você pode determinar programaticamente se um provedor OpenAI, Anthropic ou OpenAI-Compatible é adequado para tarefas de codificação headless.
A ferramenta aborda o problema comum de volatilidade do modelo e incompatibilidades de protocolo ocultas. Ela permite que os desenvolvedores façam testes de fumaça (smoke tests) em endpoints como DeepSeek, SiliconFlow, Kimi e Ark para verificar o ajuste de capacidade antes de implantar agentes que dependem de controle preciso no nível de token ou configurações específicas de header.
Casos de uso do API Quality Check
- Validar se um novo provedor de LLM suporta logprobs necessários para detecção LT-lite.
- Executar testes de fumaça automatizados diários para detectar drift de desempenho em modelos de codificação em produção.
- Normalizar várias configurações de provedores de API em um formato JSON padrão para portabilidade do agente.
- Testar a latência de resposta do primeiro token e a capacidade em vários endpoints OpenAI-Compatible.
Como o API Quality Check funciona
- Inicialize um arquivo de configuração do provedor que normaliza a raiz da API e os headers de autenticação.
- Execute um teste de fumaça de capacidade para identificar se o endpoint suporta logprobs ou texto do primeiro token em limites mínimos de token.
- Com base nos resultados do teste de fumaça, o sistema recomenda um detector específico (LT-lite ou B3IT-lite).
- Gere uma linha de base de desempenho para o modelo para capturar seu perfil de comportamento atual.
- Execute tarefas de detecção periódicas para comparar o desempenho da API ao vivo com a linha de base salva para identificar drift.
- Exporte os resultados como JSON estruturado para consumo de CLI ou HTML legível por humanos para relatórios visuais.
Configuração do API Quality Check
Configure as variáveis de ambiente para os scripts principais dentro do seu diretório Openclaw Skills:
export CODEX_HOME="${CODEX_HOME:-$HOME\/.codex}"
export APIQ="$CODEX_HOME\/skills\/api-quality-check\/scripts\/api_quality_check.py"
Inicialize uma configuração para um provedor específico:
python "$APIQ" init-config \
--provider "OpenAI-Compatible" \
--base-url "https:\/\/api.your-provider.com\/v1" \
--api-key "$API_KEY" \
--model-id "model-name" \
--config-output .\/provider.json
Execute um teste de fumaça para verificar as capacidades:
python "$APIQ" smoke --config .\/provider.json --html-output .\/smoke.html
Esquema de Dados e Taxonomia de API Quality Check
A habilidade gerencia dados usando uma abordagem baseada em arquivos para garantir a compatibilidade com agentes de terminal e fluxos de trabalho Openclaw Skills:
| Componente de Dados | Formato | Descrição |
|---|---|---|
| Provider Config | JSON | Armazena URL base, ID do modelo e headers personalizados como User-Agent ou Extra-Body. |
| Capability Report | JSON/HTML | Resultado de testes de fumaça indicando flags lt_supported e b3it_supported. |
| Baseline Manifest | JSON | Um snapshot do comportamento do modelo usado para futuras comparações de drift. |
| Detection Report | JSON | Métricas detalhadas sobre estabilidade, contagem de tokens e probabilidade de drift. |
Recursos avançados do API Quality Check
- Lote de Multi-Provedores: Execute verificações de capacidade em uma lista inteira de provedores usando um único comando shell.
- Mitigação de Auto-Raciocínio: Detecta e desativa automaticamente blocos de thinking/reasoning para provedores como GLM ou Zhipu para garantir uma saída limpa.
- Normalização de Protocolo: Manipulação inteligente de URL que converte caminhos de conclusão completos de volta para raízes de API automaticamente.
- Monitoramento de Drift Agendado: Inclui um script wrapper diário dedicado para verificações de integridade automatizadas e arquivamento de relatórios baseados em data.
- Suporte a Header Personalizado: Passe headers JSON complexos para endpoints especializados como os caminhos de API específicos de codificação do Kimi.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
DOCX Document Master
Um conjunto de ferramentas de nível profissional para criar, editar e analisar programaticamente documentos Microsoft Word com formatação de alta fidelidade.
Habilidade App Ads
Um guia completo para executar campanhas de instalação de aplicativos móveis de alto desempenho e estratégias de aquisição de usuários nas principais plataformas de anúncios.
Integração Claude API & Agent SDK
Um framework de desenvolvimento abrangente para construir aplicações baseadas em LLM usando a Anthropic Claude API e o Agent SDK especializado.
Find Skills
Uma ferramenta de descoberta especializada para listar e pesquisar todas as capacidades de AI agent instaladas em um workspace.
Invoice Chaser
Uma ferramenta profissional de automação de cobrança que gera e-mails de lembrete de pagamento escalonados, adaptados a verticais de negócios específicas e dias de atraso.
WeryAI Video Subtitle Erase
Uma ferramenta de AI especializada projetada para identificar e apagar legendas embutidas ou texto na tela de URLs de vídeo públicas via API WeryAI.
Apresentou*
