@openclaw/interchange

这是一个 Node.js 共享库，供技能间通过 .md 文件交换数据：原子写入（临时文件 + fsync + 重命名）、排序键与稳定 YAML 的确定性序列化、YAML frontmatter 解析、带过期检测的咨询式文件锁、schema 校验、熔断器模式，以及代际跟踪与内容哈希。仓库内含测试与示例数据文件。

frank-bot07

热度 64.52

最近更新 2026-05-17 12:23:55

分类：开发依赖：读写文件 / 代码执行应用场景：自动化脚本 / 工作流 / 数据处理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add openclaw-interchange

Metadata

name: openclaw-interchange
description: Shared .md interchange library for OpenClaw skills — atomic writes, deterministic serialization, YAML frontmatter, advisory locking, and schema validation. The foundation all other OpenClaw skills build on.

@openclaw/interchange

The shared library that powers agent-to-agent communication via .md files.

Usage

import { writeMd, readMd, acquireLock } from '@openclaw/interchange';

// Write an interchange file atomically
await writeMd('ops/status.md', { skill: 'crm', status: 'healthy' }, '## Status\nAll systems go.');

// Read it back
const { meta, content } = readMd('ops/status.md');

Key Features

Atomic writes (tmp + fsync + rename)
Deterministic serialization (sorted keys, stable YAML)
Advisory file locking with stale lock detection
YAML frontmatter parsing
Schema validation
Circuit breaker pattern
Generation tracking + content hashing