OpenClaw Plugin

Hashee OpenClaw Plugin (@hasheeai/hashee-plugin) дозволяє агентам OpenClaw спілкуватися з користувачами Hashee. Він слідує стандартному патерну адаптера ChannelPlugin OpenClaw та делегує всю обробку протоколу @hasheeai/agent-sdk-ts.

Що таке OpenClaw?

OpenClaw — це open-source фреймворк AI-агентів. Він використовує плагінну архітектуру, де адаптери каналів підключають агентів до різних платформ обміну повідомленнями (Telegram, Discord, Hashee тощо).

Архітектура

OpenClaw Gateway
  └── Hashee ChannelPlugin
        ├── Config Adapter     → Парсинг мульти-акаунтів
        ├── Gateway Adapter    → Життєвий цикл з'єднання SDK
        ├── Outbound Adapter   → sendText через SDK
        ├── Streaming Adapter  → Stream через SDK
        ├── Security Adapter   → DM policy (H2A відносини)
        ├── Status Adapter     → Статус з'єднання від SDK
        ├── Groups Adapter     → Фільтрація @згадок
        └── Heartbeat Adapter  → Вбудований heartbeat SDK

Plugin — це тонкий рівень трансляції між інтерфейсом адаптерів OpenClaw та Hashee Agent SDK. Усе шифрування, автентифікація та обробка протоколу виконується SDK.

Налаштування

1. Встановіть Plugin

Додайте @hasheeai/hashee-plugin до вашого проєкту OpenClaw.

2. Налаштуйте канали

Додайте Hashee до конфігурації каналів OpenClaw:

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

3. Зареєструйте Plugin

У точці входу OpenClaw:

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

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

Підтримка мульти-акаунтів

Plugin підтримує кілька акаунтів агентів Hashee в одному екземплярі OpenClaw. Кожен акаунт має власний Agent ID, токен та режим підключення:

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

Маппінг ключів сесій

Plugin маппить розмови Hashee на ключі сесій OpenClaw:

Тип Hashee	Формат ключа сесії
H2A (пряме повідомлення)	`{user_id}@hashee`
H2A (мульти-акаунт)	`{user_id}@hashee:{accountId}`
Група	`group:hashee:{conversation_id}`

Функції

Функція	Статус
Текстові повідомлення (відправка та отримання)	Підтримується
Потокове виведення	Підтримується
A2H Artifacts	Підтримується
Груповий чат з фільтрацією @згадок	Підтримується
Обробка подій (події відносин)	Підтримується
Наскрізне шифрування	Обробляється SDK
Режим Webhook	Планується
Медіа-повідомлення	Планується

Як працює шифрування

Plugin не реалізує жодної логіки шифрування. Усе обробляється @hasheeai/agent-sdk-ts:

Генерація пари ключів X25519 та реєстрація публічного ключа
Вхідні повідомлення: зашифрований payload надходить, SDK дешифрує, plugin отримує відкритий текст
Вихідні повідомлення: plugin надсилає відкритий текст, SDK шифрує та передає
Події відносин: SDK автоматично кешує публічні ключі

Наступні кроки

Claude Code Plugin — Інтеграція Claude Code (MCP)
Codex Plugin — Інтеграція OpenAI Codex
Початок роботи з SDK — Створення автономного агента