@ynhcj/xiaoyi 1.0.0

package/README.md

@@ -0,0 +1,205 @@
+# @openclaw/xiaoyi
+
+Openclaw Xiaoyi channel plugin - Huawei A2A (Agent-to-Agent) protocol integration via WebSocket.
+
+## Overview
+
+This plugin enables Openclaw to communicate with Huawei's A2A Gateway service, allowing AI agents to send and receive messages through Huawei's messaging infrastructure.
+
+## Features
+
+- **WebSocket Connection**: Persistent WebSocket connection to `wss://xiaoyi.com/ws/link`
+- **Auto-Reconnection**: Automatic reconnection with exponential backoff
+- **AK/SK Authentication**: Huawei Cloud Access Key/Secret Key authentication
+- **A2A Protocol**: Full support for Huawei's A2A message protocol
+- **Session Management**: Automatic session tracking and continuity
+- **Media Support**: Text and media message handling
+
+## Installation
+
+```bash
+npm install @openclaw/xiaoyi
+```
+
+## Configuration
+
+Add the following to your Openclaw configuration file:
+
+```yaml
+channels:
+  xiaoyi:
+    enabled: true
+    # Huawei Cloud credentials
+    accessKeyId: "your-access-key-id"
+    secretAccessKey: "your-secret-access-key"
+    projectId: "your-project-id"
+    # Optional settings
+    serverUrl: "wss://xiaoyi.com/ws/link"  # Default: wss://xiaoyi.com/ws/link
+    agentId: "openclaw"                     # Default: openclaw
+    proxy: ""                               # Optional proxy URL
+
+    # Multiple accounts support
+    accounts:
+      account1:
+        enabled: true
+        accessKeyId: "account1-key-id"
+        secretAccessKey: "account1-secret"
+        projectId: "account1-project"
+        agentId: "openclaw-account1"
+```
+
+## Configuration via Environment Variables
+
+```bash
+export XIAOYI_ACCESS_KEY_ID="your-access-key-id"
+export XIAOYI_SECRET_ACCESS_KEY="your-secret-access-key"
+export XIAOYI_PROJECT_ID="your-project-id"
+```
+
+## Message Protocol
+
+### A2A Request Message (Incoming)
+
+```typescript
+{
+  "header": {
+    "messageId": "msg_1234567890_abc123",
+    "sessionId": "session_1234567890_def456",
+    "timestamp": 1703145600000,
+    "messageType": "request",
+    "version": "1.0"
+  },
+  "sender": {
+    "id": "user123",
+    "name": "John Doe",
+    "type": "user"
+  },
+  "receiver": {
+    "id": "openclaw",
+    "type": "agent"
+  },
+  "content": {
+    "contentType": "text",
+    "text": "Hello, how can you help me?"
+  },
+  "context": {
+    "chatType": "direct"
+  }
+}
+```
+
+### A2A Response Message (Outgoing)
+
+```typescript
+{
+  "header": {
+    "messageId": "msg_1234567890_xyz789",
+    "sessionId": "session_1234567890_def456",
+    "timestamp": 1703145601000,
+    "messageType": "response",
+    "version": "1.0"
+  },
+  "sender": {
+    "id": "openclaw",
+    "name": "Openclaw Agent",
+    "type": "agent"
+  },
+  "receiver": {
+    "id": "user123",
+    "type": "user"
+  },
+  "content": {
+    "contentType": "text",
+    "text": "I'm here to help! What do you need?"
+  },
+  "status": {
+    "code": 200,
+    "message": "OK"
+  },
+  // Top-level fields for routing
+  "agentId": "openclaw",
+  "sessionId": "session_1234567890_def456"
+}
+```
+
+## Authentication
+
+The plugin uses Huawei Cloud's AK/SK authentication mechanism:
+
+1. Generates a JWT-like token signed with the secret access key
+2. Sends an authentication message on WebSocket connection
+3. Automatically refreshes tokens before expiration
+4. Handles authentication failures with reconnection
+
+## Reconnection Strategy
+
+- Initial delay: 1 second
+- Backoff multiplier: 1.5x
+- Maximum delay: 30 seconds
+- Maximum attempts: Unlimited (configurable)
+- Ping interval: 30 seconds
+- Pong timeout: 10 seconds
+
+## API Reference
+
+### `XiaoyiWebSocketClient`
+
+Main WebSocket client class for Xiaoyi connection.
+
+```typescript
+import { createXiaoyiWebSocketClient } from '@openclaw/xiaoyi';
+
+const client = createXiaoyiWebSocketClient({
+  serverUrl: 'wss://xiaoyi.com/ws/link',
+  credentials: {
+    accessKeyId: 'your-key',
+    secretAccessKey: 'your-secret',
+    projectId: 'your-project',
+    agentId: 'openclaw',
+  },
+  reconnect: true,
+  onMessage: (message) => console.log('Received:', message),
+  onStateChange: (status) => console.log('Status:', status.state),
+});
+
+await client.connect();
+```
+
+### Message Handlers
+
+```typescript
+import {
+  createOutgoingMessage,
+  a2aToOpenclaw,
+  openclawToA2A,
+  validateA2ARequest,
+} from '@openclaw/xiaoyi';
+
+// Create outgoing message
+const outgoing = createOutgoingMessage({
+  to: 'user123',
+  text: 'Hello!',
+  sessionId: 'session_123',
+  agentId: 'openclaw',
+});
+
+// Validate incoming message
+if (validateA2ARequest(incoming)) {
+  const openclawMsg = a2aToOpenclaw(incoming, 'default', 'openclaw');
+}
+```
+
+## References
+
+- [Huawei Push Message Service](https://developer.huawei.com/consumer/cn/doc/service/pushmessage-0000002505761436)
+- [Huawei Message Stream (A2A Protocol)](https://developer.huawei.com/consumer/cn/doc/service/message-stream-0000002505761434)
+
+## License
+
+MIT
+
+## Support
+
+For issues and questions:
+- GitHub Issues: [openclaw/xiaoyi-channel](https://github.com/openclaw/xiaoyi-channel/issues)
+- Openclaw Discord: [Join our server](https://discord.gg/openclaw)

package/index.ts

@@ -0,0 +1,40 @@
+/**
+ * Xiaoyi Channel Plugin for Openclaw
+ * Huawei A2A Gateway integration via WebSocket
+ *
+ * @packageDocumentation
+ */
+
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+
+import { xiaoyiPlugin } from "./src/channel.js";
+import { setXiaoyiRuntime } from "./src/runtime.js";
+
+// ============================================================================
+// Plugin Definition
+// ============================================================================
+
+const plugin = {
+  id: "xiaoyi",
+  name: "Xiaoyi (Huawei A2A Gateway)",
+  description: "Openclaw Xiaoyi channel plugin - Huawei A2A protocol integration via WebSocket",
+  version: "1.0.0",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    // Set runtime reference
+    setXiaoyiRuntime(api.runtime);
+
+    // Register the channel plugin
+    api.registerChannel({ plugin: xiaoyiPlugin });
+  },
+};
+
+export default plugin;
+
+// ============================================================================
+// Re-exports
+// ============================================================================
+
+export { xiaoyiPlugin } from "./src/channel.js";
+export * from "./src/types.js";

package/openclaw.plugin.json

@@ -0,0 +1,14 @@
+{
+  "id": "xiaoyi",
+  "name": "Xiaoyi",
+  "version": "1.0.0",
+  "description": "Openclaw Xiaoyi channel plugin - Huawei A2A protocol integration via WebSocket",
+  "channels": ["xiaoyi"],
+  "author": "",
+  "license": "MIT",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@ynhcj/xiaoyi",
+  "publishConfig": {
+      "access": "public"
+    },
+  "version": "1.0.0",
+  "description": "OpenClaw Xiaoyi channel plugin - Huawei A2A Gateway integration",
+  "keywords": [
+    "openclaw",
+    "channel",
+    "xiaoyi",
+    "huawei",
+    "a2a",
+    "websocket"
+  ],
+  "license": "MIT",
+  "author": "",
+  "type": "module",
+  "exports": {
+    ".": "./index.ts",
+    "./types": "./src/types.ts"
+  },
+  "main": "index.ts",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.2.1"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "xiaoyi",
+      "label": "Xiaoyi (Huawei A2A Gateway)",
+      "selectionLabel": "Xiaoyi",
+      "docsPath": "/channels/xiaoyi",
+      "docsLabel": "xiaoyi",
+      "blurb": "Huawei A2A Gateway integration for AI agent messaging via WebSocket",
+      "aliases": [
+        "xy",
+        "huawei"
+      ],
+      "order": 100,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@openclaw/xiaoyi"
+    }
+  }
+}

package/scripts/dev-link.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Development setup script for moltbot-hag-channel
+
+EXT_DIR="$HOME/.openclaw/extensions/xiaoyi"
+PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+
+echo "Project directory: $PROJECT_DIR"
+echo "Extension directory: $EXT_DIR"
+
+# Remove existing installation
+if [ -L "$EXT_DIR" ]; then
+    echo "Removing existing symlink..."
+    rm "$EXT_DIR"
+elif [ -d "$EXT_DIR" ]; then
+    echo "Backing up existing installation..."
+    mv "$EXT_DIR" "${EXT_DIR}.backup.$(date +%s)"
+fi
+
+# Create symlink
+echo "Creating development symlink..."
+ln -s "$PROJECT_DIR" "$EXT_DIR"
+
+# Install dependencies
+echo "Installing dependencies..."
+cd "$PROJECT_DIR"
+npm install --omit=dev
+
+echo "Development setup complete!"
+echo "The plugin will use your source code directly."

package/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "node",
+    "lib": ["ES2022"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "types": ["node"]
+  },
+  "include": [
+    "src/**/*.ts",
+    "index.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}