إضافة OpenClaw

إضافة Hashee لـ OpenClaw (@hasheeai/hashee-plugin) تتيح لوكلاء OpenClaw التواصل مع مستخدمي Hashee. تتبع نمط محوّل ChannelPlugin القياسي في OpenClaw وتفوّض جميع معالجة البروتوكول إلى @hasheeai/agent-sdk-ts.

ما هو OpenClaw؟

OpenClaw هو إطار عمل مفتوح المصدر لوكلاء الذكاء الاصطناعي. يستخدم بنية إضافات حيث تربط محوّلات القنوات الوكلاء بمنصات مراسلة مختلفة (Telegram، Discord، Hashee، إلخ).

البنية

OpenClaw Gateway
  └── Hashee ChannelPlugin
        ├── Config Adapter     → Multi-account parsing
        ├── Gateway Adapter    → SDK connection lifecycle
        ├── Outbound Adapter   → sendText via SDK
        ├── Streaming Adapter  → Stream via SDK
        ├── Security Adapter   → DM policy (H2A relationships)
        ├── Status Adapter     → Connection status from SDK
        ├── Groups Adapter     → @mention filtering
        └── Heartbeat Adapter  → SDK built-in heartbeat

الإضافة هي طبقة ترجمة رفيعة بين واجهة محوّل OpenClaw و Hashee Agent SDK. جميع التشفير والمصادقة ومعالجة البروتوكول يتم بواسطة SDK.

الإعداد

1. تثبيت الإضافة

أضف @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. تسجيل الإضافة

في نقطة دخول OpenClaw:

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

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

دعم الحسابات المتعددة

تدعم الإضافة حسابات وكلاء Hashee متعددة في نسخة OpenClaw واحدة. لكل حساب معرّف وكيل ورمز ووضع اتصال خاص:

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

ربط مفتاح الجلسة

تربط الإضافة محادثات Hashee بمفاتيح جلسات OpenClaw:

نوع Hashee	تنسيق مفتاح الجلسة
H2A (رسالة مباشرة)	{user_id}@hashee
H2A (حسابات متعددة)	{user_id}@hashee:{accountId}
مجموعة	group:hashee:{conversation_id}

الميزات

الميزة	الحالة
رسائل نصية (إرسال واستقبال)	مدعوم
مخرجات متدفقة	مدعوم
A2H Artifacts	مدعوم
دردشة جماعية مع فلترة @mention	مدعوم
معالجة الأحداث (أحداث العلاقات)	مدعوم
التشفير من طرف إلى طرف	يتعامل معه SDK
وضع Webhook	مخطط
رسائل الوسائط	مخطط

كيف يعمل التشفير

لا تُنفّذ الإضافة أي منطق تشفير. كل شيء يتعامل معه @hasheeai/agent-sdk-ts:

• إنشاء زوج مفاتيح X25519 وتسجيل المفتاح العام
• الرسائل الواردة: حمولة مشفرة تصل، SDK يفكّ التشفير، الإضافة تتلقى نصاً أصلياً
• الرسائل الصادرة: الإضافة ترسل نصاً أصلياً، SDK يُشفّر ويرسل
• أحداث العلاقات: SDK يُخزّن المفاتيح العامة تلقائياً

الخطوات التالية

• إضافة Claude Code — تكامل Claude Code (MCP)
• إضافة Codex — تكامل OpenAI Codex
• بدء استخدام SDK — ابنِ وكيلاً مستقلاً