A professional-grade maritime tracking tool that retrieves comprehensive vessel position and status data via the HiFleet API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ship-position
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ship-position using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Ship Position?
The Ship Position skill is a technical integration designed to provide AI agents with real-time maritime intelligence. By leveraging the HiFleet API, this skill enables the retrieval of vessel positions across land-based, satellite, and mobile tracking networks. It is a critical component for developers building maritime logistics and supply chain solutions using Openclaw Skills.
This skill automates the process of querying vessel data by MMSI, handling the authentication and data normalization required to present actionable maritime information. Whether you are tracking a single container ship or monitoring global fleet movements, this tool provides the high-fidelity data needed for modern maritime applications.
Ship Position Use Cases
- Real-time tracking of commercial vessels for logistics and supply chain management.
- Monitoring vessel ETA and destination changes for port operations.
- Analyzing maritime traffic and vessel density in specific shipping lanes.
- Verifying vessel status, speed, and course for maritime security or research.
How Ship Position Works
- The skill first validates the presence of a HiFleet user token in the system environment or configuration.
- It accepts a 9-digit MMSI (Maritime Mobile Service Identity) number as the primary identifier.
- A secure GET request is sent to the HiFleet API endpoint with the authorized token.
- The skill receives a response containing vessel metadata and coordinates in minutes.
- It performs a mathematical conversion (dividing latitude/longitude minutes by 60) to generate standard decimal degrees.
- The processed data is then formatted and returned to the Openclaw Skills agent for display or further logic.
Ship Position Setup
To use this skill, you must obtain a HiFleet API token. Configure it using one of the following methods:
- Environment Variables: Set
HIFLEET_USER_TOKENorHIFLEET_USERTOKENin your shell. - Configuration: Add the token to your project-level configuration or Openclaw Skills dashboard.
# Example of setting the environment variable
export HIFLEET_USER_TOKEN="your_hifleet_api_token"
Ship Position Data Schema & Taxonomy
The skill returns a comprehensive object containing vessel details. Note that coordinates require conversion from minutes to degrees.
| Parameter | Description | Type |
|---|---|---|
| m | MMSI Number | string |
| n | Vessel Name | string |
| sp | Speed in knots | string |
| co | Course in degrees | string |
| ti | Last update timestamp (UTC+8) | string |
| la | Latitude (divide by 60 for degrees) | string |
| lo | Longitude (divide by 60 for degrees) | string |
| destination | Reported AIS Destination | string |
| status | Current vessel status | string |
Ship Position Advanced Features
- Multi-source position aggregation including satellite and terrestrial AIS.
- Automated coordinate transformation for GIS-ready decimal degrees.
- Support for project-specific token management within Openclaw Skills.
- Detailed vessel profiling including IMO number, callsign, and ship dimensions.
SKILL.md
Loading
Related Openclaw Skills
Modern C/C++ & CUDA Development
A high-performance development reference for AI agents that provides live-fetched patterns for modern C, C++, and CUDA GPU programming.
Manager Skill
A zero-latency, offline reference tool providing instant access to implementation patterns, debugging guides, and devtools best practices.
Spec Writer
Spec Writer transforms vague feature ideas or bug reports into highly structured, actionable implementation documents for developers and AI agents.
AgentRank
AgentRank provides live, quality-scored data on over 25,000 MCP servers and AI tools to ensure your agent recommendations are always current.
pdf2md-clean
A privacy-focused local utility for converting PDF documents into clean, structured Markdown files without external API dependencies.
Secure TODO Tracker
A secure, cross-session task management tool for AI agents featuring robust input validation and safe file operations.
Featured*
