Integration Guide: Connecting OpenClaw to HeliosX

This guide explains how to connect OpenClaw to the HeliosX API gateway. Since HeliosX is fully OpenAI-compatible, you can integrate it in seconds using either CLI arguments or environment variables.

Prerequisites

Before you begin, ensure you have the following:

  1. A HeliosX Account: You need an active account with us.
  2. Your API Key: Locate your unique API key in your HeliosX dashboard. This key will authorize your OpenClaw instance to make requests through our gateway.
  3. OpenClaw Installed: Ensure you have OpenClaw set up and running on your system.

Configuration Steps

OpenClaw can be configured to use a custom LLM provider that follows the OpenAI API format. Since HeliosX is compatible with the OpenAI API structure, configuration is straightforward.

HeliosX is fully OpenAI-compatible, so you can use it as a drop-in replacement for any OpenAI-compatible provider in OpenClaw.

🚀 Interactive CLI Configuration

OpenClaw provides a built-in configuration wizard. This is the most foolproof way to ensure your API and Model IDs are set correctly.

Steps to Configure

  1. Start the Wizard: Run the following command in your terminal: 
    openclaw configure
  2. Follow the Prompts: Fill in the details as shown in the table below to route requests through HeliosX:
Prompt Value to Enter / Select
Where will the Gateway run? Local (this machine)
Select sections to configure Model
Model/auth provider Select Custom Provider
API Base URL https://api.heliosx.ai/v1
How to provide API key? Paste API key now
API Key Paste your HeliosX API Key here
Endpoint compatibility OpenAI-compatible
Model ID e.g., google/gemini-2.5-flash-preview (or any model available on HeliosX)
OpenClaw configuration screenshot

Verifying the Configuration

Once you have configured the environment variables or the configuration file, start OpenClaw. If the configuration is correct, OpenClaw will be able to successfully communicate with our gateway.

You can verify this by running a simple task in OpenClaw. If OpenClaw responds without errors, your integration is complete!

HeliosX API Base URL https://api.heliosx.ai/v1

Troubleshooting

Error: "Invalid API Key"

Double-check that you have copied your HeliosX API key correctly and that it is active. You can find and manage your API keys in the HeliosX dashboard.

Error: "Connection Refused" or "Timeout"

Ensure that you have entered the correct api_base URL (https://api.heliosx.ai/v1) and that your network allows connections to that endpoint.

Model Not Found

If you continue to experience issues, please contact our support team at support@heliosx.ai.