Simple HTTP for Openclaw

A lightweight, zero-dependency Node.js HTTP client for making resilient API requests with automatic retries and graceful error handling.

stephen-standridge
v0.1.0
Feb 27, 2026
0
1.3k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install simplehttpskill

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 simplehttpskill 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 Simple HTTP?

The Simple HTTP skill is a high-performance utility designed for AI agents to interact with web services and APIs. Built natively on Node.js modules, this Openclaw Skills component allows for seamless GET, POST, PUT, and DELETE operations without the overhead of external libraries. It is engineered for reliability, featuring built-in support for custom headers and automatic payload serialization, making it an essential tool for agents needing to fetch or send data across the web.

By leveraging native Node.js http and https modules, this skill ensures a minimal footprint and high compatibility across different environments. It simplifies the complexity of request management by providing a unified interface that handles both network-level errors and HTTP-specific status codes gracefully.

Simple HTTP Use Cases

  • Fetching data from RESTful APIs for agent processing and decision making.
  • Sending real-time webhooks and event notifications to third-party services.
  • Interacting with cloud microservices to trigger external workflows.
  • Automating data retrieval tasks that require robust error handling and automatic retries.

How Simple HTTP Works

  1. The user instantiates the HttpClient, optionally defining global settings such as base headers, timeouts, and maximum retry attempts.
  2. A request is initiated using a specific HTTP method (GET, POST, etc.) and a target URL.
  3. The skill automatically serializes object-based request bodies into JSON and sets appropriate headers.
  4. If a transient error occurs, such as a connection timeout, rate limit (429), or server error (5xx), the skill applies an exponential backoff strategy with jitter.
  5. Upon completion or exhaustion of retries, the skill returns a standardized response object containing the status code, headers, and parsed body for inspection.

Simple HTTP Setup

To use this tool within the Openclaw Skills framework, ensure the source files are available in your project. You can initialize and use the client as shown below:

const { HttpClient } = require("./src/http-client");

const client = new HttpClient({
  defaultHeaders: { "Authorization": "Bearer YOUR_TOKEN" },
  maxRetries: 3
});

No external npm installation is required as the skill depends solely on built-in Node.js modules.

Simple HTTP Data Schema & Taxonomy

All requests return a consistent response object to simplify agent logic:

Key Type Description
ok boolean True if the HTTP status code is in the 2xx range
status number | null The numeric HTTP status code, or null for network errors
headers object Key-value pairs of the response headers
body any The response payload, automatically parsed if the content is JSON
error string | null A descriptive error message if the request failed

Simple HTTP Advanced Features

  • Built-in exponential backoff with jitter to mitigate rate limiting and transient server instability.
  • Zero-dependency architecture using only core Node.js modules for maximum security and speed.
  • Automatic JSON serialization for request bodies and intelligent parsing for response data.
  • Non-throwing error handling model that ensures predictable flow control for AI agents by always returning a response object.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*