AIHA Channel - OpenClaw Message Channel Plugin

A custom message channel plugin for OpenClaw, the personal AI assistant.

Features

• WebSocket-based bidirectional messaging
• Full streaming response support: sends stream_start → stream_chunk → stream_end
• Outbound message sending support
• Multi-account support
• Thread/conversation support
• Full OpenClaw plugin SDK integration

Installation

Install via OpenClaw plugin manager:

openclaw plugin install github:<your-github-username>/aihachannel

Or install manually from source using pnpm:

cd ~/.openclaw/extensions
git clone <your-repo-url> aihachannel
cd aihachannel
pnpm install
pnpm run build

Configuration

Add to your OpenClaw config file (~/.openclaw/openclaw.json):

{
  "plugins": {
    "allow": ["aiha"],
    "enabled": true
  },
  "channels": {
    "aiha": {
      "enabled": true,
      "accounts": {
        "default": {
          "token": "your-api-token-here",
          "endpoint": "wss://your-aiha-service.com/ws/claw",
          "enabled": true
        }
      }
    }
  }
}

Sandbox Permissions

Since OpenClaw uses sandboxing for security, you need to allow agent access to the extensions directory where this plugin is installed. Add this to your OpenClaw config (~/.openclaw/openclaw.json):

{
  "sandbox": {
    "filesystem": {
      "allowRead": [
        "~/.openclaw/extensions"
      ]
    }
  }
}

This allows the agent to read any installed plugin's source code, which is needed when you ask the AI to modify or explain the plugin code.

Development

Install dependencies

npm install

Build

npm run build

Watch mode

npm run dev

Project Structure

aihachannel/
├── src/
│   ├── index.ts       # Main plugin entry
│   ├── client.ts      # API client implementation
│   └── types.ts       # Type definitions
├── docs/
│   └── SETUP.md       # Detailed setup instructions
├── test/              # Tests
├── dist/              # Compiled output
└── package.json

License

MIT