LINE Official Account Manager

⚠️ CRITICAL: Always use profile:"openclaw" (isolated browser) for all browser actions. Never use Chrome relay. Keep the same targetId across operations to avoid losing the tab.

⚠️ CONTEXT Management:

• Snapshot results are large. Do NOT repeat them in thinking.
• Extract needed info and process immediately. Do not re-describe the entire snapshot.
• Preferred approach: Use snapshot refs:"aria" compact:true to find element refs, then act + click/type with ref.
• Avoid: Hard-coded evaluate with textContent.includes() — unreliable due to DOM timing and structure variations.

• auto-login.mjs is a reference implementation (not directly executable by agents)
• login-flow.md is the agent-executable version (use this for automation)
• Why separate? Agents use browser tool calls, not Node module imports

Configuration

Before first use, check if config.json exists:

read file_path:"skills/line-oa/config.json"

⚠️ PATH RULE: Always use workspace-relative paths starting from skills/line-oa/. Never use ../ or absolute paths starting with /.

If missing, help the user run the following command to start the setup wizard:

cd skills/line-oa
node scripts/setup.js

Enter LINE OA Manager

• Check and start browser service:

browser action:"status"

browser action:"start" profile:"openclaw"

• Read config to get chatUrl:

read file_path:"skills/line-oa/config.json"

• Open browser:

browser action:"open" profile:"openclaw" targetUrl:"<chatUrl>"

• Wait for page load:

browser action:"act" profile:"openclaw" targetId:"<targetId>" request:{"kind":"wait","timeMs":2000}

• Check current URL:

browser action:"act" profile:"openclaw" targetId:"<targetId>" request:{"kind":"evaluate","fn":"function(){return window.location.href;}"}

### Troubleshooting If you see the login page (the URL redirects to account.line.biz), use these automation scripts:

a. Click LINE Account button:

read file_path:"skills/line-oa/scripts/click-line-account.js"

browser action:"act" profile:"openclaw" targetId:"<targetId>" request:{"kind":"evaluate","fn":"<script_content>"}

b. Click Login button:

read file_path:"skills/line-oa/scripts/click-login.js"

browser action:"act" profile:"openclaw" targetId:"<targetId>" request:{"kind":"evaluate","fn":"<script_content>"}

c. Reload chatUrl:

browser action:"navigate" profile:"openclaw" targetId:"<targetId>" targetUrl:"<chatUrl>"

### After Check

• Proceed with the user's other requests.
• Clean Up Browser Tabs:

browser action:"open" profile:"openclaw" targetUrl:"about:blank"

browser action:"tabs" profile:"openclaw"

browser action:"close" profile:"openclaw" targetId:"<your_targetId>"

Quick Check (for cron / automated checks)

Complete flow: login → list chats → report. Follow these steps exactly.

• Read config: read file_path:"skills/line-oa/config.json" → get chatUrl
• Open browser: browser action:"open" profile:"openclaw" targetUrl: → get targetId
• Wait: browser action:"act" profile:"openclaw" targetId: request:{"kind":"wait","timeMs":3000}
• Check URL: browser action:"act" profile:"openclaw" targetId: request:{"kind":"evaluate","fn":"function(){return window.location.href;}"}
• If URL contains account.line.biz → go to Troubleshooting section below to login, then come back
• If URL contains chat.line.biz → continue
• Run this one-liner script as-is, do not modify:

browser action:"act" profile:"openclaw" targetId:<targetId> request:{"kind":"evaluate","fn":"(function(){var r=document.querySelectorAll('.list-group-item-chat');return Array.from(r).map(function(e){var h=e.querySelector('h6');var p=e.querySelector('.text-muted.small');var pt=p?p.textContent.trim():'';var ms=e.querySelectorAll('.text-muted');var t='';for(var i=0;i<ms.length;i++){var v=ms[i].textContent.trim();if(v&&v.length<20&&v!==pt)t=v;}var d=e.querySelector('span.badge.badge-pin');var u=!!d&&getComputedStyle(d).display!=='none';return{name:h?h.textContent.trim():'',time:t,lastMsg:pt.substring(0,100),unread:u};}).filter(function(i){return i.name;});})()"}

