Skill Coolify para OpenClaw

Visao Geral do Skill Coolify para OpenClaw

O skill Coolify conecta o OpenClaw a sua instancia Coolify por meio de sua API REST. Uma vez instalado, seu agente OpenClaw pode implantar aplicacoes, gerenciar bancos de dados, configurar variaveis de ambiente e monitorar servicos — tudo por meio de comandos em portugues simples.

O Coolify e uma alternativa open-source e auto-hospedavel ao Vercel, Heroku e Netlify. Ele permite implantar sites estaticos, aplicacoes full-stack, bancos de dados e mais de 280 servicos com um clique em seus proprios servidores. Com o skill Coolify do OpenClaw, voce tem a conveniencia de plataformas gerenciadas mantendo controle total sobre sua infraestrutura e dados.

Fluxo de trabalho tipico:

1. Peca ao OpenClaw para implantar suas ultimas alteracoes no servidor de staging.
2. O agente chama a API do Coolify para acionar uma implantacao no seu projeto vinculado.
3. O status do build e os logs sao retornados em um resumo legivel — sem necessidade de abrir o painel do Coolify.

Pre-requisitos para o Skill Coolify

Antes de instalar o skill Coolify, certifique-se de que voce tem:

• OpenClaw instalado e em execucao (v1.0+)
• Uma instancia Coolify rodando em seu servidor — guia de instalacao
• Token de API do Coolify gerado a partir do painel do Coolify
• Pelo menos uma aplicacao ou servico configurado no Coolify
• clawhub CLI instalada para gerenciamento de skills

Verifique sua configuracao:

# Verificar a versao do OpenClaw
openclaw --version

# Verificar se o Coolify esta acessivel (substitua pela URL da sua instancia)
curl -s https://your-coolify-instance.com/api/v1/healthcheck

# Verificar a clawhub CLI
clawhub --version

Como Instalar o Skill Coolify

Instale o skill Coolify com um unico comando:

npx clawhub@latest install coolify

Para verificar a instalacao:

clawhub list

Voce devera ver coolify na lista de skills instalados. O skill solicitara o endpoint da API do Coolify e o token no primeiro uso.

Configuracao do Skill Coolify

O skill Coolify requer um token de API e a URL da sua instancia. Gere um token no painel do Coolify em Settings → API Tokens.

Permissoes do Token

Os tokens de API do Coolify fornecem acesso completo a sua instancia. Siga o principio do menor privilegio:

| Caso de Uso | Recomendacao | |-------------|--------------| | Monitoramento somente leitura | Crie um token em uma conta de membro da equipe com funcao de visualizador | | Implantacao completa | Use um token de administrador, mas revise todas as acoes antes de confirmar | | Multi-servidor | Crie tokens separados por servidor para isolamento |

Configuracao de Ambiente

# Definir a URL da sua instancia Coolify
export COOLIFY_BASE_URL=https://your-coolify-instance.com

# Definir seu token de API do Coolify
export COOLIFY_TOKEN=your_api_token_here

Importante: Nunca insira tokens diretamente em arquivos de configuracao. Use variaveis de ambiente ou um gerenciador de segredos como 1Password ou Bitwarden. Mantenha sua instancia Coolify atualizada com a versao mais recente para correcoes de seguranca.

Verificando a Conexao

Apos definir as variaveis de ambiente, verifique a conexao:

# Testar acesso a API
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

Exemplos de Uso do Skill Coolify

1. Implantar uma Aplicacao

Voce: "Implante a versao mais recente do meu aplicativo web no Coolify."

O agente identifica sua aplicacao pelo nome, aciona uma implantacao via API do Coolify e transmite o status do build. Voce recebe um resumo com a URL de implantacao e a duracao do build.

2. Gerenciar Variaveis de Ambiente

Voce: "Adicione DATABASE_URL ao ambiente de staging do meu servico de API."

O agente chama a API do Coolify para criar a variavel de ambiente na aplicacao especificada. Voce tambem pode pedir para listar, atualizar ou atualizar variaveis em massa entre ambientes. O skill garante que valores sensiveis sejam mascarados na saida.

3. Visualizar Logs da Aplicacao

Voce: "Mostre as ultimas 100 linhas de logs do servico de pagamentos."

O agente busca os logs do container via API do Coolify e os apresenta em um formato legivel. Ele tambem pode destacar erros e sugerir correcoes com base em padroes comuns.

4. Reiniciar um Servico

Voce: "Reinicie o banco de dados PostgreSQL no meu servidor de producao."

O agente envia um comando de reinicializacao para o servico especificado. O OpenClaw solicita confirmacao antes de executar qualquer operacao de reinicializacao ou parada em servicos de producao.

5. Verificar Uso de Recursos

Voce: "Quanto de CPU e memoria meu servidor de staging esta usando?"

O agente consulta a API do Coolify para obter metricas do servidor e apresenta um resumo de uso de CPU, memoria e disco. Ele pode alertar voce se algum recurso estiver se aproximando do seu limite.

Seguranca e Boas Praticas

O skill Coolify pode realizar operacoes de escrita em seus servidores e aplicacoes. Siga estas diretrizes para se manter seguro:

• Use o minimo de privilegios. Crie tokens de API dedicados com permissoes minimas. Evite usar seu token principal de administrador para operacoes automatizadas.
• Revise antes de implantar em producao. Sempre teste implantacoes no staging primeiro. O OpenClaw solicita confirmacao antes de implantacoes em producao.
• Mantenha o Coolify atualizado. Atualize regularmente sua instancia Coolify para obter as correcoes de seguranca mais recentes — execute a atualizacao pelo painel do Coolify ou use o guia oficial de atualizacao.
• Proteja sua instancia. Coloque o Coolify atras de um firewall ou VPN. Use senhas fortes e habilite a autenticacao de dois fatores.
• Alterne os tokens de API. Regenere tokens periodicamente e revogue os nao utilizados pelo painel.
• Faca backups regularmente. Use o recurso de backup S3 integrado do Coolify para proteger sua configuracao e dados de banco de dados.

Solucao de Erros Comuns

"Connection refused" ou "ECONNREFUSED"

O skill nao consegue alcancar sua instancia Coolify.

1. Verifique se COOLIFY_BASE_URL esta correto e inclui o protocolo (https://).
2. Confirme que sua instancia Coolify esta em execucao: systemctl status coolify no seu servidor.
3. Certifique-se de que seu firewall permite trafego na porta do Coolify (padrao: 8000).
4. Se estiver usando uma VPN ou Tailscale, confirme que o tunel esta ativo.

"Unauthorized" ou "401 Error"

Seu token de API esta invalido ou expirado.

1. Verifique seu token em Coolify Dashboard → Settings → API Tokens.
2. Regenere o token se ele foi revogado.
3. Confirme que a variavel de ambiente COOLIFY_TOKEN esta definida corretamente.

# Verificar se o token esta definido
echo $COOLIFY_TOKEN

# Testar autenticacao
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

"Application not found"

O skill nao consegue encontrar a aplicacao que voce referenciou.

1. Liste todas as aplicacoes: peca ao OpenClaw "Liste todas as minhas aplicacoes Coolify."
2. Verifique se o nome ou UUID da aplicacao corresponde ao que esta no painel do Coolify.
3. Certifique-se de que seu token de API tem acesso a equipe que possui a aplicacao.