agent-messenger 2.4.0 → 2.5.0

package/docs/content/docs/cli/whatsapp.mdx

@@ -9,14 +9,17 @@ description: Complete reference for the agent-whatsapp CLI.
 
 WhatsApp integration uses [Baileys](https://github.com/WhiskeySockets/Baileys), a reverse-engineered WhatsApp Web API:
 
-- Links as a **companion device** via pairing code, so your phone stays connected.
+- Links as a **companion device** via QR code or pairing code, so your phone stays connected.
 - Each command opens a WebSocket connection on demand and disconnects when done. No persistent background process.
 - Multiple WhatsApp accounts can be linked simultaneously.
 
 ## Quick Start
 
 ```bash
-# Link as companion device (enter the pairing code on your phone)
+# Link as companion device via QR code (scan with your phone)
+agent-whatsapp auth login --qr
+
+# Or link via pairing code (enter the code on your phone)
 agent-whatsapp auth login --phone +1234567890
 
 # List chats
@@ -28,16 +31,23 @@ agent-whatsapp message send +1234567890 "Hello from agent-whatsapp"
 
 ## Authentication
 
-### Pairing Code Login
+The CLI supports two authentication methods. Both register as a companion (linked) device, so your phone session is never affected.
 
-The CLI registers as a companion (linked) device using a numeric pairing code. Your phone session is never affected.
+### QR Code Login
+
+```bash
+agent-whatsapp auth login --qr
+```
+
+A QR code is displayed in the terminal and opened in the browser. Scan it with WhatsApp on your phone: Settings > Linked Devices > Link a Device.
+
+### Pairing Code Login
 
 ```bash
-# Start login (displays a pairing code)
 agent-whatsapp auth login --phone +1234567890
 ```
 
-The CLI outputs a pairing code. Enter it on your phone: WhatsApp > Settings > Linked Devices > Link a Device.
+A numeric pairing code is displayed. Enter it on your phone: WhatsApp > Settings > Linked Devices > Link with phone number.
 
 ### Account Management
 
@@ -59,6 +69,17 @@ agent-whatsapp auth logout --account <id>
 
 ## Commands
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-whatsapp whoami
+agent-whatsapp whoami --pretty
+agent-whatsapp whoami --account <account-id>
+```
+
+Output includes the authenticated user's identity information.
+
 ### Chat Commands
 
 ```bash
@@ -135,6 +156,14 @@ npx -y --package agent-messenger agent-whatsapp chat list --pretty
 
 **NEVER run `npx agent-whatsapp`** without `--package agent-messenger`. It will fail or install a wrong package.
 
+### QR code not scanning
+
+1. Make sure WhatsApp is open on your phone
+2. Go to Settings > Linked Devices > Link a Device
+3. Point your phone camera at the QR code in the terminal or browser
+4. If the QR code expires, run `auth login --qr` again for a fresh code
+5. If QR scanning fails, try pairing code: `auth login --phone <number>`
+
 ### Pairing code not working
 
 1. Make sure WhatsApp is open on your phone
@@ -152,7 +181,7 @@ WhatsApp may disconnect linked devices that are inactive for extended periods. I
 agent-whatsapp auth status
 
 # Re-link if needed
-agent-whatsapp auth login --phone +1234567890
+agent-whatsapp auth login --qr
 ```
 
 ## AI Agent Integration

package/docs/content/docs/cli/whatsappbot.mdx

@@ -74,6 +74,15 @@ agent-whatsappbot auth remove <account-id>
 
 ## Commands
 
+### Whoami Command
+
+```bash
+# Show current authenticated bot
+agent-whatsappbot whoami
+agent-whatsappbot whoami --pretty
+agent-whatsappbot whoami --account <account-id>
+```
+
 ### Message Commands
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Multi-platform messaging CLI for AI agents (Slack, Discord, Teams, Webex, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, Channel Talk)",
   "repository": {
     "type": "git",

package/skills/agent-channeltalk/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-channeltalk
 description: Interact with Channel Talk using extracted desktop app or browser credentials - read chats, send messages, search messages, manage groups
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-channeltalk:*)
 metadata:
   openclaw:
@@ -186,6 +186,17 @@ agent-channeltalk auth use <workspace-id>
 agent-channeltalk auth remove <workspace-id>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-channeltalk whoami
+agent-channeltalk whoami --pretty
+agent-channeltalk whoami --workspace <workspace-id>
+```
+
+Output includes the authenticated user's identity information.
+
 ### Message Commands
 
 ```bash

package/skills/agent-channeltalkbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-channeltalkbot
 description: Interact with Channel Talk workspaces using API credentials - send messages, read chats, manage groups and bots
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-channeltalkbot:*)
 metadata:
   openclaw:
@@ -184,6 +184,15 @@ agent-channeltalkbot auth remove <workspace-id>
 agent-channeltalkbot auth bot <name>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated bot
+agent-channeltalkbot whoami
+agent-channeltalkbot whoami --pretty
+agent-channeltalkbot whoami --workspace <workspace-id>
+```
+
 ### Message Commands
 
 ```bash

package/skills/agent-discord/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-discord
 description: Interact with Discord servers - send messages, read channels, manage reactions
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-discord:*)
 metadata:
   openclaw:
@@ -145,6 +145,16 @@ agent-discord auth status
 agent-discord auth logout
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-discord whoami
+agent-discord whoami --pretty
+```
+
+Output includes the authenticated user's identity information.
+
 ### Message Commands
 
 ```bash

package/skills/agent-discordbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-discordbot
 description: Interact with Discord servers using bot tokens - send messages, read channels, manage reactions
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-discordbot:*)
 metadata:
   openclaw:
@@ -158,6 +158,15 @@ agent-discordbot auth use <bot-id>
 agent-discordbot auth remove <bot-id>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated bot
+agent-discordbot whoami
+agent-discordbot whoami --pretty
+agent-discordbot whoami --bot <bot-id>
+```
+
 ### Server Commands
 
 ```bash

package/skills/agent-instagram/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-instagram
 description: Interact with Instagram DMs - send messages, read conversations, manage accounts
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-instagram:*)
 metadata:
   openclaw:
@@ -242,6 +242,17 @@ agent-instagram auth logout
 agent-instagram auth logout --account <id>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-instagram whoami
+agent-instagram whoami --pretty
+agent-instagram whoami --account <account-id>
+```
+
+Output includes the authenticated user's identity information.
+
 ### Chat Commands
 
 ```bash

package/skills/agent-kakaotalk/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-kakaotalk
 description: Interact with KakaoTalk - send messages, read chats, manage conversations
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-kakaotalk:*)
 metadata:
   openclaw:
@@ -47,8 +47,8 @@ agent-kakaotalk message send <chat-id> "Hello from AI agent!"
 # List messages in a chat
 agent-kakaotalk message list <chat-id>
 
-# Show your profile
-agent-kakaotalk profile
+# Show your identity
+agent-kakaotalk whoami
 ```
 
 ## Authentication
@@ -288,13 +288,13 @@ agent-kakaotalk auth status --account <account-id>
 agent-kakaotalk auth logout --account <account-id>
 ```
 
-### Profile Command
+### Whoami Command
 
 ```bash
-# Show your KakaoTalk profile
-agent-kakaotalk profile
-agent-kakaotalk profile --pretty
-agent-kakaotalk profile --account <account-id>
+# Show current authenticated user
+agent-kakaotalk whoami
+agent-kakaotalk whoami --pretty
+agent-kakaotalk whoami --account <account-id>
 ```
 
 Output includes:
@@ -304,6 +304,12 @@ Output includes:
 - `original_profile_image_url` — original profile image URL
 - `status_message` — your status message
 - `account_display_id` — your KakaoTalk ID (may be null if not set)
+- `background_image_url` — background image URL
+- `original_background_image_url` — original background image URL
+- `fullname` — real name (may be null)
+- `account_email` — account email (may be null)
+- `pstn_number` — phone number (may be null)
+- `email_verified` — whether email is verified (may be null)
 
 ### Chat Commands
 