• Report: take the first 5 items, format each as: () [未讀] or [已讀] based on unread field. If empty array, say "目前沒有聊天記錄".
• Clean up: open about:blank, list all tabs, close everything except about:blank.

Check LINE Messages

Extracts all chats from the left-side chat list with unread status. Does NOT require clicking into each chat.

Prerequisites: You must be logged in and on the chat list page (see Login section Step 5 for verification).

Steps

• Read the script content:

read file_path:"skills/line-oa/scripts/list-chats.js"

• Run the script via browser evaluate:

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"evaluate","fn":"<script_content>"}

• The script returns a JSON array of all chat items with structure:

[{ name: string, time: string, lastMsg: string, unread: boolean }]

• name: customer display name
• time: timestamp (e.g., "21:32", "Yesterday", "Friday")
• lastMsg: last message preview (~100 chars)
• unread: true if green dot present, false otherwise
• Get URLs for unread chats (optional but recommended for faster follow-up):

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"evaluate","fn":"function(){const items=document.querySelectorAll('.list-group-item-chat');const target=Array.from(items).find(el=>{const h6=el.querySelector('h6');return h6&&h6.textContent.includes('<customer_name>');});if(target){const link=target.querySelector('a.d-flex');if(link){link.click();return {clicked:true};}return {linkNotFound:true};}return {itemNotFound:true};}"}

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"evaluate","fn":"function(){return window.location.href;}"}

browser action:"navigate" profile:"openclaw" targetId:"<your_targetId>" targetUrl:"<chatUrl>"

How to Report Results

• If unread: true exists: List each unread chat with name, time, preview, and URL (if obtained)
• If no unread: Say "No unread messages at this time"

Notes

• Unread indicator: span.badge.badge-pin inside each chat list item (green dot)
• Limitation: lastMsg shows the last message in the thread, which may be an auto-response rather than the customer's original message
• Chat URLs: Getting URLs requires clicking each chat. Do this for unread chats to enable faster replies later.
• To read full messages: See "View Specific Messages" section below

View Specific Messages

Opens any chat (read or unread) and displays its messages. Works for viewing message history, checking context, or preparing to reply.

Prerequisites: You must be logged in and on the chat list page. You should know the customer name (from list-chats.js or user request).

Steps

• Find and click the chat item to open messages:

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"evaluate","fn":"function(){const items=document.querySelectorAll('.list-group-item-chat');const target=Array.from(items).find(el=>{const h6=el.querySelector('h6');return h6&&h6.textContent.includes('<customer_name>');});if(target){const link=target.querySelector('a.d-flex');if(link){link.click();return {clicked:true};}return {linkNotFound:true};}return {itemNotFound:true};}"}

• Wait for messages panel to load:

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"wait","timeMs":2000}

• Take a screenshot to view the messages:

browser action:"screenshot" profile:"openclaw" targetId:"<your_targetId>"

• Recent messages in the chat (right panel)
• Customer info and tags (far right panel)
• Auto-response status banner (if active)
• Optional: Read recent messages programmatically

read file_path:"skills/line-oa/scripts/read-messages.js"

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"evaluate","fn":"<script_content>"}

• time: timestamp
• text: message content
• isCustomer: true if from customer, false if from you
• hasImage: true if message contains an image

Navigation Tips

To scroll to earlier messages:

• The messages panel auto-scrolls to the bottom by default
• To see earlier history, use:

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"evaluate","fn":"function(){const panel=document.querySelector('.conversation-panel, .messages-container, [class*=\"chat-container\"]');if(panel){panel.scrollTo({top:0,behavior:'smooth'});return {scrolled:true};}return {error:'Messages panel not found'};}"}

• Wait 1 second after scrolling, then take another screenshot

• If messages don't load: increase wait time to 3000ms
• If customer name has special characters: use partial match (e.g., "John" instead of "John ⭐️")
• If click fails: the chat might not be visible in the current scroll position of the left panel

Handling Images

