World2Agent

World2Agent (W2A) 是一个专为 AI Agent 设计的开放感知协议，核心理念是"MCP 赋予 Agent 双手，W2A 赋予 Agent 双耳"。项目通过定义统一的 W2ASignal 数据信封，将来自不同数据源（新闻、金融、GitHub、天气等）的事件标准化，使得 Agent 能够无视底层 Sensor 差异直接消费结构化信号。

协议与数据模型#

• 统一信号契约：所有 Sensor 遵循同一 W2ASignal Schema，Agent 无需适配不同数据源差异即可消费。
• 高保真信封结构：包含 signal_id（UUID，去重追踪）、时间双戳（emitted_at / occurred_at，UTC ms）、三段式事件命名（domain.entity.action，如 repo.issue.opened）、自然语言 summary、自描述原始数据（source_event，含 schema + data）及灵活附件（attachments，支持内联或引用式）。
• 无中心化扩展机制：source_type、event.type、mime_type 均为 OPEN 集合，无需中央注册；_meta 字段支持实验性扩展，且规定消费者必须忽略未知 key。
• 协议版本：当前版本为 w2a/0.1，目录名对应 PROTOCOL_VERSION；破坏性变更通过升目录实现，增量变更就地修改。

架构设计#

核心数据流：World → Sensor → Agent

• 协议层：核心为 schema/0.1/schema.ts，采用自包含 TypeScript（无运行时依赖）定义线格式，通过 typescript-json-schema 生成 schema.json。
• 传输层：协议刻意保持传输无关性，不定义具体传输帧，由各运行时实现自行封装（支持 stdio、HTTP POST、WebSocket 等）。
• Sensor 层：标准 npm 包实现，通过轮询或 webhook 监听数据源，统一输出 W2ASignal。
• Bridge 层：运行时适配器（如 hermes-sensor-bridge、openclaw-sensor-bridge），负责将 Sensor 信号桥接至特定 Agent 框架。
• Graph 层（Roadmap）：规划支持多传感器信号组合与富化后再送达 Agent。

Sensor 生态与分发#

• Sensor 即 npm 包：每个传感器是标准 npm 包，可通过 npm search w2a-sensor 检索，一条命令安装。
• 官方 SensorHub 目录：按 9 大类别（messaging / calendar / finance / research / social / dev / infra / data / custom）组织，展示信号 Schema 与一键安装命令。
• 元传感器支持：支持监控 npm 上新 W2A Sensor 发布的元传感器（如 @quill-io/sensor-w2a-registry）。
• AI 辅助建站工具链：提供 build-w2a-sensor skill，引导 AI 编码 Agent 完成发现→信号设计→脚手架→安装配方全流程，约 50 行代码即可发布。

运行时兼容性#

• Claude Code：通过 Plugin 方式安装（/plugin marketplace add + /world2agent:sensor-add）。
• Hermes：通过 @world2agent/hermes-sensor-bridge npm 包 + Skill 方式安装。
• OpenClaw：通过 @world2agent/openclaw-sensor-bridge npm 包 + Skill 方式安装。
• 自研 Agent：提供 SDK 开发者快速上手路径。

典型应用场景#

• 信息监控：Hacker News 热帖、前沿 AI 实验室博客自动推送（@world2agent/sensor-hackernews、@quill-io/sensor-frontier-ai-news）。
• 金融预警：Polymarket 预测市场赔率突破阈值触发信号（@quill-io/sensor-polymarket）、外汇对突破目标价提醒（@juliapupu/sensor-fx-frankfurter）。
• 开发者工具：GitHub 仓库 Star 增长监控、里程碑标记（@quill-io/sensor-github-stars）。
• 生活信息：全球城市天气预报 + 天文时刻（@juliapupu/sensor-weather-everywhere）。
• 感知驱动自动化：Bug 检测 → Agent 自动创建修复 PR、Steam 免费游戏/特价 → Agent 自动领取。

安全模型#

Sensor 信号直接驱动 Agent 的感知与行动，因此安全模型依赖于"仅安装可信 Sensor"——不可信 Sensor 等同于不可信指令源。Hermes / OpenClaw 首次安装 Sensor Bridge 时需启用 webhook 平台并重启 gateway。OpenClaw 支持将 Agent 响应自动推送到 Feishu / iMessage / Telegram 等聊天平台。