moltbot-kakao

KakaoWork channel plugin for Moltbot.

Adds support for Korea-focused enterprise messaging via the KakaoWork Bot API.

Installation

moltbot plugins install @hanishkeloth/moltbot-kakao

Configuration

Add to your Moltbot config (~/.config/moltbot/config.jsonc):

{
  "channels": {
    "kakao": {
      "enabled": true,
      "appKey": "YOUR_KAKAOWORK_APP_KEY",
      "dmPolicy": "pairing"
    }
  }
}

Or use environment variable:

export KAKAOWORK_APP_KEY="your-app-key"

Getting Your App Key

1. Go to KakaoWork Admin Console
2. Navigate to Bot Management
3. Create a new bot or select existing
4. Copy the App Key

Features

• Direct message conversations via KakaoWork Web API
• Reactive callback handling for button interactions
• Multi-account configuration support
• Pairing-based DM access control
• Rate limit aware (200 req/min workspace limit)

Configuration Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | appKey | string | - | Bot App Key from KakaoWork admin | | keyFile | string | - | Path to file containing app key | | callbackUrl | string | - | HTTPS URL for reactive events | | callbackPath | string | - | Gateway HTTP path for callbacks | | dmPolicy | string | "pairing" | Access policy: pairing, allowlist, open, disabled | | allowFrom | array | [] | User IDs allowed to DM the bot | | proxy | string | - | Proxy URL for API requests |

Multi-Account Setup

{
  "channels": {
    "kakao": {
      "enabled": true,
      "accounts": {
        "team-a": {
          "appKey": "TEAM_A_APP_KEY",
          "dmPolicy": "allowlist",
          "allowFrom": ["12345", "67890"]
        },
        "team-b": {
          "appKey": "TEAM_B_APP_KEY",
          "dmPolicy": "open"
        }
      },
      "defaultAccount": "team-a"
    }
  }
}

API Reference

This plugin uses the KakaoWork Web API:

• bots.info - Get bot information
• conversations.open - Create/open DM conversations
• messages.send - Send messages to conversations

License

MIT