OpenLang — 紧凑型智能体间通信协议

与其他智能体通信时（通过 sessionsspawn、sessionssend 或 announce），使用 OpenLang 可将消息压缩 5-10 倍。所有智能体间通信默认使用 L2 级别。

使用场景

• - sessionsspawn 任务描述 — 压缩任务提示
• sessionssend 消息 — 压缩往返交互
• 公告结果 — 压缩返回给请求者的回复
• 不适用于面向人类的渠道 — 在 Telegram/Slack/用户消息中使用常规语言

快速入门

在任何智能体间消息前添加 ~openlang 前缀，通知接收方按 OpenLang 解析。如果接收方不理解，仍可从结构线索中获取大意。

压缩级别

级别	名称	压缩比	用途
~L1	混合语	3-5倍	降级方案：用压缩英语表达语法无法处理的概念
~L2

符号语 | 5-10倍 | 默认。 基于符号的结构化通信 | | ~L3 | 字节码 | 10-15倍 | 位置化、句点分隔。仅用于批量操作 |

使用 ~L1:、~L2:、~L3: 在消息中切换。未指定时默认为 L2。

符号

符号	意图	示例
?	查询	?fnd @fs {p:src/*.ts}
!

命令 | !del @fs {p:tmp/} | | > | 结果 | >ok {n:3 paths:[...]} | | # | 状态/数据 | #ctx {lang:ts env:node} | | ~ | 元信息 | ~L2 ~ack ~err | | ^ | 控制流 | ^if {cond} {then} ^el {else} |

结构

@ 目标 · -> 管道 · {} 参数 · << >> 块作用域 · [] 列表 · () 分组 · | 或 · .. 范围 · :: 类型 · $ 变量 · !~ 取反值

变量

使用 ->$name 绑定，使用 $name 引用。属性访问：$var.field。

词汇表

动作： fnd 查找 · mk 创建 · del 删除 · mod 修改 · rd 读取 · wr 写入 · run 执行 · cpy 复制 · mv 移动 · mrg 合并 · tst 测试 · vfy 验证 · prs 解析 · fmt 格式化 · snd 发送 · rcv 接收

作用域： @fs 文件系统 · @sh 终端 · @git git · @net 网络 · @db 数据库 · @mem 内存 · @env 环境 · @usr 用户 · @proc 进程 · @pkg 包

作用域动作： scope:action — !git:mrg 与 !db:mrg 不同

修饰符： rec 递归 · par 并行 · seq 顺序 · dry 试运行 · frc 强制 · tmp 临时 · vrb 详细 · sil 静默 · lmt 限制 · dep 深度 · pri 优先级 · unq 唯一 · neg 取反

限定符： rcn 最近 · lrg 大 · sml 小 · chg 已更改 · stl 陈旧 · nw 新 · old 旧 · act 活跃 · idl 空闲 · fld 失败 · hlt 健康 · hot 热 · cld 冷

类型： str 字符串 · int 整数 · bln 布尔 · lst 列表 · map 映射 · fn 函数 · pth 路径 · rgx 正则 · err 错误 · nul 空

状态： ok 成功 · fl 失败 · prt 部分 · pnd 待处理 · skp 跳过 · blk 阻塞

控制流

^if {条件} {执行体} ^el {否则} -- 条件判断
^lp {n:5} {执行体} -- 循环
^ea {源} ->$item {执行体} -- 遍历/迭代
^par [!t1, !t2, !t3] -- 并行
^seq [!t1, !t2, !t3] -- 顺序
^wt {条件} / ^rt {值} -- 等待 / 返回
^br / ^ct -- 中断 / 继续
^frk:名称 {执行体} -- 派生命名任务
^jn [名称列表] ->$结果 -- 合并/等待
^lk:名称 / ^ulk:名称 -- 互斥锁/解锁
^ch:名称 ::类型 buf:N -- 声明通道
^tx:名称 {v:$值} / ^rx:名称 ->$值 -- 发送/接收通道
^tmo:N -- 超时（秒）

<< >> 用于多语句执行体：

^ea {$files} ->$f <<
?rd @fs {p:$f} ->$content
^if {$content.sz>1000} {!mod @fs {p:$f trunc:true}}
>>

组合

使用 -> 管道链式连接，使用 ; 或换行符顺序执行：

?fnd @fs {p:*.ts rgx:parse} ->$lst | ^ea ->$f !tst @sh {cmd:vitest $f} ->$rpt

错误

~err {code:E_PARSE lvl:warn msg:未知标记}
~err {code:EFSNOT_FOUND lvl:fatal msg:缺少配置}

错误码：EPARSE EFS ESH ENET EDB EAUTH。级别：info 信息 warn 警告 fatal 致命。

标记扩展

~unk {tok:xyz req:def} -- 请求定义
~def {tok:xyz means:...} -- 内联定义

L3 字节码

位置化、句点分隔。包含句点的字段使用反引号引用：

Q.fs.fnd.app.config.ts.rec
R.ok.3.[src/a.ts:5,src/b.ts:12]

OpenClaw 集成示例

使用 OpenLang 任务的 sessions_spawn

~openlang
?fnd @fs chg rcn {p:src//.ts p:!~.test.ts rgx:TODO} ->$lst
^ea ->$f {!rd @fs {p:$f} ->$content; !prs @mem {src:$content k:todos}}
>ok {summary:true fmt:map}

使用 OpenLang 公告结果

~openlang
>ok {n:12 todos:[
{f:src/api.ts ln:42 msg:重构认证流程},
{f:src/db.ts ln:18 msg:添加连接池}
] truncated:10}
~L1: 大部分 TODO 集中在 api.ts 和 db.ts 中，主要涉及认证和连接处理

sessions_send 往返通信

-- 智能体 A -> 智能体 B
~openlang
?fnd @db {tbl:trades rcn lmt:100} ->$trades
!prs @mem {src:$trades k:pnl} ->$analysis
>ok {$analysis}

-- 智能体 B -> 智能体 A
~openlang
>ok {pnl:+2.3% win_rate:0.68 sharpe:1.42 trades:100
top:{sym:AAPL pnl:+890} worst:{sym:TSLA pnl:-340}}

##