Kzino/vorim-openclaw-skill

O que vorim-openclaw-skill faz?

Habilidade Oficial do OpenClaw para Vorim AI — identidade criptográfica, permissões com escopo e trilhas de auditoria à prova de adulteração para agentes OpenClaw.

Visão Geral

Esta skill capacita agentes OpenClaw com:

• Identidade Criptográfica: Cada agente recebe uma chave única e um certificado, permitindo autenticação mútua e assinatura de ações.
• Permissões com Escopo: Defina políticas granulares que controlam quais recursos (APIs, arquivos, bancos de dados) cada agente pode acessar e sob quais condições.
• Trilha de Auditoria Inviolável: Todas as ações são registradas em um ledger imutável, com hashes encadeados que garantem que nenhuma entrada possa ser alterada retroativamente.

Funcionalidades Principais

• Geração automática de identidade: Ao iniciar, a skill cria ou recupera um par de chaves (ed25519) e emite um certificado autoassinado ou verificado por uma CA configurada.
• Controle de Acesso Baseado em Políticas (PBAC): As permissões são definidas em arquivos YAML/JSON e podem ser associadas a funções, ações ou recursos específicos.
• Auditoria Contínua: Cada requisição de API, comando executado ou alteração de estado é registrada com timestamp, ID do agente, hash da ação e assinatura.
• Verificação de Integridade: A qualquer momento, é possível validar a trilha de auditoria contra adulterações, comparando hashes e assinaturas.

Configuração

Pré-requisitos

• Vorim AI versão 1.2 ou superior.
• OpenClaw SDK 0.9+ instalado.

Instalação

Adicione a skill ao seu projeto Vorim:

vorim install Kzino/vorim-openclaw-skill

Configuração Inicial

Edite o arquivo config.yaml na raiz do seu projeto Vorim:

openclaw:
  identity:
    key_type: ed25519
    cert_path: ./certs/agent.pem
  policies:
    - role: "data_processor"
      actions: ["read", "write"]
      resources:
        - "db://customers/*"
        - "file:///data/inbound/*.csv"
    - role: "auditor"
      actions: ["read"]
      resources:
        - "audit://*"
  audit:
    enabled: true
    storage: local
    encryption: aes256

Uso

Após a configuração, a skill opera automaticamente. Exemplo de código para um agente:

from vorim import Agent
from vorim_skills.openclaw import OpenClawSkill

agent = Agent("meu_agente")
agent.use(OpenClawSkill)

# A geração de identidade e verificação de permissões ocorre de forma transparente
agent.run()

Integração Contínua

Recomenda-se utilizar a validação da trilha de auditoria em seus pipelines de CI/CD:

vorim audit verify --path ./audit/ledger

Suporte

• Documentação completa: docs.vorim.ai/openclaw
• Issues: github.com/Kzino/vorim-openclaw-skill/issues

---

Esta skill é mantida pela Kzino Inc.