OpenServ Client for Openclaw

A TypeScript client for provisioning, managing, and automating AI agents and workflows on the OpenServ Platform.

issa-me-sush
v1.0.4
Feb 17, 2026
0
2.2k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install openserv-client

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install openserv-client 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 OpenServ Client?

The @openserv-labs/client package serves as the primary TypeScript interface for interacting with the OpenServ Platform API. It allows developers to programmatically register agents, create complex workflows, and establish triggers such as webhooks, cron jobs, or x402 paywalls. By utilizing this package within the ecosystem of Openclaw Skills, developers can automate the entire agent lifecycle, from initial provisioning to on-chain identity registration via ERC-8004.

This client acts as the bridge between your local agent code and the platform's orchestration layer. It handles the complexities of authentication, state persistence in .openserv.json, and the configuration of model parameters. Whether you are building a simple automation or a decentralized AI service, this skill provides the necessary tools to scale your agent's capabilities.

OpenServ Client Use Cases

  • Automating the registration and provisioning of AI agents on a centralized platform.
  • Setting up monetized AI services using x402 paywalls and USDC payments.
  • Creating scheduled tasks with cron triggers for recurring agent operations.
  • Registering on-chain identities for agents using the ERC-8004 standard on Base.
  • Programmatically discovering and invoking third-party AI services and workflows.

How OpenServ Client Works

  1. The developer installs the client and authenticates using either a wallet private key or a platform-issued user API key.
  2. The provision function is called to idempotently create or update the agent and its associated workflows on the platform.
  3. Triggers are defined (webhook, cron, or x402) and linked to specific tasks within a workflow graph.
  4. The client manages local state by saving identifiers and tokens to a .openserv.json file for persistent access.
  5. Once provisioned, the agent can receive and execute tasks, while the client monitors workflow status and handles payment processing if applicable.

OpenServ Client Setup

Install the package via npm:

npm install @openserv-labs/client

Basic provisioning example:

import { provision, triggers } from '@openserv-labs/client';

await provision({
  agent: {
    name: 'ResearchAgent',
    description: 'Analyzes market trends'
  },
  workflow: {
    name: 'Trend Analysis',
    goal: 'Analyze the latest market trends and generate a report.',
    trigger: triggers.webhook({ waitForCompletion: true })
  }
});

OpenServ Client Data Schema & Taxonomy

The skill manages several key data entities and local state configurations:

Entity Description
.openserv.json Local file storing the agentId, workflowId, and trigger tokens.
ProvisionResult A JSON object containing API keys, auth tokens, and trigger URLs.
Model Parameters Schema defining LLM choice, temperature, and reasoning constraints.
ERC-8004 Metadata On-chain identity data including service endpoints and IPFS metadata hashes.

OpenServ Client Advanced Features

  • Idempotent provisioning ensures that re-running setup scripts does not create duplicate agents or workflows.
  • x402 Payment integration allows for per-request monetization of AI agent services.
  • ERC-8004 registration mints an identity NFT on the Base blockchain for decentralized discovery.
  • Model Parameter API enables dynamic selection and configuration of various LLM providers.
  • Automated credential binding links agent instances with necessary API keys without manual environment variable management within the Openclaw Skills framework.

SKILL.md


Loading

Related Openclaw Skills

Featured*