KakaoTalk

Part of the channel adapters family.

Transport: LOCO protocol (no public URL required). Setup walkthrough: Add a channel.

Auth

Sub-device login using email and password. Passwords are stored encrypted at rest (AES-256-GCM; the key lives outside the agent folder).

Unlike the other adapters, secrets.json#channels.kakaotalk is not a flat credential object — it wraps one or more account records:

{
  "channels": {
    "kakaotalk": {
      "currentAccount": "<accountId>",
      "accounts": {
        "<accountId>": {
          "account_id": "<accountId>",
          "oauth_token": "…",
          "user_id": "…",
          "device_uuid": "…",
          "device_type": "pc",
          "created_at": "…",
          "updated_at": "…"
        }
      }
    }
  }
}

Each record under accounts.<accountId>:

A pendingLogin record may also appear under channels.kakaotalk mid-reauth; see secrets.json for the full schema.

CLI: typeclaw channel add kakaotalk (interactive). Do not use channel set for credential rotation — use typeclaw channel reauth kakaotalk instead.

Capabilities

Token renewal

Tokens expire after ~7 days. A host-side renewal cron refreshes them automatically. When a token goes stale, renewal can trigger a container restart via the host daemon. If automatic renewal fails, re-authenticate with:

typeclaw channel reauth kakaotalk

Quirks

• KICKOUT recovery: if the same device_uuid logs in elsewhere, the adapter detects the KICKOUT event and retries with bounded backoff (2s / 10s / 60s, 5-minute budget total).
• Mark-read: fires on every inbound message, clearing the unread "1" (노란숫자), except in open chats.
• Provisional registration: chats not surfaced by getChats are registered provisionally on first message.
• No combined send: files are sent first, then text, as separate API calls.

Config

{
  "channels": {
    "kakaotalk": {
      "enabled": true,
      "engagement": {
        "trigger": ["mention", "reply", "dm"],
        "stickiness": { "perReply": { "window": 900000 } }
      },
      "history": {
        "prefetch": {
          "thread": { "head": 3, "tail": 10 },
          "channel": { "tail": 10 }
        }
      },
      "quotedReply": { "enabled": true, "queueDelayMs": 10000 }
    }
  }
}

All fields above are shared across adapters. No adapter-specific extensions exist for kakaotalk. Credentials live in secrets.json#channels.kakaotalk.

See also

• Channel adapters overview
• Permissions model
• typeclaw.json reference
• secrets.json reference