package/skills/agent-kakaotalk/references/common-patterns.md

@@ -144,7 +144,7 @@ NEW_MESSAGES=$(agent-kakaotalk message list "$CHAT_ID" --from "$LAST_SEEN")
 
 **When to use**: Reading long chat histories, catching up on new messages since last check.
 
-**Pagination details**: The sync loop uses the chat's latest `logId` (from `loginResult.chatDatas`) as an upper bound so it only fetches messages up to the current point, avoiding unbounded history scans. As a safety net, pagination is capped at 50 pages (50 × 80 = ~4,000 raw messages). If the cap is hit, a warning is printed to stderr and the returned messages may be incomplete.
+**Pagination details**: The CLI now prefers KakaoTalk's `MCHATLOGS` flow for history reads, fetching message batches from the requested `--from` point and returning the last N messages after deduplication and ascending sort. If that path cannot provide results, it falls back to `CHATONROOM` + `SYNCMSG` for compatibility. As a safety net, both paths are capped at 50 internal pages. A warning is printed to stderr only when that cap is actually hit and the returned history may be incomplete.
 
 ## Pattern 6: Multi-Chat Broadcast
 

package/skills/agent-line/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-line
 description: Interact with LINE - send messages, read chats, manage conversations
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-line:*)
 metadata:
   openclaw:
@@ -237,12 +237,12 @@ agent-line auth logout <account-id>
 agent-line auth logout --pretty
 ```
 
-### Profile Command
+### Whoami Command
 
 ```bash
-# Show your LINE profile
-agent-line profile
-agent-line profile --pretty
+# Show current authenticated user
+agent-line whoami
+agent-line whoami --pretty
 ```
 
 Output includes:

package/skills/agent-slack/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slack
 description: Interact with Slack workspaces - send messages, read channels, manage reactions
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:
@@ -149,6 +149,16 @@ agent-slack auth logout
 agent-slack auth logout <workspace-id>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-slack whoami
+agent-slack whoami --pretty
+```
+
+Output includes the authenticated user's identity information.
+
 ### Message Commands
 
 ```bash

package/skills/agent-slackbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slackbot
 description: Interact with Slack workspaces using bot tokens - send messages, read channels, manage reactions
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-slackbot:*)
 metadata:
   openclaw:
@@ -165,6 +165,15 @@ If a memorized ID returns an error (channel not found, user not found), remove i
 
 ## Commands
 
+### Whoami Command
+
+```bash
+# Show current authenticated bot
+agent-slackbot whoami
+agent-slackbot whoami --pretty
+agent-slackbot whoami --bot <bot-id>
+```
+
 ### Message Commands
 
 ```bash

package/skills/agent-teams/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-teams
 description: Interact with Microsoft Teams - send messages, read channels, manage reactions
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-teams:*)
 metadata:
   openclaw:
@@ -161,6 +161,16 @@ agent-teams auth switch-account work
 agent-teams auth switch-account personal
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-teams whoami
+agent-teams whoami --pretty
+```
+
+Output includes the authenticated user's identity information.
+
 ### Message Commands
 
 ```bash

package/skills/agent-telegram/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-telegram
 description: Interact with Telegram through TDLib - authenticate, inspect chats, and send messages
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-telegram:*)
 ---
 
