Smart API Connector v3.0

Install: clawhub install smart-api-connector

REST API integration using built-in tools. No code, no curl, no dependencies.

Language

Detect from user's message language. Default: English.

Quick Start

User provides: API URL + what they want. Agent handles everything.

User: "Hent brukerinfo fra https://api.example.com/v1/users/123"

Agent runs: web_fetch https://api.example.com/v1/users/123 (with auth headers if provided)

Returns parsed response.

Authentication

API Key in Header

web_fetch url --headers '{"Authorization": "Bearer KEY", "X-API-Key": "KEY"}'

API Key via Environment Variable

exec: API_KEY="your_key" curl -s -H "Authorization: Bearer $API_KEY" "https://..."

Session-only Keys

API keys provided in conversation are used in-session only. Never persisted to files.

Error Handling

HTTP Methods

For POST/PUT: prompt user for JSON body if not provided.

Response Parsing

Always extract and present the useful parts. For JSON APIs:

Response:
  Name: John
  Email: [email protected]
  Created: 2026-03-28

Raw: {first 200 chars if user wants detail}

Security

• Keys are session-only — never written to files
• Prefer environment variables over command-line args
• Scoped/test keys over production secrets
• Show user the exact request before executing (URL + method + headers, not the key value)

Quick Commands

Guidelines for Agent

1. Use web_fetch first — built-in, no dependencies
2. Fall back to exec/curl only if web_fetch can't handle the request
3. Never persist API keys — session only
4. Show request before executing — confirm with user for POST/PUT/DELETE
5. Parse responses — extract useful data, don't dump raw JSON
6. Handle errors gracefully — retry on 429, explain 401/403
7. Match user language in responses

What This Skill Does NOT Do

• Does NOT persist API keys or credentials
• Does NOT require npm packages or external tools
• Does NOT modify any local files
• Does NOT make requests without user knowledge (for POST/PUT/DELETE)

More by TommoT2

• workflow-builder-lite — Build and execute multi-step workflows
• context-brief — Persistent context survival across sessions
• setup-doctor — Diagnose and fix OpenClaw setup issues

Install the full suite:

clawhub install smart-api-connector workflow-builder-lite context-brief setup-doctor