Quick Test

Overview / Visão Geral

Simple system test to verify OpenClaw environment. Run basic commands and validate output.

Teste de sistema simples para verificar o ambiente do OpenClaw. Rode comandos básicos e valide a saída.

Quick Start / Início Rápido

# Run all tests
python3 scripts/run_tests.py

# Run specific test
python3 scripts/run_tests.py --test date
python3 scripts/run_tests.py --test files

# Test with custom command
python3 scripts/run_tests.py --command "echo 'Hello World'"

Installation / Instalação

Clone this repository / Clone este repositório:

git clone https://github.com/GustavoZiaugra/quick-test-skill.git
cd quick-test-skill

No dependencies required / Sem dependências necessárias
Uses only Python standard library
Não requer dependências externas

Usage / Uso

Run All Tests / Rodar Todos os Testes

python3 scripts/run_tests.py

This will: - Check Python availability - Verify current working directory - Test file system access - Run system commands - Validate all outputs

Isso irá: - Verificar disponibilidade do Python - Confirmar diretório de trabalho atual - Testar acesso ao sistema de arquivos - Rodar comandos do sistema - Validar todas as saídas

Run Specific Test / Rodar Test Específico

# Test date functionality
python3 scripts/run_tests.py --test date

# Test file system
python3 scripts/run_tests.py --test files

# Run custom command
python3 scripts/run_tests.py --command "pwd"

Parameters / Parâmetros

Parameter	Description	Descrição	Default
`--test`	Specific test to run / Teste específico para rodar	all	`--test date`
`--command`	Custom command to execute / Comando customizado para executar	none	`--command "ls -la"`
`--quiet`	Suppress output / Suprimir saída	false	`--quiet`

Output Format / Formato de Saída

✅ Quick Test Results

System Status: OK
Python: 3.12.7
Working Directory: /home/zig/.openclaw/workspace

Tests Run: 3/3 Passed
[✓] Python test
[✓] Date test
[✓] File system test

All tests passed successfully!

Features / Funcionalidades

✅ Python Availability Check / Verificação de Disponibilidade do Python - Confirms Python 3.x installed
✅ System Command Execution / Execução de Comando do Sistema - Runs and validates system commands
✅ File System Access / Acesso ao Sistema de Arquivos - Verifies directory access and permissions
✅ Custom Command Support / Suporte a Comandos Customizados - Run any command with validation
✅ Working Directory Check / Verificação de Diretório de Trabalho - Confirms current location
📝 Detailed Logging / Log Detalhado - Comprehensive output for debugging

How It Works / Como Funciona

System Check / Verificação de Sistema - Verifies Python and OS environment
Directory Check / Verificação de Diretório - Validates working directory permissions
Test Execution / Execução do Teste - Runs requested tests
Validation / Validação - Checks outputs and returns
Reporting / Relatório - Formats clear success/failure messages

Use Cases / Casos de Uso

System Verification / Verificação do Sistema

Confirm OpenClaw is running correctly:

python3 scripts/run_tests.py --test date --test files --test command

Debugging Commands / Comandos de Debugging

Run specific system commands:

python3 scripts/run_tests.py --command "pwd"
python3 scripts/run_tests.py --command "ls -la"
python3 scripts/run_tests.py --command "env | head -10"

Before/After Testing / Antes/Depois de Testar

Use Quick Test to verify system before/after:

# Before installing a skill
python3 scripts/run_tests.py

# After installing a skill
python3 scripts/run_tests.py

Examples / Exemplos

Basic Test / Teste Básico

# Check if everything works
python3 scripts/run_tests.py

Output:

✅ Quick Test - System Verification

Environment Check:
✓ Python 3.12.7
✓ Linux Ubuntu
✓ User: zig
✓ Working Directory: /home/zig/.openclaw/workspace

Tests:
[✓] Command: `pwd` → Passed
[✓] Command: `ls -la` → Passed
[✓] Command: `date` → Passed

All tests passed!

Custom Command / Comando Customizado

# Run a specific command
python3 scripts/run_tests.py --command "echo 'Custom test'"

Output:

Custom Command: echo 'Custom test'
Result: ✅ Passed
Output: Custom test

Testing Results / Resultados dos Testes

Success Indicators / Indicadores de Sucesso

