Documentação: Integração do Knodge.eu no OpenClaw.ai

Documentação: Integração do Knodge.eu no OpenClaw.ai

Esta documentação descreve a sinergia entre a plataforma de conhecimento Knodge.eu (memória central e regras) e a estrutura de agentes OpenClaw.ai (execução local e automatização).

#1 Exemplo de topo: Integração de um sistema inteligente

Neste cenário, a IA tem uma conversa com um novo utilizador, aprende as suas preferências e o OpenClaw configura automaticamente o ambiente de trabalho local.

O que o utilizador tem de fazer no Knodge.eu:

Criar portal: Criar um portal (por exemplo, internal-onboarding) através do painel de controlo ou da interface API.
Carregar instruções: Carregar o modelo instruction_onboarding.md para os documentos do portal.

  • Definir preferências:** Personalizar as perguntas do ficheiro (por exemplo, em função das linguagens de programação ou das preferências da ferramenta) que são importantes para a configuração local.
  • Guardar a chave da API:** Copiar a chave da API do seu portal para permitir a comunicação externa.

O que precisa de ser feito no OpenClaw:

  • Conexão API: Configurar uma skill que envia requisições para https://knodge.eu/api/portal/:slug/api-chat com o cabeçalho X-API-Key.
  • Definir trigger:** Criar uma tarefa que reaja à palavra-chave #onboarding.
    Permissões locais: Permitir que o OpenClaw acesse o terminal (shell) para executar comandos de configuração (por exemplo, git config) com base nos resultados da IA.

O fluxo de trabalho:

  1. o utilizador inicia o chat no OpenClaw com #onboarding.
  2. o OpenClaw encaminha a mensagem para a API do Knodge, que ativa o modelo de onboarding.
  3. a IA recolhe informações como o nome, a saudação e os interesses.
  4. após a conversa, a IA utiliza a ferramenta save_user_data para guardar um perfil como _user_{userId}.md no Knodge.
  5. o OpenClaw lê este perfil e executa localmente as configurações apropriadas.

Exemplo de topo: Revisão por peritos e correção de conformidade

A IA analisa os ficheiros locais de acordo com as normas profissionais e o OpenClaw faz as correcções necessárias diretamente no sistema de ficheiros.

O que o utilizador tem de fazer no Knodge.eu:

  • Fornecer regras de especialistas: Carregar _instruction_expert.md e _instruction_checklist.md para o seu portal.
  • Armazenar conhecimentos:** Carregar documentos PDF com normas de codificação ou diretrizes legais para servirem de referência.

O que precisa de ser feito no OpenClaw:

  • Acesso a ficheiros: Dar permissões de leitura e escrita ao OpenClaw na pasta do projeto a ser analisado.
    Comando de análise: Implementar um comando que envie o conteúdo de um ficheiro local juntamente com a palavra-chave #expert para a API do Knodge.

O fluxo de trabalho:

  1. você diz ao OpenClaw "Check config.py with #expert".
  2. o OpenClaw envia o conteúdo do ficheiro para o Knodge; o Knodge aplica uma análise profunda e terminologia técnica.
    3 - Knodge identifica os problemas e cria uma lista de verificação passo-a-passo via #checklist se necessário.
  3. o OpenClaw trabalha com esta lista de verificação, corrige o código localmente e valida as alterações através de um comando de terminal.

Configuração técnica & lista futura

Resumo da configuração

Componente Knodge.eu (memória) OpenClaw (execução)
Autenticação** Cabeçalho X-API-Key Armazena a chave API de forma segura em .env
Controlo lógico** Ficheiros com prefixo _instruction_ Reconhecimento de palavras-chave (e.g. #summary)
Salvamento ferramenta save_user_data (arquivos Markdown) chamada de ferramenta via ponte API
Idiomas Suporte nativo a DeepL Entrada de comandos possível em 6 idiomas

Lista futura (recursos planejados)

** Integração nativa de plugins: Um plugin oficial do OpenClaw que integra portais Knodge como armazenamento nativo de ficheiros (cloud vault).

  • Atualização automática dos arquivos #instruction no Knodge com base no sucesso das ações locais do OpenClaw.
  • Memória partilhada para equipas de agentes:** Várias instâncias do OpenClaw acedem a um perfil de utilizador partilhado através do Knodge para resolver tarefas coordenadas.
    Log de auditoria automatizado: O OpenClaw salva cada comando shell executado como um documento verificado no portal Knodge para segurança de auditoria.