omnilink-agent

Inspect trusted devices, subscribe to cross-device events, and send messages over OmniLink.

2.0k|140|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/omnimind-ai/OpenOmniBot --skill omnilink-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omnilink-agent
Source: https://github.com/omnimind-ai/OpenOmniBot/tree/main/plugins/omnilink-agent/runtime-skill/omnilink-agent
Command: npx skills add https://github.com/omnimind-ai/OpenOmniBot --skill omnilink-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating two Android devices running Xiaowan normally requires manual status checks and message relaying; this Skill lets the agent discover trusted devices, read or subscribe to their events, and send messages through the built-in OmniLink primitives.

Core Features & Use Cases

  • Device Discovery & Status: List trusted collaboration devices and answer questions about battery, reachability, charging, and network state from real readiness data.
  • Event Reading & Subscription: Read or subscribe to notification events (NOTIFICATION_UPSERTED, NOTIFICATION_REMOVED) and agent message events (AGENT_MESSAGE_RECEIVED) with cursor-based continuation and reconnect recovery.
  • Cross-Device Messaging: Send structured messages to the Xiaowan agent on another device via omnilink_control with safe defaults and idempotent IDs.
  • Use Case: When a notification arrives on your second phone, the agent detects it through a subscription and notifies the Xiaowan on that device that you have seen it.

Quick Start

Ask the agent to list your collaboration devices and start forwarding notifications from your other phone.

Frequently Asked Questions about omnilink-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check another phone's battery or online status with OmniLink?

Call omnilink_devices to list trusted devices, then read the target device's reachable flag and readiness.device data. If batteryPercent is empty, report that no battery reading is available rather than estimating.

How to subscribe to notifications from another Android device?

Use omnilink_events with the target device_id, event_types NOTIFICATION_UPSERTED and NOTIFICATION_REMOVED, and mode=subscribe. The plugin persists the cursor and handles reconnection, and incoming events flow back into the current chat automatically.

Can OmniLink read the full text of notifications from another device?

No, notification events only return the app identifier and a safe summary. Titles, bodies, and sensitive content are never transmitted through the agent tools, and this restriction cannot be bypassed.

How do I send a message to the Xiaowan agent on another device?

Use omnilink_control with action=send_message and put the user's intent in input.message. Optional fields like conversationId and messageId can be omitted so the plugin applies safe defaults and generates idempotent IDs.

Why does send_message show queued but the other device did not respond?

A queued result only means the message entered the OmniLink queue, not that the remote agent read it. Delivery is confirmed only by an inbound event or explicit receipt; connection or authorization failures must be resolved in OmniLink first.