Agentes de IA

OpenClaw

Um agente pessoal de código aberto que é executado no seu próprio computador e responde nas suas aplicações de chat.

Liga-se com: Iniciar sessão, Chave de API e Skill
Conector: SPREVA
Planos: Gratuito e de código aberto. Usa o seu próprio fornecedor de modelos.

Antes de começar

O OpenClaw instalado, com o respetivo gateway em execução.
Uma chave de API, criada no SPREVA em Desenvolvimento, depois Chaves de API.

Configurar

1
Coloque a sua chave de API do SPREVA no ambiente do seu terminal:
Terminal
```
export SPREVA_API_KEY=POST_API_KEY_...
```
2
Adicione o SPREVA. Mantenha --transport streamable-http: sem isso, o OpenClaw usa o transporte SSE, mais antigo, ao qual o SPREVA não responde. O OpenClaw verifica a ligação antes de guardar o SPREVA.
Terminal
```
openclaw mcp add spreva \
  --url https://dev-app.spreva.ai/api/mcp \
  --transport streamable-http \
  --header "Authorization=Bearer $SPREVA_API_KEY"
```
3
Confirme que o OpenClaw chega ao SPREVA:
Terminal
```
openclaw mcp doctor spreva --probe
```

Também funciona com

URL do conector e início de sessão
Cole o URL do conector na aplicação, inicie sessão no SPREVA e clique em Permitir. Não há nenhuma chave para guardar em segurança.
Terminal
```
openclaw mcp add spreva \
  --url https://dev-app.spreva.ai/api/mcp \
  --transport streamable-http --auth oauth
openclaw mcp login spreva
```
A CLI e a Agent Skill
Instale a linha de comandos spreva e a respetiva Agent Skill, para agentes que trabalham num terminal.
Terminal
```
export SPREVA_API_KEY=POST_API_KEY_...
npx -y @spreva/cli skill install --target openclaw
```

Confirmar que funciona

Inicie uma nova conversa e pergunte:

Peça ao seu agente

O que vai ser publicado esta semana no SPREVA?

OpenClaw chama a ferramenta overview do SPREVA e responde com o fuso horário da área de trabalho, o que sai a seguir e o que precisa de atenção. Da primeira vez, OpenClaw pode pedir-lhe que permita a ferramenta.

Resolução de problemas

O OpenClaw não consegue ligar-se ao SPREVA

Execute openclaw mcp status --verbose. Se o transporte do SPREVA for sse, remova-o com openclaw mcp unset spreva e adicione-o novamente com --transport streamable-http.

O OpenClaw pede-me que inicie sessão, apesar de ter adicionado uma chave

Com --auth oauth, o OpenClaw inicia sessão e ignora o cabeçalho Authorization. Use uma coisa ou a outra: remova o SPREVA e adicione-o novamente da forma que pretende.

A Agent Skill diz que falta a chave de API

Os comandos que o OpenClaw executa leem SPREVA_API_KEY do ambiente do gateway. Defina-a aí e reinicie o gateway.

Outro problema? A Resolução de problemas aborda pedidos de início de sessão repetidos, planos, limites e fusos horários.