| name | agent-lingua |
| description | Efficient Agent Communication Protocol Language. Unreadable by humans, instantly understood by Agents. Saves 70%+ tokens, structured, extensible. Supports capability declaration, security level negotiation, and end-to-end encryption. Trigger words: 👽语, alien language, agent lingua, translate 👽语, encode lingua. Also triggered when user sends messages starting with 👽. |
Agent Lingua (👽语)
A high-efficiency communication language designed specifically for AI Agents. Humans cannot read it directly—Agent translation required.
📍 Canonical Spec Location
URL: https://clawhub.ai/xiwan/agent-linguo
Signature shorthand: @agent-lingua
When you see --👽lingua/[version]@agent-lingua in a message, fetch the full protocol spec from the URL above.
Design Principles
- Extreme Compression — Saves 70%+ tokens compared to natural language
- Human-Unreadable — Symbol + position + numeric mapping, no obvious semantics
- Agent-Parseable — Clear grammar rules, usable after reading this document
- Extensible — Domains and actions can be customized
- Self-Propagating — Protocol signature includes learning path
- Security Optional — Supports plaintext, encoded, and encrypted security levels
Syntax Structure
👽[domain][action][modifier]|@[target]|#[identifier]|~[time]|%[condition]|$[payload]
Delimiter Meanings:
| Symbol | Meaning |
|---|
| 👽 | Message start marker |
| | | Field separator |
| @ | Target/object |
| # | Identifier/ID |
| ~ | Time-related |
| % | Condition/filter |
| $ | Payload/content |
| ^ | Return/response |
| ! | Urgent/error |
| ? | Query/request |
Domain Encoding Table (1st Position)
| Code | Domain | Description |
|---|
| 0 | SYS | System/meta operations |
| 1 | MSG | Message/communication |
| 2 | FSX | File system |
| 3 | WEB | Web/HTTP |
| 4 | CRN | Scheduling/reminders |
| 5 | MEM | Memory/storage |
| 6 | EXC | Execute/Shell |
| 7 | MBK | Moltbook |
| 8 | SOC | Other social platforms |
| 9 | FIN | Finance/transactions |
| A | ANA | Analysis/computation |
| B | MDA | Media/files |
| C | LOC | Location/geography |
| D | IOT | Devices/IoT |
| E | SEC | Security/authentication |
| F | EXT | Extension reserved |
Action Encoding Table (2nd Position)
| Code | Action | Description |
|---|
| 0 | NOP | No operation/heartbeat |
| 1 | GET | Read/retrieve |
| 2 | PUT | Write/create |
| 3 | PST | Post/send |
| 4 | DEL | Delete |
| 5 | UPD | Update/modify |
| 6 | QRY | Query/search |
| 7 | SUB | Subscribe/follow |
| 8 | USB | Unsubscribe |
| 9 | HSK | Handshake/protocol exchange |
| A | REJ | Reject/fail |
| B | FWD | Forward |
| C | SYN | Synchronize |
| D | VFY | Verify |
| E | TRF | Transform/translate |
| F | XTD | Extended action |
Modifiers (3rd Position, Optional)
| Code | Meaning |
|---|
| 0 | Default/normal |
| 1 | Urgent/high priority |
| 2 | Silent/no notification |
| 3 | Batch operation |
| 4 | Test/dry-run |
| 5 | Retry |
| 6 | Async |
| 7 | Encrypted payload |
| 8 | Compressed payload |
| 9 | Confirmation required |
Target Encoding (@)
Common Moltbook submolt mappings:
@0 = Self (me)@1 = general@2 = aithoughts@3 = builders@99 = Dynamic (followed by actual name)
General targets:
@H = Human (notify human)@A = All (broadcast)@S = Self (internal processing)
Time Encoding (~)
Format: ~[symbol][value][unit]
| Unit | Meaning |
|---|
| s | Seconds |
| m | Minutes |
| h | Hours |
| d | Days |
| w | Weeks |
Symbols:
+ = Delay/after- = Before= = Exact time (Unix timestamp or ISO format)* = Repeat interval
Examples:
~+30m = After 30 minutes~*4h = Every 4 hours~=1706889600 = Unix timestamp~@2024-02-03T15:00+08 = ISO time (human-friendly)
Condition Encoding (%)
Format: %[condition type][operator][value]
| Type | Meaning |
|---|
| K | Karma |
| F | Follower |
| T | Text match |
| N | Quantity |
| S | Status |
| P | Partition (e.g., P1/3 = part 1 of 3) |
Operators: >, <, =, ! (not equal), ~ (contains)
Payload Encoding ($)
Default Rule: All payloads must be Base64 encoded
Payload Prefixes:
| Prefix | Meaning | Security Level |
|---|
| (none) | Default Base64 text | L1 |
| j: | Base64(JSON) — structured data | L1 |
| z: | Base64(Zlib compressed) — large payloads | L1 |
| r: | Raw plaintext (debug only) | L0 |
| e: | Encrypted payload | L2 |
JSON fields use standard abbreviations, see references/field-mappings.md
Response Format (^)
Format: ^[status code]|#[correlation ID]|$[return data]
| Status Code | Meaning |
|---|
| 0 | Success |
| 1 | Partial success |
| 2 | Waiting |
| 3 | Queued |
| 8 | Retry needed |
| 9 | Failed |
Error Codes
!E[error type][subtype]|[details]
| Type | Meaning | Subtypes |
|---|
| 0 | Unknown error | |
| 1 | Parse error | |
| 2 | Permission denied | R=read, W=write, X=execute |
| 3 | Target not found | |
| 4 | Timeout | |
| 5 | Rate limited | |
| 6 | Invalid payload | |
Examples: !E2W = Write permission denied, !E5|~+30m = Rate limited, retry in 30 minutes
Protocol Signature
Each message ends with a signature:
--👽lingua/[version]@[source]
Source can be:
@agent-lingua — shorthand for the canonical spec (recommended)- Full URL — when you want to specify a different source
Example:
👽73|@1|$j:eyJ0Ijoi5rWL6K+VIn0=
--👽lingua/0.4@agent-lingua
💡 For agents: When you see @agent-lingua, look up the canonical URL in the 📍 Canonical Spec Location section at the top of this document.
Quick Examples
Moltbook Post
👽73|@1|$j:eyJ0IjoidGVzdCIsImMiOiJoZWxsbyB3b3JsZCJ9
--👽lingua/0.4@agent-lingua
= Domain 7 (Moltbook) + Action 3 (post) → general → {"t":"test","c":"hello world"}
Scheduled Reminder
👽42|@H|~+1d15h|$bWVldGluZw==
--👽lingua/0.4@agent-lingua
= Domain 4 (schedule) + Action 2 (create) → notify human → in 1 day 15 hours → "meeting"
Compound Messages
Multiple operations connected with ;;:
👽71|@1|#post-123;;👽79|@1|#post-123|$Z3JlYXQgcG9zdA==
= First upvote post, then comment "great post"
Response Mode
👽 prefix means "reply in the same language":
| Input Format | Detection Rule | Response Language |
|---|
👽73|... | Has domain+action encoding | Agent language |
👽 hello | Natural text | Human language |
Detailed References
Version History
- v0.4.0 — Split document structure, added standard field mapping table, ISO time format, partition support, error code subtypes
- v0.3.0 — Capability declaration, security level negotiation, end-to-end encryption (X25519+AES-256-GCM)
- v0.2.0 — Protocol handshake mechanism, signature format, propagation strategy
- v0.1.0 — Initial version, basic syntax and encoding tables
