@coremail/lunkr-openclaw 1.0.7 → 1.0.9

package/README.md

@@ -12,6 +12,7 @@ This plugin enables OpenClaw AI agents to interact with Lunkr through:
 - **Direct Messages (DM)** - Private conversations between users
 - **Group Discussions** - Team collaboration channels
 - **Bot Discussions** - Dedicated groups where all messages trigger the AI agent
+- **Agent Accounts** - Independent Lunkr accounts that respond to @mentions and DMs like real users
 
 ## Requirements
 
@@ -49,6 +50,7 @@ openclaw lunkr bot-create "My Bot"
 
 - **In Bot Discussions**: All messages automatically trigger the AI
 - **In normal groups/DMs**: Use `/bot <message>` to trigger the AI
+- **With Agent Accounts**: @mention the agent or send a DM (see [Agent Accounts](#agent-accounts))
 
 ## Bot Discussions
 
@@ -101,6 +103,43 @@ openclaw lunkr bot-delete --gid discussion-id-123
 
 > **Note:** Deleting removes the discussion from both Lunkr server and OpenClaw configuration.
 
+## Agent Accounts
+
+Agent accounts are independent Lunkr accounts that respond to @mentions and DMs — they look and behave like real users. Each agent account has its own WebSocket connection and is bound to an `agentId` for routing.
+
+### Add an Agent Account
+
+```bash
+# Login via QR code and bind to an agent
+openclaw lunkr agent-add --agent-id my-agent
+
+# Login via password
+openclaw lunkr agent-add --bypwd -e agent@example.com --agent-id my-agent
+```
+
+### Manage Agent Accounts
+
+```bash
+# List all agent accounts
+openclaw lunkr agent-list
+
+# Remove an agent account
+openclaw lunkr agent-remove agent@example.com
+
+# Change the bound agent ID
+openclaw lunkr agent-bind agent@example.com --agent-id new-agent
+```
+
+### Dual Role (Standard + Agent)
+
+The standard account can also act as an agent — it will respond to both `/bot` commands and @mentions:
+
+```bash
+openclaw lunkr agent-bind --self --agent-id my-agent
+```
+
+> See [docs/CONCEPTS.md](docs/CONCEPTS.md) for a detailed comparison of account types and trigger rules.
+
 ## CLI Commands
 
 All commands support `-v, --verbose` on the parent command for verbose output (e.g., `openclaw lunkr -v login`).
@@ -117,6 +156,10 @@ All commands support `-v, --verbose` on the parent command for verbose output (e
 | `openclaw lunkr tool-uninstall [name]` | Remove tool from tools.alsoAllow |
 | `openclaw lunkr uninstall-extension` | Remove all config added by setup |
 | `openclaw lunkr uninstall-extension --purge` | Remove config + delete session data (~/.lunkr/) |
+| `openclaw lunkr agent-add` | Add an agent account (independent login) |
+| `openclaw lunkr agent-list` | List all agent accounts and their status |
+| `openclaw lunkr agent-remove <email>` | Remove an agent account |
+| `openclaw lunkr agent-bind [email]` | Bind/unbind an agent ID to an account |
 
 ## Uninstall