A developer skill for integrating and maintaining the UnifyPort Node.js SDK, covering client workflows, contract-first generation, and secure API execution.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install unifyport-node-sdk
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 unifyport-node-sdk 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 UnifyPort Node.js SDK?
The UnifyPort Node.js SDK skill provides systematic instructions for developers and AI agents managing the @unifyport/sdk-node package. It supports two primary modes: integration into existing applications (project usage) and direct development of the SDK core (repository maintenance).
By leveraging this tool, you can manage the integration lifecycle, configure secure authentication mechanisms using environment variables, and ensure that your system remains synchronized with public contracts. This asset is an addition to Openclaw Skills designed to streamline workspace setup and API interaction without exposing credentials or performing unauthorized live requests.
UnifyPort Node.js SDK Use Cases
- Authenticating and calling the UnifyPort Device API within Node.js or TypeScript applications.
- Adding, updating, or debugging @unifyport/sdk-node operations safely.
- Maintaining the SDK repository by updating OpenAPI contracts and resolving code generation drift.
- Managing advanced client operations such as cursor-based pagination, explicit retry logic, and JavaScript safe integer boundary checks.
How UnifyPort Node.js SDK Works
- Determine Mode of Operation: Establish whether the task is standard project integration or core repository maintenance.
- Environment & Preparation: Inspect runtime environment and package managers while ensuring no real API keys are exposed or logged.
- Contract Alignment: For repository changes, validate the OpenAPI schema against device contracts to maintain code generation boundaries.
- Execution & Generation: Run the contract linter and generator commands to update client endpoints without manual file modification.
- Validation: Execute typing, linting, and testing suites locally to confirm code compliance and security requirements.
UnifyPort Node.js SDK Setup
To use the UnifyPort Node.js SDK in your application, ensure you are running Node.js >=22.12.0 and configure the environment.
Installation
Install the package via your preferred package manager:
npm install @unifyport/sdk-node
Configuration
Define the required environment variables in your environment or deployment system:
export UNIFYPORT_DEVICE_API_KEY='your_api_key_here'
export UNIFYPORT_DEVICE_API_BASE_URL='https://api.unifyport.com'
Basic Usage
Initialize the client securely in TypeScript:
import { UnifyPortDeviceClient } from '@unifyport/sdk-node';
const deviceClient = new UnifyPortDeviceClient({
baseUrl: process.env.UNIFYPORT_DEVICE_API_BASE_URL,
apiKey: process.env.UNIFYPORT_DEVICE_API_KEY
});
UnifyPort Node.js SDK Data Schema & Taxonomy
The SDK relies on structured OpenAPI contracts and local repository schemas to maintain type safety and alignment.
| File / Directory | Purpose | Format |
|---|---|---|
contracts/device.openapi.yaml |
Primary Device API OpenAPI contract | YAML |
AGENTS.md |
Core instructions and rules for AI agents in repository | Markdown |
docs/architecture.md |
System architecture, flow, and component diagrams | Markdown |
docs/security.md |
Security rules, key handling, and encryption practices | Markdown |
Environment Taxonomy
UNIFYPORT_DEVICE_API_KEY: Required for executing authenticated requests against the live Device API.UNIFYPORT_DEVICE_API_BASE_URL: Defines the destination endpoint for the API client.
UnifyPort Node.js SDK Advanced Features
- Contract-First Code Generation: Automatically compiles TypeScript types and endpoints from OpenAPI specifications using dedicated pnpm routines.
- Strict Error Boundary Isolation: Formats API errors safely to hide sensitive request context or raw transport URLs while preserving critical HTTP statuses.
- Controlled Retry Logic: Employs an explicit allowlist for retries, keeping destructive mutations or one-time secret creations safe from accidental replay attacks.
- Cursor-Based Pagination Helper: Simplifies traversal across large database resources using standardized iteration parameters.
SKILL.md
Loading
Related Openclaw Skills
LifeTrace
LifeTrace turns sourced biographies into interactive, map-driven life timelines with confidence-tagged events, geocoding, and portable HTML output.
nov-tarot
A psychological-counseling Tarot agent that interprets spreads using projective psychology, elements, and astrology, backed by session-tracking CLI tools.
Nonsense Literature Crafter
An Openclaw Skills text rewrite tool that turns ordinary sentences into concise, circular nonsense literature without changing the core topic.
Xiao Liu Yao Divination Tool
A command-line and AI agent tool executing traditional Taoist Xiao Liu Ren divination algorithms to analyze timing, relationships, and situational outcomes.
X (Twitter) Publisher
Publish text, media, replies, and threads to X from the command line with verified credentials and structured results.
X (Twitter) Publisher
A command-line Openclaw Skills publisher for X that posts text, media, replies, and threads through Tweepy with structured results.
Featured*
