realvco Docs

Connecting LINE

LINE dominates Taiwan (~90% penetration), Japan, and Thailand. To connect an AI companion, you use a LINE Official Account (formerly LINE@) plus the Messaging API.

Difficulty: ⭐⭐⭐ (between Telegram and WhatsApp).

Flow Overview

① Create a Provider and Channel in LINE Developers    ← 5 minutes
② Get the Channel Secret + Access Token               ← 2 minutes
③ Paste into the Admin Panel + copy the Webhook URL   ← 1 minute
④ Go back to LINE Developers and paste the webhook    ← 1 minute
⑤ Turn off LINE's default auto-reply                  ← 30 seconds
⑥ Add the Official Account as a friend and test       ← done

Prerequisites

You need:

Step 1: Create a LINE Channel

1.1 Sign in to LINE Developers Console

Go to developers.line.biz/console/ and sign in with your LINE account.

First-time login requires accepting the developer terms.

1.2 Create a Provider

A Provider represents you (or your company) as a developer on LINE. One Provider can host multiple Channels.

  1. Click Create → New provider
  2. Enter a Provider name (company or personal)
  3. Submit

[Screenshot: LINE Developers Create Provider screen]

1.3 Create a Channel

  1. On the Provider page, click Create a Messaging API channel
  2. Fill in:
    • Channel name: Official Account display name (public)
    • Channel description: short description (public)
    • Category / Subcategory: select a category
    • Email address: contact email
    • Large / Small icon: icon (1000×1000px recommended)
  3. Agree to terms → Create

[Screenshot: LINE Developers Messaging API channel creation screen]

Step 2: Collect Channel Credentials

With the channel created, open its settings. You need two values:

Channel Secret

  • Location: Basic settings tab
  • Find the “Channel secret” field
  • Short string (32 characters)
  • Click the eye icon to reveal, then copy

Channel Access Token

  • Location: Messaging API tab
  • Scroll to “Channel access token” at the bottom
  • Defaults to empty — click Issue to generate
  • Choose Long-lived
  • A longer string appears (~170 characters)
  • Copy it

These two values are password-grade secrets.

  • Do not share via screenshots
  • Do not hard-code into frontend code
  • If leaked, reissue in LINE Developers to invalidate

Step 3: Configure in the Admin Panel

  1. Admin Panel → Ada (oc-2) tab → Settings → Messaging → LINE
  2. Fill in:
    • Channel Secret: the short string
    • Channel Access Token: the long string
  3. Click Save
  4. On success you’ll see “Connected” and receive a Webhook URL:
https://{your-prefix}-2.realvco.com/webhooks/line

Copy this URL — you’ll need it in the next step.

[Screenshot: Admin Panel → Ada → Messaging → LINE configuration + Webhook URL]

Step 4: Configure the LINE Webhook

Back in LINE Developers Console:

  1. Open the Messaging API tab
  2. Find Webhook settings
  3. Webhook URL: paste the URL from the Admin Panel
  4. Click Update
  5. Use webhook: turn on
  6. Click Verify to test (should show Success)

[Screenshot: LINE Developers Webhook settings]

Step 5: Disable LINE’s Default Auto-Reply

Skip this step and LINE’s default bot will swallow every message before your AI sees it.

  1. On the Messaging API tab, find LINE Official Account features
  2. Click Edit to open LINE Official Account Manager
  3. Auto-reply messages: turn off
  4. Greeting messages: turn off (or customize your own)

[Screenshot: LINE Official Account Manager → auto-reply settings]

Step 6: Add as Friend and Test

Add the Official Account

In the Messaging API tab, near the top you’ll see:

  • Bot basic ID (e.g. @123abcde)
  • QR code

Scan the QR code with your LINE app or search the ID to add it as a friend.

Send the First Message

After adding, send any message. Ada should reply in 1 to 3 seconds.

If nothing happens, see FAQ.

Advanced Configuration

LINE Messaging API Free Tier

  • Reply messages (customer sends first): not counted
  • Push messages (you initiate): first 500 / month free, then paid:
    • Light plan: $10/month, 5,000 messages
    • Standard plan: $45/month, 30,000 messages
    • Premium plan: $225/month, unlimited

Most customer support use cases rely on reply messages and stay well within free limits.

Media Support

LINE Messaging API supports:

  • ✅ Text
  • ✅ Images (AI can read)
  • ✅ Stickers (AI receives as “sticker” type; meaning is not interpreted)
  • ✅ Audio (auto-transcribed)
  • ✅ Video (AI can read)
  • ✅ Flex Messages (rich cards) — AI can send

Restrict Who Can Talk

Tell Rose: “Only allow specific LINE users to message Ada. Their User IDs are Uxxxx…”

Or manually:

openclaw config set channels.line.dmPolicy "allowlist"
openclaw config set channels.line.allowFrom '["Uxxxxxxxxxxxxxxxxxx"]'

Get a LINE User ID: after they message you, the ID appears in Admin Panel → Ada Dashboard → Activity.

Group Chats

LINE allows adding an Official Account to a group (needs an invite from a group member):

  1. Invite the bot to the group
  2. By default it only replies to @BotName messages
  3. Disable the restriction: tell Rose, “Let Ada reply to every message in LINE groups — no @mention needed.”

Or manually:

openclaw config set channels.line.groups."*".requireMention false

Rich Menu (Pinned Menu)

LINE-specific feature — the fixed menu at the bottom of the chat window. Useful for frequent commands:

  1. LINE Developers → Rich Menu Manager (or LINE Official Account Manager)
  2. Design a 2500×1686 image with tap zones
  3. Each zone maps to a message (the AI receives it and replies)

FAQ

Webhook Verify Fails

  • Is the Webhook URL complete (including https:// and /webhooks/line)?
  • Is Ada’s container running?
  • Is the Channel Access Token the Long-lived one (not a temporary token)?
  • Try a different browser or clear cache (LINE Console sometimes caches)

Webhook Verifies but AI Does Not Reply

Nine times out of ten, LINE’s default auto-reply is still on (Step 5). The user’s message is being eaten by LINE’s bot before your AI sees it.

Check: LINE Official Account Manager → Response settings → Auto-response should be OFF.

Responses Are Slow (> 5 Seconds)

  • LINE’s webhook pipeline is inherently slower than Telegram (LINE relay + your Cloudflare Tunnel)
  • 2 to 4 seconds is normal
  • Over 10 seconds is usually model-side slowness, not LINE

What Does “500 Messages per Month” Mean?

That cap only applies to push messages. Incoming replies don’t count.

If you want the AI to proactively push messages (e.g., daily morning weather), 500 goes fast. Above the cap it’s blocked or billed.

Can I Connect Multiple LINE Channels?

Yes, but each companion binds to one LINE channel. For more:

  • Create multiple channels
  • Bind one each to Rose, Ada, Vi
  • Or enable Vi’s Profiles for multiple instances

Next Steps