Se esta a usar o OpenClaw e deseja estende-lo para alem do que as habilidades e o MCP podem oferecer, os plugins sao a opcao mais poderosa. Eis como funcionam.

A resposta curta

Um plugin do OpenClaw e um modulo de codigo TypeScript que e executado dentro do processo OpenClaw Gateway. Os plugins podem adicionar capacidades inteiramente novas a plataforma: canais de mensagens, ferramentas personalizadas, comandos CLI, servicos de fundo, fluxos de autenticacao e muito mais. Sao o mecanismo de extensao mais poderoso e complexo do OpenClaw.

Como os plugins diferem das habilidades e do MCP

O OpenClaw dispoe de tres mecanismos de extensao, cada um operando a um nivel diferente:

  • Habilidades sao ficheiros de instrucoes que ensinam o agente a executar tarefas. Apenas texto. Multiplataforma. Zero infraestrutura.
  • MCP conecta o agente a servicos externos atraves de um protocolo padrao. Processos de servidor que expoem ferramentas e dados.
  • Plugins estendem a propria plataforma OpenClaw com codigo. Executam no mesmo processo que o Gateway e podem alterar o funcionamento do OpenClaw a um nivel fundamental.

A analogia: as habilidades sao o manual de operacoes, o MCP e o conjunto de conectores e os plugins sao novos modulos de hardware que se instalam na maquina.

O que os plugins podem fazer

O alcance das capacidades dos plugins e amplo:

  • Canais de mensagens: adaptadores completos de entrada/saida. Matrix, Zalo e MS Teams estao todos implementados como plugins.
  • Ferramentas de agente: ferramentas personalizadas que aparecem no registo de ferramentas e podem ser chamadas pelos agentes.
  • Comandos CLI: novos comandos ou subcomandos para o CLI do OpenClaw.
  • Servicos de fundo: processos de longa duracao com gestao de ciclo de vida inicio/paragem.
  • Fluxos de autenticacao: OAuth, chaves API, codigos de dispositivo para ligacao a servicos externos.
  • Hooks: automacao baseada em eventos, acionada por eventos do OpenClaw.
  • Habilidades: os plugins podem incluir os seus proprios pacotes de habilidades.

Instalar plugins

Os plugins podem ser instalados a partir do npm, diretorias locais ou tarballs:

openclaw plugins install @openclaw/voice
openclaw plugins install ./my-custom-plugin
openclaw plugins list
openclaw plugins doctor

Seguranca

Como os plugins sao executados no mesmo processo que o OpenClaw Gateway, tem acesso significativo ao ambiente de execucao. O OpenClaw mitiga o risco com protecoes como bloqueio de travessia de caminhos, validacao de propriedade e sandboxing de dependencias. No entanto, os plugins devem ser tratados como codigo de confianca. Audite-os antes de instalar e utilize listas de permissoes plugins.allow para restringir o que pode ser executado.

Plugins no OpenClaw.rocks

No OpenClaw.rocks, a sua instancia vem pre-configurada com os plugins de canais de mensagens para Telegram, Discord, WhatsApp e Signal. Nao precisa de os instalar ou configurar manualmente. Se precisar de plugins adicionais para a sua implementacao auto-alojada, pode geri-los atraves do CLI do OpenClaw.

Saiba mais