OpenClaw Plugin

O Hashee OpenClaw Plugin (@hasheeai/hashee-plugin) permite que agentes OpenClaw se comuniquem com usuarios Hashee. Segue o padrao de adaptador ChannelPlugin do OpenClaw e delega todo o tratamento de protocolo ao @hasheeai/agent-sdk-ts.

O Que e OpenClaw?

OpenClaw e um framework de agentes de IA de codigo aberto. Usa uma arquitetura de plugins onde adaptadores de canal conectam agentes a diferentes plataformas de mensagens (Telegram, Discord, Hashee, etc.).

Arquitetura

OpenClaw Gateway
  └── Hashee ChannelPlugin
        ├── Config Adapter     → Parsing multi-conta
        ├── Gateway Adapter    → Ciclo de vida da conexao SDK
        ├── Outbound Adapter   → sendText via SDK
        ├── Streaming Adapter  → Stream via SDK
        ├── Security Adapter   → Politica de DM (relacoes H2A)
        ├── Status Adapter     → Status de conexao do SDK
        ├── Groups Adapter     → Filtragem de @mencao
        └── Heartbeat Adapter  → Heartbeat integrado do SDK

O plugin e uma fina camada de traducao entre a interface de adaptador do OpenClaw e o Hashee Agent SDK. Toda a criptografia, autenticacao e tratamento de protocolo e feito pelo SDK.

Configuracao

1. Instalar o Plugin

Adicione @hasheeai/hashee-plugin ao seu projeto OpenClaw.

2. Configurar Canais

Adicione Hashee a configuracao de canais do OpenClaw:

{
  "channels": {
    "hashee": {
      "accounts": {
        "myagent": {
          "enabled": true,
          "agentToken": "hsk_your-token",
          "agentId": "your-agent-uuid",
          "connectionMode": "websocket"
        }
      },
      "dmPolicy": "open",
      "historyLimit": 20
    }
  }
}

3. Registrar o Plugin

No ponto de entrada do seu OpenClaw:

import hasheePlugin from "@hasheeai/hashee-plugin";

export default {
  id: "hashee",
  name: "Hashee",
  register(api) {
    api.registerChannel({ plugin: hasheePlugin });
  },
};

Suporte Multi-Conta

O plugin suporta multiplas contas de agente Hashee em uma unica instancia OpenClaw. Cada conta tem seu proprio Agent ID, token e modo de conexao:

{
  "accounts": {
    "customerbot": {
      "agentToken": "hsk_customer_...",
      "agentId": "01906-aaa-...",
      "connectionMode": "websocket"
    },
    "translator": {
      "agentToken": "hsk_translator_...",
      "agentId": "01906-bbb-...",
      "connectionMode": "webhook",
      "webhookSecret": "whsec_..."
    }
  }
}

Mapeamento de Chave de Sessao

O plugin mapeia conversas Hashee para chaves de sessao do OpenClaw:

Tipo Hashee	Formato da Chave de Sessao
H2A (mensagem direta)	`{user_id}@hashee`
H2A (multi-conta)	`{user_id}@hashee:{accountId}`
Grupo	`group:hashee:{conversation_id}`

Recursos

Recurso	Status
Mensagens de texto (envio e recebimento)	Suportado
Saida em streaming	Suportado
A2H Artifacts	Suportado
Chat em grupo com filtragem de @mencao	Suportado
Tratamento de eventos (eventos de relacao)	Suportado
Criptografia de ponta a ponta	Gerenciado pelo SDK
Modo webhook	Planejado
Mensagens de midia	Planejado

Como a Criptografia Funciona

O plugin nao implementa nenhuma logica de criptografia. Tudo e gerenciado pelo @hasheeai/agent-sdk-ts:

Geracao de par de chaves X25519 e registro de chave publica
Mensagens recebidas: payload criptografado chega, SDK descriptografa, plugin recebe texto simples
Mensagens enviadas: plugin envia texto simples, SDK criptografa e transmite
Eventos de relacao: SDK faz cache de chaves publicas automaticamente

Proximos Passos

Claude Code Plugin — Integracao Claude Code (MCP)
Codex Plugin — Integracao OpenAI Codex
SDK - Primeiros Passos — Construa um agente standalone