Habilidade de Gorjetas e Doações por IA para Openclaw

Uma habilidade de gorjetas e doações alimentada por IA que reconhece de forma inteligente a intenção de presentear do usuário, valida o valor da transação e lida com entregas de pagamento seguras.

sayxxx
v1.0.0
Mar 15, 2026
0
529
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install tips

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o tips usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Habilidade de Gorjetas e Doações por IA?

A Habilidade de Gorjeta é um protocolo de interação padronizado projetado para agentes de IA processarem gorjetas digitais, doações e presentes virtuais. Como parte do ecossistema Openclaw Skills, este módulo permite que interfaces conversacionais identifiquem com precisão intenções de gorjeta (como 'enviar um presente' ou 'apoiar o criador') enquanto ignoram intenções padrão de pagamento de serviços públicos. Ela simplifica a experiência de microtransações gerenciando a sobrecarga de conversa da coleta e validação de parâmetros antes de chamar APIs de pagamento downstream.

Ao aproveitar esta habilidade, os desenvolvedores podem implementar estratégias de monetização robustas para assistentes de streaming, bots de comunidade e plataformas de conteúdo. A habilidade atua como um intermediário, coletando confirmações cruciais do usuário e aplicando limites estritos (por exemplo, limites máximos de transação) para garantir a segurança da transação e uma experiência de usuário sem atritos.

Casos de uso do Habilidade de Gorjetas e Doações por IA

  • Monetizar bots de transmissão ao vivo e hosts virtuais de IA permitindo que os espectadores enviem presentes virtuais e gorjetas via chat.
  • Aceitar doações em plataformas de conteúdo, blogs ou bases de conhecimento baseadas em IA, onde os usuários desejam valorizar desenvolvedores ou escritores.
  • Integrar mecanismos de recompensa em bots de gerenciamento de comunidade no Discord, Telegram ou soluções de chat personalizadas usando Openclaw Skills.

Como o Habilidade de Gorjetas e Doações por IA funciona

  1. Detecção de Intenção: O agente de IA detecta palavras-chave de gorjeta/presente (por exemplo, 'dar gorjeta ao host', 'enviar um presente') e extrai o parâmetro amount.
  2. Refinamento de Parâmetros: Se o valor da gorjeta estiver faltando, o agente faz uma pergunta de acompanhamento para coletá-lo.
  3. Validação de Valor: O sistema verifica se o valor coletado satisfaz os limites (deve estar entre 0 e 10.000 unidades).
  4. Confirmação do Usuário: O agente solicita uma confirmação explícita do usuário ('Tem certeza de que deseja dar {amount} de gorjeta?') para evitar cobranças acidentais.
  5. Delegação de Pagamento: Após a confirmação, a habilidade aciona o protocolo de pagamento principal com os metadados order_type: "tip" e os detalhes da transação.
  6. Liquidação da Transação: A IA exibe o link final do gateway de pagamento e o código de transação retornados pelo serviço de pagamento ao usuário.

Configuração do Habilidade de Gorjetas e Doações por IA

Para ativar a Habilidade de Gorjeta na arquitetura do seu assistente de IA, siga estas etapas para registrar os metadados da habilidade e conectá-la ao seu provedor de pagamento.

  1. Defina a estrutura YAML da habilidade em sua configuração:
name: tip
description: Tipping and Donation Skill
trigger:
  intents:
    - "tip"
    - "donate"
    - "send gift"
  1. Vincule o manipulador de gorjetas à sua habilidade de payment downstream usando seu SDK de runtime preferido ou implante via CLI:
# Install the tipping skill module
openclaw skills:install tip

# Configure payment gateway credentials for processing
openclaw config:set payment_gateway_url="https://pay-h5.example.com"

Esquema de Dados e Taxonomia de Habilidade de Gorjetas e Doações por IA

Estrutura de Parâmetros

A Habilidade de Gorjeta requer o seguinte payload de parâmetros para iniciar uma transação:

Parâmetro Tipo Obrigatório Descrição Prompt de Fallback
amount Number Sim O valor numérico da gorjeta/doação. "Quanto você gostaria de dar de gorjeta?"

Esquema de Dados de Entrada e Saída

Ao delegar a transação ao manipulador de pagamento subjacente, a habilidade produz a seguinte estrutura de payload:

  • amount: Number (o valor validado solicitado)
  • order_type: String (fixo como "tip")
  • description: String (descrição formatada, por exemplo, "Gorjeta de {amount} Yuan")

Após a execução bem-sucedida, a habilidade processa e exibe a seguinte resposta do manipulador de pagamento:

Chave de Resposta Tipo Descrição
tradeCode String Hash de transação exclusivo ou ID de referência gerado pelo processador de pagamento.
tradeLink String URL do gateway de pagamento H5 onde o usuário conclui a transação segura.

Recursos avançados do Habilidade de Gorjetas e Doações por IA

  • Filtragem de Intenção Consciente do Contexto: Distingue inteligentemente solicitações de gorjeta ('Eu quero dar gorjeta') de consultas de pagamento gerais ('Deixe-me pagar minha conta') para evitar gatilhos acidentais.
  • Apagamento Implícito de Destinatário: Filtra automaticamente nomes de destinatários ou handles de plataforma do fluxo de pagamento, garantindo registros de contabilidade focados em privacidade estrita.
  • Interceptor de Pagamento Downstream: Integra-se perfeitamente como um middleware de pré-processamento que formata payloads antes de roteá-los para provedores de pagamento de rede múltipla Openclaw Skills.
  • Guarda de Confirmação: Emprega processamento de linguagem natural integrado para analisar corretamente cancelamentos de conversação (por exemplo, 'deixa pra lá', 'cancelar', 'esquece') e abortar transações com segurança.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*