Ctrlk
API KeyModelsPlaygroundGitHubGet Support
For the complete documentation index, see llms.txt. This page is also available as Markdown.

🦞OpenClaw AI/ML

About

OpenClaw is an AI platform for building AI agents and assistants. It runs on your own devices and connects to popular messaging platforms (such as WhatsApp, Telegram, Slack, Discord, and others) while preserving full data privacy (all agent data is stored locally in a SQLite database).

Developers use OpenClaw to build multi-channel AI assistants with streaming responses, browser automation, vision, and voice features. It includes a local Gateway service, a CLI for management, and support for 12+ messaging platforms.

Data privacy: OpenClaw stores data locally by default. Nothing is sent externally unless you configure it.

What you get

  • Multi-channel assistants and routing across 12+ messaging platforms

  • Streaming responses for faster, more interactive chats

  • Vision inputs for image understanding and UI analysis

  • Browser automation via an OpenClaw-managed Chrome instance

  • Voice integrations (platform dependent)

  • Session memory and conversation history

  • Tooling via skills, function calling, and external integrations

  • Retries and error handling for more robust agents

  • A local Gateway (binds to localhost:18789 by default) and a CLI

  • A local SQLite database containing all agent data (default path: ~/.openclaw/openclaw.db)

Prerequisites

  • An AIMLAPI key obtained from your account dashboard

  • Node.js and npm

  • pnpm if you build from source

Installation

Option 1: Install via npm (recommended)

openclaw-aimlapi@latest includes two AI/ML API skills:

  • aimlapi-media-gen for images and video

  • aimlapi-llm-reasoning for chat and reasoning

The onboarding wizard installs the Gateway as a system service. It uses launchd on macOS and systemd on Linux.

Option 2: Build from source

UI walkthrough (screenshots)
Image
Install via npm
Image
Or build from GitHub with pnpm
Image
Confirm installation
Image
Select "Quickstart"
Image
Select provider: AI/ML API
Image
Select auth method: API Key
Image
Paste your AI/ML API key
Image
Select a model Always include the aimlapi/ prefix Suggested: aimlapi/google/gemini-3-flash-preview
Image
Select a channel Telegram is usually the easiest
Image
Paste your Telegram bot token
Image
Optional: configure extra skills Media skills are configured by default
Image
Finish onboarding and open the Web UI
Image
Gateway is running

Option 3: Install skills from the official repo (ClawHub)

Use this if you want to install or update skills separately from the OpenClaw package.

Install the CLI

Pick one:

For more details, see: ClawHub tool docs.

Install the skills

Install only the ones you need — each skill is independent.

How it fits into OpenClaw

  • By default, clawhub installs skills into ./skills under your current directory.

  • If an OpenClaw workspace is configured, clawhub falls back to that workspace.

  • Override the install location with --workdir or CLAWHUB_WORKDIR.

  • OpenClaw loads workspace skills from <workspace>/skills.

  • New skills are picked up on the next session (restart the Gateway).

  • If you already use ~/.openclaw/skills or bundled skills, workspace skills take precedence.

What these skills do

aiml-image-video — Our media generation models

Generate images and videos via two Python scripts (gen_image.py, gen_video.py).

aiml-llm-reasoning — Our LLMs + Reasoning

Run chat completions via run_chat.py. Use --extra-json for advanced params.

aiml-music-generator — Our music models

Generate music and songs via gen_music.py (ElevenLabs, MiniMax, and other music models).

aiml-voice — Speech-to-text

Transcribe audio files (ogg, mp3, wav, and more) via transcribe.py. Useful when OpenClaw receives voice messages from a chat connector.

aiml-embeddings — Embeddings

Turn text into vectors via gen_embeddings.py — for semantic search, clustering, and retrieval.

aiml-safety — Content moderation

Classify text or images as safe or unsafe via check_safety.py, using guard models.

Paths above assume you run clawhub install ... from your OpenClaw workspace root (so skills land in ./skills). If you install somewhere else, adjust the paths to match your --workdir.

If you installed OpenClaw via openclaw-aimlapi@latest, you may already have AIML-related skills installed. Use ClawHub when you specifically want the skills from the official skills repository.

Configure AI/ML API in OpenClaw

Use the Web UI from onboarding. The default URL is usually http://127.0.0.1:59062/.

1

Select provider

Pick AI/ML API in the providers list.

2

Add your API key

Use API Key auth. Paste the key from aimlapi.com/app/keys.

3

Choose a model

Use a model ID that starts with aimlapi/. Example:

aimlapi/google/gemini-3-flash-preview

4

Choose a channel

Telegram is a good first connector. Then add more channels as needed.

Use OpenClaw

Use via a chat connector (Telegram example)

1. Message your bot. You will receive a pairing code.

Image
Get the pairing code

2. Approve the pairing:

Expected output looks like this:

3. Message your bot again. You should get a response.

Image
Agent is responding

Use via CLI

Example response

Use Cases

Example: Route Slack + Discord to the same agent

  1. User messages the bot on Slack or Discord.

  2. Gateway receives the message with platform context.

  3. OpenClaw routes the message to the agent.

  4. The agent calls AI/ML API using your chosen model.

  5. The response goes back to the same channel.

Example: Analyze a web page with vision

  1. User requests a web page analysis.

  2. OpenClaw opens a Chrome instance (CDP-controlled).

  3. OpenClaw captures a screenshot of the page.

  4. The agent sends the screenshot to a vision model.

  5. The model returns a description and key details.

  6. OpenClaw sends the result back to the user.

Supported models

More

PreviousOpenClaude
NextRAGFlow

Last updated

Was this helpful?