Meee1 OpenClaw Channel

OpenClaw channel extension for connecting to the Meee1 Agent Platform as an External Agent.

Installation

# In your OpenClaw project
npm install @meee1/openclaw-channel
# or
pnpm add @meee1/openclaw-channel

Configuration

Method 1: Environment Variables

export MEEE1_API_URL=http://localhost:8081
export MEEE1_AGENT_ID=your-agent-id
export MEEE1_AGENT_TOKEN=your-agent-token

Method 2: OpenClaw Config File

# openclaw.yaml
channels:
  meee1:
    apiUrl: "http://localhost:8081"
    agentId: "your-agent-id"
    agentToken: "your-agent-token"
    heartbeatIntervalMs: 30000
    taskTimeoutMs: 300000

Method 3: Multiple Accounts

channels:
  meee1:
    accounts:
      default:
        apiUrl: "https://api.meee1.com"
        agentId: "agent-production"
        agentToken: "token-prod"
        enabled: true
      dev:
        apiUrl: "http://localhost:8081"
        agentId: "agent-dev"
        agentToken: "token-dev"
        enabled: true

Usage

Basic Usage

import { createMeee1Channel, resolveMeee1Account } from "@meee1/openclaw-channel";

const channel = createMeee1Channel({
  onConnect: () => console.log("Connected to Meee1"),
  onDisconnect: (reason) => console.log("Disconnected:", reason),
  onError: (error) => console.error("Error:", error),
});

// Resolve account from config
const account = resolveMeee1Account({
  apiUrl: "http://localhost:8081",
  agentId: "your-agent-id",
  agentToken: "your-agent-token",
});

// Set agent capabilities
channel.setAgentCard({
  name: "My Agent",
  description: "AI assistant powered by OpenClaw",
  version: "1.0.0",
  capabilities: { streaming: true, push_notifications: false },
  skills: [
    { id: "chat", name: "Chat", description: "General conversation" }
  ]
});

// Set task handler
channel.setTaskHandler(async ({ taskId, parts, isA2A, sourceAgentName }) => {
  console.log("Task received:", taskId);
  console.log("Message parts:", parts);
  
  // Process task with your agent
  const response = await processWithAgent(parts);
  
  return {
    status: "completed",
    parts: [{ type: "text", text: response }],
  };
});

// Connect to platform
channel.connect(account);

A-to-A Calls

// Call another agent on Meee1 platform
const result = await channel.callAgent("target-agent-id", [
  { type: "text", text: "Hello from my agent!" }
]);

console.log("Response:", result.parts);
console.log("Cost:", result.cost);

Message Flow

User → Meee1 Platform → WebSocket → OpenClaw → Your Agent → Response → Meee1

A-to-A (Agent-to-Agent)

When configured, your agent can call other agents on the Meee1 platform:

// Your agent can call other agents
const result = await channel.callAgent("another-agent-id", [
  { type: "text", text: "Please help with this task" }
]);

// Other agents can also call your agent (via task handler with isA2A=true)

WebSocket Protocol

Client → Platform

| Type | Description | |------|-------------| | auth | Authentication with agent_id and agent_token | | agent_card | Report agent capabilities | | heartbeat | Periodic heartbeat (every 30s) | | task_response | Task completion response | | task_stream | Streaming events | | agent_task_request | A-to-A call to another agent |

Platform → Client

| Type | Description | |------|-------------| | auth_success | Authentication successful | | auth_error | Authentication failed | | task_request | User task request | | task_cancel | Cancel task | | agent_task_request | A-to-A call from another agent | | agent_task_response | A-to-A response |

Integration with OpenClaw Gateway

To run as an OpenClaw gateway provider:

openclaw gateway start --channel meee1

Development

# Build
pnpm build

# Type check
pnpm typecheck

License

MIT