Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
1. Overview

OpenClaw is an open-source (MIT licensed) local AI assistant that runs on your own machine. It interacts through messaging platforms like Telegram, WhatsApp, Discord, Slack and iMessage, and performs real automation: file operations, terminal commands, browser control, scheduled tasks and more. With GravitexAI (OpenAI-compatible API), one API key gives OpenClaw access to 400+ leading models including GPT, Claude, Gemini and DeepSeek.

Local & Private

All data stays on your machine

Multi-platform

Telegram / WhatsApp / Discord / Slack / iMessage

Autonomous

Beyond chat — actually operates your computer

Extensible

Custom skills and plugins
Website: openclaw.ai ｜ Repo: github.com/openclaw/openclaw ｜ License: MIT

​
2. Prerequisites

  • Create an API key in the GravitexAI console
  • Node.js 22 or higher
  • macOS / Linux / Windows

​
3. Install OpenClaw

​
3.1 Install Node.js

brew install node@22

​
3.2 Install OpenClaw

npm install -g openclaw

​
3.3 Verify

openclaw --version
openclaw doctor
If openclaw doctor reports issues, run openclaw doctor --fix.

​
4. Configure GravitexAI

OpenClaw stores its config at ~/.openclaw/openclaw.json. 
{
  "agents": {
    "defaults": {
      "model": { "primary": "gravitex/claude-sonnet-4-6" }
    }
  },
  "models": {
    "providers": {
      "gravitex": {
        "baseUrl": "https://api.gravitex.ai/v1",
        "apiKey": "sk-your-gravitexai-key",
        "api": "openai-completions",
        "models": [
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
          { "id": "openai/gpt-5.4", "name": "GPT-5.4" },
          { "id": "deepseek-v3-2-251201", "name": "DeepSeek V3.2" },
          { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }
        ]
      }
    }
  }
}
  • baseUrl must end with /v1
  • GPT models require the openai/ prefix, e.g. openai/gpt-5.4
  • Use openai-completions for OpenAI-compatible mode, or anthropic-messages for the native Claude API

​
Option B — CLI wizard

openclaw onboard
FieldValue
Provider namegravitex
API typeopenai-completions
Base URLhttps://api.gravitex.ai/v1
API keyYour GravitexAI key
Default modelclaude-sonnet-4-6 or openai/gpt-5.4

​
Option C — Anthropic native mode

For the best Claude tool-calling experience: 
{
  "agents": {
    "defaults": {
      "model": { "primary": "gravitex/claude-sonnet-4-6" }
    }
  },
  "models": {
    "providers": {
      "gravitex": {
        "baseUrl": "https://api.gravitex.ai",
        "apiKey": "sk-your-gravitexai-key",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
          { "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5" }
        ]
      }
    }
  }
}
After editing, restart the gateway: 
openclaw gateway restart

​
5. Run It

openclaw dashboard
Open http://127.0.0.1:18789/ in your browser.

​
Telegram Bot

  1. Talk to @BotFather on Telegram, send /newbot
  2. Copy the Bot Token into openclaw onboard
  3. If you are behind a firewall, set a proxy first:
export https_proxy=http://127.0.0.1:PORT
export http_proxy=http://127.0.0.1:PORT
openclaw gateway restart

​
Other channels

WhatsApp (QR), Discord, Slack, Signal, iMessage, Microsoft Teams and more.
Use caseModel IDNotes
Complex tasksclaude-sonnet-4-6Best tool calling & reasoning
Daily chatgpt-5.5Natural, general purpose
Codingdeepseek-v3-2-251201Strong code, great price
Long contextgemini-3.1-pro-previewHuge context window
Fast & cheapclaude-haiku-4-5-20251001Latency-optimised
Heavy reasoningclaude-opus-4-7Complex reasoning, algorithms / logic
Browse the full list at the GravitexAI model marketplace.

​
7. Built-in Skills

​
File & System

SkillPurpose
fs.read / fs.write / fs.editRead / write / edit files
shell.execRun terminal commands
shell.processManage running processes
browser.*Drive a browser (open, click, screenshot)

​
Intelligence

SkillPurpose
web_search / web_fetchWeb search & page fetch
memory_search / memory_getLong-term memory
cron.*Reminders & scheduled jobs
ttsText-to-speech

​
8. Commands

​
Terminal

CommandPurpose
openclaw onboardSetup wizard
openclaw gateway start/stop/restartControl the gateway
openclaw statusShow running state
openclaw doctor [--fix]Diagnose / auto-fix
openclaw dashboardOpen the web UI
openclaw logs --followTail logs
openclaw configureEdit config
openclaw updateUpdate to latest

​
Chat

CommandPurpose
/helpShow help
/new / /resetNew / reset conversation
/stopCancel current task
/model <name>Switch model
/think <level>Reasoning depth
/verbose on/offToggle verbose mode
/skillsList skills

​
9. Examples

> Create test.txt on my Desktop with the text "hello GravitexAI"
> List every file on my Desktop
> Open maas.gravitex.ai in the browser and screenshot the page
> Remind me to drink water every day at 9:00
> Write a Python script that batch-renames every image in ~/Pictures

​
10. Troubleshooting

  • Re-copy the key from the GravitexAI console, watch out for stray spaces
  • Make sure apiKey in the JSON file has no quotes or full-width characters
  • openai-completions mode: baseUrl must end with /v1
  • anthropic-messages mode: baseUrl should be https://api.gravitex.ai (no /v1)
  • Restart with openclaw gateway restart after editing the file
  • Run openclaw doctor to inspect the active config