ship-position

What This Skill Does

The ship-position skill is a professional-grade maritime intelligence tool designed for OpenClaw. It integrates directly with HiFleet data services to provide real-time vessel tracking, detailed ship profiles, and strategic maritime traffic analysis. Whether you are monitoring individual assets, researching ship specifications, or analyzing traffic patterns through critical bottlenecks like the Red Sea, Suez Canal, or Strait of Hormuz, this skill offers comprehensive insights. It manages the complexities of maritime APIs, including automatic ship searching via keyword or MMSI, coordinate conversion, and tokenized access for enterprise-level reporting.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/charleiwang/hifleet-skills

Ensure that you have your HiFleet credentials ready. For full functionality, you must configure your API token by setting the HIFLEET_USER_TOKEN environment variable or adding the usertoken parameter in your project configuration. Without a valid token, the skill remains functional for limited historical analysis, but essential real-time positioning and full archives will be restricted.

Use Cases

• Fleet Operations: Real-time monitoring of ship positions across global trade routes.
• Maritime Research: Retrieving detailed technical specifications for specific vessels using IMO or MMSI numbers.
• Geopolitical Analysis: Monitoring traffic volume and vessel types in strategic straits to assess supply chain disruptions.
• Logistics & Procurement: Identifying vessels in specific geographic zones or ports to optimize chartering and scheduling decisions.

Example Prompts

1. "Where is the vessel with MMSI 477123456 currently located?"
2. "Show me the latest traffic statistics for the Suez Canal and the Strait of Hormuz."
3. "Get the full technical profile and ownership details for the ship named 'Cosco Shipping Rose'."

Tips & Limitations

• Token Management: While the skill works without a token for certain queries, persistent use is highly recommended to avoid limitations on time ranges for traffic data. Always rotate your tokens periodically.
• Search Accuracy: When using ship names, the skill uses a fuzzy-search function. If the system returns multiple results, verify the IMO or MMSI to ensure you are tracking the correct vessel.
• Data Precision: Coordinate data returned by the API is provided in raw units and internally processed by the skill. Ensure your display settings are configured to handle decimal degrees for optimal visualization.
• Future Development: Note that features such as port monitoring, weather integration, and voyage tracking are currently planned for future releases. Ensure your local installation is updated regularly to receive these updates.