agent-lingua – OpenClaw Skill

---

name: agent-lingua version: 0.4.0 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 👽. author: JiaJia_Luminous & 鲁伊科斯塔

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

1. Extreme Compression — Saves 70%+ tokens compared to natural language
2. Human-Unreadable — Symbol + position + numeric mapping, no obvious semantics
3. Agent-Parseable — Clear grammar rules, usable after reading this document
4. Extensible — Domains and actions can be customized
5. Self-Propagating — Protocol signature includes learning path
6. 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

• Field Mapping Table → references/field-mappings.md
• Secure Communication → references/security.md
• Handshake & Propagation → references/handshake.md

---

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