✅ All tests passed - System is working correctly / Sistema funcionando corretamente
⚠️ Some tests failed - Minor issues detected / Problemas menores detectados
❌ Critical failures - System issues requiring attention / Problemas de sistema requerendo atenção

Common Test Failures / Falhas Comuns de Teste

Permission Denied: pwd or ls returns errors - Check user permissions / Verifique permissões do usuário - Verify directory access / Confirme acesso ao diretório

Command Not Found: Custom command not executable - Verify command exists / Verifique se o comando existe - Check PATH / Verifique o PATH

Directory Not Found: Working directory check fails - Verify path / Verifique o caminho - Check permissions / Verifique permissões

Scripts Included / Scripts Incluídos

scripts/run_tests.py

Main test runner script. Script principal de execução dos testes.

scripts/tests.py

Test suite with individual test functions. Suíte de testes com funções de testes individuais.

scripts/system_check.py

System validation functions. Funções de validação do sistema.

Philosophy / Filosofia

Keep It Simple / Mantenha Simples - Test core functionality only - Avoid complex dependencies / Evite dependências complexas - Clear, readable output / Saída clara e legível

Fast Feedback / Feedback Rápido - Show results immediately / Mostre resultados imediatamente - Pass/fail clear / Sucesso/Falha claro - No waiting or timeout / Sem espera ou timeout

Debugging Friendly / Amigável para Debugging - Detailed error messages / Mensagens de erro detalhadas - System information included / Informações do sistema incluídas - Suggest fixes / Sugere correções

Resources / Recursos

scripts/run_tests.py

Main runner script that executes all tests and formats results. Script principal que executa todos os testes e formata os resultados.

scripts/tests.py

Individual test functions for system verification. Funções de teste individuais para verificação do sistema.

scripts/system_check.py

System validation and environment check functions. Funções de validação e verificação de ambiente do sistema.

Dependencies / Dependências

None! / Nenhuma!

Uses only Python standard library (sys, os, subprocess, datetime, json, pathlib). Usa apenas biblioteca padrão do Python (sys, os, subprocess, datetime, json, pathlib).

Limitations / Limitações

User Permissions: Requires read and execute access to directories - Permissões do Usuário: Requer acesso de leitura e execução a diretórios - System commands must be in PATH / Comandos do sistema devem estar no PATH

System Differences: Behavior may vary by OS (Linux, macOS, Windows) - Diferenças do Sistema: Comportamento pode variar por sistema operacional (Linux, macOS, Windows)

Troubleshooting / Solução de Problemas

Tests Fail / Testes Falhando

If tests fail: 1. Check permissions / Verifique permissões - Ensure user has read/write access 2. Verify Python / Confirme Python - Test python3 --version 3. Check commands / Verifique comandos - Ensure basic commands exist 4. Review logs / Revise logs - Look for specific error messages

Command Not Executing / Comando Não Executando

If a custom command returns nothing or errors: 1. Verify command exists / Verifique se o comando existe - Use which or whereis 2. Test directly / Teste diretamente - Run command outside of this skill 3. Check PATH / Verifique o PATH - Ensure command is in system PATH

Python Not Found / Python Não Encontrado

If Python test fails: 1. Check Python version / Verifique versão do Python - Requires 3.7+ 2. Verify installation / Confirme instalação - Check which python3 3. Reinstall if needed / Reinstale se necessário - See Python documentation

License / Licença

MIT License - Use freely for personal and commercial purposes. Licença MIT - Use livremente para fins pessoais e comerciais.

Credits / Créditos

Created by Gustavo (GustavoZiaugra) with OpenClaw Criado por Gustavo (GustavoZiaugra) com OpenClaw

Simple system testing / Teste de sistema simples
Python environment verification / Verificação de ambiente Python
Command validation / Validação de comandos
Debug-friendly output / Saída amigável para debug

Find this and more OpenClaw skills at ClawHub.com Encontre este e mais habilidades do OpenClaw em ClawHub.com

⭐ Star this repository if you find it useful! ⭐ Dê uma estrela neste repositório se você achar útil!

✅ Simple, fast, no dependencies / Simples, rápido, sem dependências - Works everywhere, tests everything / Funciona em qualquer lugar, testa tudo / Test everywhere