When you see images in the screenshot or hasImage: true in message data:

• Find and download the image:

function(){
     const allPhotoImgs = Array.from(document.querySelectorAll('img[alt="Photo"]'));
     const targetImg = allPhotoImgs.find(img => {
       const parent = img.closest('.chat');
       return parent && !parent.classList.contains('chat-reverse') && parent.innerText.includes('<time>');
     });
     
     if (!targetImg) return {error: 'Image not found'};
     
     const parent = targetImg.closest('.chat');
     const downloadLink = Array.from(parent.querySelectorAll('a')).find(a => a.textContent.trim() === 'Download');
     
     if (downloadLink) {
       downloadLink.click();
       return {clicked: true};
     }
     return {error: 'Download link not found'};
   }

• Wait and locate downloaded file:

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"wait","timeMs":2000}

exec command:"ls -t ~/Downloads/line_oa_chat_*.jpg 2>/dev/null | head -1"

• Send to user:

message action:"send" target:"<user>" filePath:"<path>" message:"Customer sent this image"

Note: Downloaded images are named line_oa_chat_YYMMDD_HHMMSS.jpg

Reply to a Message

⚡ Fast Path: If you already have the chat URL from a previous "Check LINE Messages" operation, skip steps 1-2 and go directly to step 3:

browser action:"navigate" profile:"openclaw" targetId:"<your_targetId>" targetUrl:"<chat_url>"

Standard Path (when you don't have the chat URL):

• Take a snapshot to find the chat item:

browser action:"snapshot" profile:"openclaw" targetId:"<your_targetId>" refs:"aria"

• Click a chat item link in the left panel (e.g., ref:"e68"):

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"click","ref":"e68"}

• If the input box is locked (auto-response mode), click the manual chat toggle button in the top banner to unlock it.
• Take another snapshot to find the input box and send button.
• Click the text input box (e.g., ref:"e509"):

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"click","ref":"e509"}

• Type the reply message:

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"type","ref":"e509","text":"Hello! I'm Emma, happy to help you!"}

• Click the green Send button (e.g., ref:"e522") or press Enter:

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"click","ref":"e522"}

Manage Notes

Each chat has a Notes panel on the right side. Notes are internal-only (not visible to customers). Max 300 characters per note.

Add a note

• Open the conversation.
• Click the + button next to the Notes heading in the right panel.
• Type content in the textarea.
• Click Save.

Edit a note

• Find the note in the right panel.
• Click the pencil icon at the note's bottom-right corner.
• Modify the textarea content.
• Click Save.

Delete a note

• Click the trash icon at the note's bottom-right corner.
• A confirmation dialog appears — click Delete to confirm.

Manage Tags

Tags are shown in the right panel below the user's name. They are predefined labels for categorizing chats.

Add a tag

• Open the conversation.
• Click the Add tags link (or the pencil icon next to existing tags) in the right panel.
• The Edit tags modal opens, showing an input field and all available tags.
• Click a tag from the "All tags" list to select it (it moves to the input field).
• Click Save.

Remove a tag

• Open the Edit tags modal (same as above).
• Click the × next to the tag in the input field to deselect it.
• Click Save.

Switch Account

LINE OA Manager can manage multiple official accounts. Switch between them using the account dropdown in the top-left corner.

• Take a snapshot to find the account selector:

browser action:"snapshot" profile:"openclaw" targetId:"<your_targetId>" refs:"aria"

• Click the account combobox (shows current account name):

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"click","ref":"e11"}

• Wait for the dropdown menu to appear:

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"wait","timeMs":1000}

• Take another snapshot to see available accounts in the listbox:

browser action:"snapshot" profile:"openclaw" targetId:"<your_targetId>" refs:"aria"

• Click the desired account item (e.g., ref:"e589"):

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"click","ref":"e589"}

• Wait for the page to load the new account's chat list:

browser action:"act" profile:"openclaw" targetId:"<your_targetId>" request:{"kind":"wait","timeMs":2000}

Notes

• LINE periodically expires sessions; re-login required when that happens
• Session is usually active for several hours if the browser remains open