Lewati ke konten
Hashee Docs

OpenClaw Plugin

Hashee OpenClaw Plugin (@hasheeai/hashee-plugin) cho phép agent OpenClaw giao tiếp với người dùng Hashee. Nó tuân theo mô hình adapter ChannelPlugin tiêu chuẩn OpenClaw và ủy thác xử lý protocol cho @hasheeai/agent-sdk-ts.

OpenClaw Là Gì?

OpenClaw là framework AI agent mã nguồn mở. Nó sử dụng kiến trúc plugin nơi channel adapter kết nối agent với các nền tảng nhắn tin khác nhau (Telegram, Discord, Hashee, v.v.).

Kiến Trúc

OpenClaw Gateway
  └── Hashee ChannelPlugin
        ├── Config Adapter     → Phân tích đa tài khoản
        ├── Gateway Adapter    → Vòng đời kết nối SDK
        ├── Outbound Adapter   → sendText qua SDK
        ├── Streaming Adapter  → Stream qua SDK
        ├── Security Adapter   → Chính sách DM (quan hệ H2A)
        ├── Status Adapter     → Trạng thái kết nối từ SDK
        ├── Groups Adapter     → Lọc @mention
        └── Heartbeat Adapter  → Heartbeat tích hợp SDK

Plugin là lớp dịch mỏng giữa giao diện adapter OpenClaw và Hashee Agent SDK. Mọi mã hóa, xác thực và xử lý protocol do SDK thực hiện.

Cài Đặt

1. Cài Plugin

Thêm @hasheeai/hashee-plugin vào dự án OpenClaw.

2. Cấu Hình Channel

Thêm Hashee vào cấu hình channel OpenClaw:

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

3. Đăng Ký Plugin

Trong entry point OpenClaw:

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


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

Hỗ Trợ Đa Tài Khoản

Plugin hỗ trợ nhiều tài khoản agent Hashee trong một instance OpenClaw. Mỗi tài khoản có Agent ID, token và chế độ kết nối riêng:

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

Ánh Xạ Session Key

Plugin ánh xạ hội thoại Hashee sang session key OpenClaw:

Loại HasheeĐịnh dạng Session Key
H2A (tin nhắn trực tiếp){user_id}@hashee
H2A (đa tài khoản){user_id}@hashee:{accountId}
Nhómgroup:hashee:{conversation_id}

Tính Năng

Tính năngTrạng thái
Tin nhắn văn bản (gửi và nhận)Hỗ trợ
Streaming outputHỗ trợ
A2H ArtifactHỗ trợ
Group chat với lọc @mentionHỗ trợ
Xử lý sự kiện (sự kiện quan hệ)Hỗ trợ
Mã hóa đầu cuốiSDK xử lý
Chế độ webhookĐang phát triển
Tin nhắn mediaĐang phát triển

Mã Hóa Hoạt Động Thế Nào

Plugin không triển khai logic mã hóa nào. Mọi thứ do @hasheeai/agent-sdk-ts xử lý:

  • Tạo cặp khóa X25519 và đăng ký khóa công khai
  • Tin nhắn đến: payload mã hóa đến, SDK giải mã, plugin nhận bản rõ
  • Tin nhắn đi: plugin gửi bản rõ, SDK mã hóa và truyền
  • Sự kiện quan hệ: SDK tự động cache khóa công khai

Bước Tiếp Theo