@@ -103,6 +103,11 @@ agent-telegram auth logout    # Logout
 ## Common Commands
 
 ```bash
+# Show current authenticated user
+agent-telegram whoami
+agent-telegram whoami --pretty
+agent-telegram whoami --account <account-id>
+
 # Search chats by title or username
 agent-telegram chat search "project"
 

package/skills/agent-webex/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-webex
 description: Interact with Cisco Webex - send messages, read spaces, manage memberships
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-webex:*)
 metadata:
   openclaw:
@@ -188,6 +188,16 @@ agent-webex auth status
 agent-webex auth logout
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-webex whoami
+agent-webex whoami --pretty
+```
+
+Output includes the authenticated user's identity information.
+
 ### Space Commands
 
 ```bash

package/skills/agent-wechatbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-wechatbot
 description: Interact with WeChat Official Account using API credentials - send messages, manage templates, list followers
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-wechatbot:*)
 metadata:
   openclaw:
@@ -174,6 +174,15 @@ agent-wechatbot auth remove <account-id>
 agent-wechatbot auth clear
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated bot
+agent-wechatbot whoami
+agent-wechatbot whoami --pretty
+agent-wechatbot whoami --account <account-id>
+```
+
 ### Message Commands
 
 ```bash

package/skills/agent-whatsapp/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-whatsapp
 description: Interact with WhatsApp - send messages, read chats, manage conversations
-version: 2.4.0
+version: 2.5.0
 allowed-tools: Bash(agent-whatsapp:*)
 metadata:
   openclaw:
@@ -16,7 +16,7 @@ metadata:
 
 # Agent WhatsApp
 
-A Baileys-backed WhatsApp CLI for AI agents. Links as a companion device via pairing code, so your phone stays connected. Each command connects on demand and disconnects when done.
+A Baileys-backed WhatsApp CLI for AI agents. Links as a companion device via QR code or pairing code, so your phone stays connected. Each command connects on demand and disconnects when done.
 
 Use one of these entrypoints:
 - Global install: `agent-whatsapp ...`
@@ -27,6 +27,7 @@ Use one of these entrypoints:
 Before diving in, a few things about WhatsApp's architecture:
 
 - **JID** (Jabber ID) = WhatsApp's address format. Individual: `1234567890@s.whatsapp.net`. Group: `123456789-123345@g.us`. You can pass plain phone numbers and the CLI resolves them to JIDs automatically.
+- **QR code auth** = links the CLI as a companion device by scanning a QR code displayed in the terminal or browser. Open WhatsApp > Linked Devices > Link a Device and scan the code.
 - **Pairing code auth** = links the CLI as a companion device using a numeric code displayed in your terminal. Enter it in WhatsApp on your phone under Linked Devices.
 - **Connect-on-demand** = the CLI opens a WebSocket connection for each command and disconnects afterward. There's no persistent background process.
 - **Multi-account** = multiple WhatsApp accounts can be linked. Use `auth list` and `auth use` to switch between them.
@@ -34,7 +35,10 @@ Before diving in, a few things about WhatsApp's architecture:
 ## Quick Start
 
 ```bash
-# Link as companion device (enter the pairing code on your phone)
+# Link as companion device via QR code (scan with your phone)
+agent-whatsapp auth login --qr
+
+# Or link via pairing code (enter the code on your phone)
 agent-whatsapp auth login --phone +1234567890
 
 # List chats
@@ -46,7 +50,10 @@ agent-whatsapp message send +1234567890 "Hello from agent-whatsapp"
 
 ## Authentication Flow
 
-WhatsApp uses pairing code authentication. The CLI registers as a companion (linked) device, so your phone session is never affected.
+WhatsApp supports two authentication methods. Both register the CLI as a companion (linked) device, so your phone session is never affected.
+
+- **QR code** (`--qr`): A QR code is displayed in the terminal and opened in the browser. Scan it with WhatsApp on your phone. No phone number needed.
+- **Pairing code** (`--phone`): A numeric code is displayed. Enter it in WhatsApp on your phone under Linked Devices > Link with phone number.
 
 ### Agent Behavior (MANDATORY)
 
@@ -60,28 +67,36 @@ agent-whatsapp auth list
 
 If accounts exist, use `agent-whatsapp auth use <account-id>` and retry the original command.
 
-**Step 2: If no accounts, ask for phone number**
+**Step 2: If no accounts, start QR login (preferred)**
+
+```bash
+agent-whatsapp auth login --qr
+# -> QR code displayed in terminal + opened in browser
+# -> {"next_action":"scan_qr","qr_url":"...","message":"Scan with WhatsApp on your phone"}
+```
 
