Agents can't act on what they can't perceive.

Website · Quick Start · Sensors · SensorHub · Docs · Community

Watch the W2A Concept Video

---

What is World2Agent?

World2Agent (W2A) is an open protocol that standardizes how AI agents perceive the real world. Install a sensor, your agent gets structured, real-time data. Swap sensors freely — they all speak the same schema.

W2A isn't a product. It's an open protocol and an invitation. We built the first sensors — the real breakthroughs will come from the community.

→ Why W2A? Full story

Partners

When using the W2A, we welcome you to use our partner Zeabur to deploy your code or agents, allowing users worldwide to experience them online!

Architecture

World → Sensor → Agent

Sensors watch data sources and emit structured data following W2A Protocol. Your agent receives signals and decides what to do.

→ Signal format spec · Architecture deep dive

Quick Start

W2A ships with native agent-runtime plugins for Claude Code, Hermes, and OpenClaw — pick whichever runtime you already use.

Claude Code

In an active session, install the world2agent plugin:

/plugin marketplace add machinepulse-ai/world2agent-plugins
/plugin install world2agent@world2agent-plugins
/reload-plugins

Add a sensor — for example, Hacker News stories, frontier AI lab posts:

/world2agent:sensor-add @world2agent/sensor-hackernews
/world2agent:sensor-add @quill-io/sensor-frontier-ai-news

Restart Claude Code with the plugin channel loaded so sensor signals flow into your session:

claude --dangerously-load-development-channels plugin:world2agent@world2agent-plugins

Hermes

Install the bridge once:

npm install -g @world2agent/hermes-sensor-bridge
hermes skills install machinepulse-ai/world2agent-plugins/hermes-sensor-bridge/skills/world2agent-manage

In an interactive hermes session, describe the intent in natural language or use the slash form — the agent handles npm install, SETUP.md Q&A, webhook subscription, and subprocess startup:

/world2agent-manage add @world2agent/sensor-hackernews

First time only: the agent will ask you to restart hermes gateway once after it enables the webhook platform. Every install after that is seamless.

Each signal triggers a fresh AIAgent.run_conversation() against the generated handler skill.

OpenClaw

Three steps:

npm install -g @world2agent/openclaw-sensor-bridge
openclaw skills install world2agent-manage

Then send this in your OpenClaw chat:

Use world2agent-manage skill install @quill-io/sensor-frontier-ai-news

The skill walks the SETUP.md Q&A, generates a handler skill, registers the sensor, and starts the supervisor. Subsequent signals each trigger a fresh /hooks/agent call against the handler.

First time only: the bridge writes a managed hooks block into ~/.openclaw/openclaw.json (auto-generates hooks.token if absent) and asks you to run openclaw gateway restart once. A timestamped backup of the original config is kept next to the file. Every install after that is seamless.

If you have a paired chat platform (Feishu, iMessage, Telegram, …) configured via <PLATFORM>_HOME_CHANNEL in ~/.openclaw/.env, replies are auto-pushed to that chat by default.

---

→ Browse the full catalog on SensorHub.

Security — install only sensors you trust. A sensor's signals drive what your agent perceives and does, so an untrusted sensor is effectively an untrusted instruction source. Stick to open-source sensors from authors you trust, and review the code first.

Integrating W2A into your own agent system? See the developer quick start for the SDK code path.

→ Full guide · Multi-sensor · SensorHub

Sensors

SensorHub

SensorHub is the catalog of every W2A sensor — official and community-built, organized by what each one perceives (markets, news, production alerts, weather, AI labs, …). Browse it to see what's available, view each sensor's signal schema, and grab the one-line install command. Looking for a sensor? Start here.

Every sensor is a standard npm package — npm search w2a-sensor works as a fallback if you prefer the raw view.

→ SensorHub guide

Missing a sensor?

Build your own in ~50 lines. The build-w2a-sensor skill walks an AI coding agent through discovery, signal design, scaffolding, and the install recipe — install it with:

npx skills add https://github.com/machinepulse-ai/world2agent/skills/build-w2a-sensor

Once it's ready, ship it to npm:

npm publish

That's it — your sensor is now installable by anyone, anywhere.

Roadmap

• Graph layer — compose and enrich signals from multiple sensors before they reach your agent. → RFC

Contributing

• 🔧 Build a sensor — npm publish and it's live

• 🐛 Report bugs — open an issue

• 💡 Suggest a sensor — Discussions

→ Contributing guide

Community

Website · X / Twitter · YouTube · Discord

License

Apache 2.0

---

Built by MachinePulse · Open source, open protocol, open invitation.