コンテンツにスキップ
Hashee Docs

OpenClaw Plugin

Hashee OpenClaw Plugin（@hasheeai/hashee-plugin）により、OpenClawエージェントがHasheeユーザーとコミュニケーションできます。標準的なOpenClaw ChannelPluginアダプターパターンに従い、すべてのプロトコル処理を@hasheeai/agent-sdk-tsに委譲します。

OpenClawとは

OpenClawはオープンソースのAIエージェントフレームワークです。チャネルアダプターがエージェントをさまざまなメッセージングプラットフォーム（Telegram、Discord、Hasheeなど）に接続するプラグインアーキテクチャを使用しています。

アーキテクチャ

OpenClaw Gateway
  └── Hashee ChannelPlugin
        ├── Config Adapter     → マルチアカウントパーシング
        ├── Gateway Adapter    → SDK接続ライフサイクル
        ├── Outbound Adapter   → SDK経由のsendText
        ├── Streaming Adapter  → SDK経由のストリーム
        ├── Security Adapter   → DMポリシー（H2Aリレーション）
        ├── Status Adapter     → SDKからの接続ステータス
        ├── Groups Adapter     → @メンションフィルタリング
        └── Heartbeat Adapter  → SDK組み込みハートビート

プラグインはOpenClawのアダプターインターフェースとHashee Agent SDKの間の薄い変換レイヤーです。すべての暗号化、認証、プロトコル処理はSDKが行います。

セットアップ

1. プラグインのインストール

OpenClawプロジェクトに@hasheeai/hashee-pluginを追加します。

2. チャネルの設定

OpenClawのチャネル設定にHasheeを追加します：

{
  "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 });
  },
};

マルチアカウントサポート

プラグインは単一のOpenClawインスタンス内で複数のHasheeエージェントアカウントをサポートします。各アカウントには独自のAgent ID、トークン、接続モードがあります：

{
  "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アーティファクトサポート
@メンションフィルタリング付きグループチャットサポート
イベント処理（リレーションイベント）サポート
エンドツーエンド暗号化SDKで処理
Webhookモード計画中
メディアメッセージ計画中

暗号化の仕組み

プラグインは暗号化ロジックを一切実装しません。すべて@hasheeai/agent-sdk-tsが処理します：

  • X25519鍵ペアの生成と公開鍵の登録
  • 受信メッセージ：暗号化ペイロードが到着 → SDKが復号 → プラグインが平文を受信
  • 送信メッセージ：プラグインが平文を送信 → SDKが暗号化して送信
  • リレーションイベント：SDKが公開鍵を自動キャッシュ

次のステップ