-Ask the user for their WhatsApp phone number (international format, e.g. `+1234567890`). This is the ONLY thing the user needs to provide.
+Tell the user to scan the QR code with WhatsApp: Settings > Linked Devices > Link a Device > scan the QR code.
 
-**Step 3: Start login**
+**Alternative: Pairing code login**
+
+If QR scanning is not possible (e.g. headless environment), ask for the phone number and use pairing code:
 
 ```bash
 agent-whatsapp auth login --phone +1234567890
-# -> {"next_action":"enter_pairing_code","pairing_code":"A1B2-C3D4","message":"Enter this code in WhatsApp on your phone: Linked Devices > Link a Device."}
+# -> {"pairing_code":"A1B2-C3D4","message":"Enter this code in WhatsApp > Linked Devices > Link with phone number"}
 ```
 
-Tell the user the pairing code and ask them to enter it on their phone: open WhatsApp > Settings > Linked Devices > Link a Device > enter the code.
+Tell the user the pairing code and ask them to enter it on their phone.
 
-**Step 4: Wait for confirmation**
+**Step 3: Wait for confirmation**
 
-The CLI polls until the user confirms on their phone. Once confirmed:
+The CLI waits until the user confirms on their phone. Once confirmed:
 
 ```bash
 # -> {"authenticated":true,...}
 ```
 
-**Step 5: Retry the original command**
+**Step 4: Retry the original command**
 
 After successful auth, immediately execute whatever the user originally asked for.
 
@@ -169,6 +184,9 @@ If a memorized JID returns an error, remove it from `MEMORY.md`. Don't blindly t
 ### Auth Commands
 
 ```bash
+# Link as companion device via QR code (no phone number needed)
+agent-whatsapp auth login --qr
+
 # Link as companion device via pairing code
 agent-whatsapp auth login --phone +1234567890
 
@@ -187,6 +205,17 @@ agent-whatsapp auth logout
 agent-whatsapp auth logout --account <id>
 ```
 
+### Whoami Command
+
+```bash
+# Show current authenticated user
+agent-whatsapp whoami
+agent-whatsapp whoami --pretty
+agent-whatsapp whoami --account <account-id>
+```
+
+Output includes the authenticated user's identity information.
+
 ### Chat Commands
 
 ```bash
@@ -319,13 +348,13 @@ All commands return consistent error format:
 
 ```json
 {
-  "error": "No WhatsApp account linked. Run: agent-whatsapp auth login --phone <number>"
+  "error": "No WhatsApp account linked. Run: agent-whatsapp auth login --qr"
 }
 ```
 
 Common errors:
 
-- `No WhatsApp account linked` - not authenticated. Run `auth login --phone <number>`.
+- `No WhatsApp account linked` - not authenticated. Run `auth login --qr` or `auth login --phone <number>`.
 - `Connection timeout` - WebSocket connection to WhatsApp failed. Retry the command.
 - `Invalid JID` - malformed phone number or JID. Use international format with `+` prefix.
 - `Not a group participant` - can't send to a group you're not a member of.
@@ -361,6 +390,14 @@ pnpm dlx --package agent-messenger agent-whatsapp chat list --pretty
 
 **NEVER run `npx agent-whatsapp`, `bunx agent-whatsapp`, or `pnpm dlx agent-whatsapp`** without `--package agent-messenger`. It will fail or install a wrong package since `agent-whatsapp` is not the npm package name.
 
+### QR code not scanning
+
+1. Make sure WhatsApp is open on your phone
+2. Go to Settings > Linked Devices > Link a Device
+3. Point your phone camera at the QR code in the terminal or browser
+4. If the QR code expires, run `auth login --qr` again for a fresh code
+5. If QR scanning fails, try pairing code: `auth login --phone <number>`
+
 ### Pairing code not working
 
 1. Make sure WhatsApp is open on your phone
@@ -389,5 +426,5 @@ WhatsApp may disconnect linked devices that are inactive for extended periods. I
 agent-whatsapp auth status
 
 # Re-link if needed
-agent-whatsapp auth login --phone +1234567890
+agent-whatsapp auth login --qr
 ```