Repolode
comet-ml

comet-ml/opik-openclaw

Plugin oficial do OpenClaw que exporta traces de agentes, chamadas de ferramentas, uso de tokens e custos para o Opik, permitindo observabilidade.

Estrelas
726
Forks
87
Issues abertas
17
Último commit
há 17 dias

O que é?

opik-openclaw é um plugin oficial do OpenClaw que envia dados de execução dos agentes para o Opik, uma plataforma open source de observabilidade e avaliação de LLMs. Ele registra spans de solicitações e respostas de LLMs, de subagentes e de chamadas de ferramentas, incluindo entradas, saídas e erros, além de metadados da execução, como uso e custo.

O plugin é executado dentro do processo OpenClaw Gateway. Portanto, quando o gateway é remoto, ele precisa ser instalado e configurado nesse host. A configuração é feita por meio de um assistente interativo de CLI (openclaw opik configure), e as definições também podem ser fornecidas por variáveis de ambiente, como OPIK_API_KEY e OPIK_PROJECT_NAME.

O plugin mapeia eventos do ciclo de vida do OpenClaw, como llm_input, llm_output, before_tool_call, after_tool_call, subagent_spawned e agent_end, para traces e spans do Opik, encerrando eventuais spans pendentes quando uma execução termina.

Recursos principais

  • 01Registra solicitações e respostas de LLMs como spans do Opik.
  • 02Captura entradas, saídas, erros e duração das chamadas de ferramentas.
  • 03Registra spans do ciclo de vida dos subagentes no trace do agente solicitante.
  • 04Informa o uso de tokens e os metadados de custo de cada execução.
  • 05Oferece um assistente interativo de configuração e um comando de status para verificar a configuração.

Casos de uso

  • Monitorar os custos e o consumo de tokens dos agentes OpenClaw.
  • Depurar chamadas de ferramentas que falham em execuções de agentes com várias etapas.
  • Inspecionar o comportamento dos subagentes ao longo do trace de uma conversa.

Início rápido

  1. 1

    Instale o plugin no OpenClaw

    openclaw plugins install clawhub:@opik/opik-openclaw
  2. 2

    Configure o plugin com o assistente de configuração

    openclaw opik configure
  3. 3

    Inicie o Gateway e envie uma mensagem de teste

    openclaw gateway run

Antes de usar

  • É necessário ter OpenClaw 2026.9.7 ou mais recente, Node.js 24.16 ou mais recente e npm 10 ou mais recente.
  • Para configurar, é necessária uma conta Opik ou uma instância Opik auto-hospedada, além de uma chave de API.
  • O plugin deve ser instalado no host que executa o OpenClaw Gateway. Isso é importante no caso de gateways remotos.

Em coleções

Tópicos

Perguntas frequentes

O que é opik-openclaw?
Plugin oficial do OpenClaw que exporta traces de agentes, chamadas de ferramentas, uso de tokens e custos para o Opik, permitindo observabilidade. opik-openclaw é um plugin oficial do OpenClaw que envia dados de execução dos agentes para o Opik, uma plataforma open source de observabilidade e avaliação de LLMs. Ele registra spans de solicitações e respostas de LLMs, de subagentes e de chamadas de ferramentas, incluindo entradas, saídas e erros, além de metadados da execução, como uso e custo.
opik-openclaw é gratuito? Qual é a licença?
opik-openclaw é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
opik-openclaw ainda é mantido?
Manutenção ativa. O último commit de opik-openclaw foi em 5 de out. de 2026.
Para que posso usar opik-openclaw?
Monitorar os custos e o consumo de tokens dos agentes OpenClaw. Depurar chamadas de ferramentas que falham em execuções de agentes com várias etapas. Inspecionar o comportamento dos subagentes ao longo do trace de uma conversa.
Como instalar opik-openclaw?
Instale o plugin no OpenClaw: openclaw plugins install clawhub:@opik/opik-openclaw Configure o plugin com o assistente de configuração: openclaw opik configure Inicie o Gateway e envie uma mensagem de teste: openclaw gateway run
Onde consigo opik-openclaw?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/comet-ml/opik-openclaw

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados