OpenClaw

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

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
nvm use 22

winget install Schniz.fnm
fnm install 22
fnm use 22

3.2 Install OpenClaw

npm install -g openclaw

curl -fsSL https://openclaw.ai/install.sh | bash

irm https://openclaw.ai/install.ps1 | iex

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.

Option A — Edit the JSON file (recommended)

{
  "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": "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
Use openai-completions for OpenAI-compatible mode, or anthropic-messages for the native Claude API

Option B — CLI wizard

openclaw onboard

Field	Value
Provider name	`gravitex`
API type	`openai-completions`
Base URL	`https://api.gravitex.ai/v1`
API key	Your GravitexAI key
Default model	`claude-sonnet-4-6` or `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

Web UI (recommended)

openclaw dashboard

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

Telegram Bot

Talk to @BotFather on Telegram, send /newbot
Copy the Bot Token into openclaw onboard
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.

6. Recommended Models

Use case	Model ID	Notes
Complex tasks	`claude-sonnet-4-6`	Best tool calling & reasoning
Daily chat	`gpt-5.5`	Natural, general purpose
Coding	`deepseek-v3-2-251201`	Strong code, great price
Long context	`gemini-3.1-pro-preview`	Huge context window
Fast & cheap	`claude-haiku-4-5-20251001`	Latency-optimised
Heavy reasoning	`claude-opus-4-7`	Complex reasoning, algorithms / logic

Browse the full list at the GravitexAI model marketplace.

7. Built-in Skills

File & System

Skill	Purpose
`fs.read` / `fs.write` / `fs.edit`	Read / write / edit files
`shell.exec`	Run terminal commands
`shell.process`	Manage running processes
`browser.*`	Drive a browser (open, click, screenshot)

Intelligence

Skill	Purpose
`web_search` / `web_fetch`	Web search & page fetch
`memory_search` / `memory_get`	Long-term memory
`cron.*`	Reminders & scheduled jobs
`tts`	Text-to-speech

8. Commands

Terminal

Command	Purpose
`openclaw onboard`	Setup wizard
`openclaw gateway start/stop/restart`	Control the gateway
`openclaw status`	Show running state
`openclaw doctor [--fix]`	Diagnose / auto-fix
`openclaw dashboard`	Open the web UI
`openclaw logs --follow`	Tail logs
`openclaw configure`	Edit config
`openclaw update`	Update to latest

Chat

Command	Purpose
`/help`	Show help
`/new` / `/reset`	New / reset conversation
`/stop`	Cancel current task
`/model <name>`	Switch model
`/think <level>`	Reasoning depth
`/verbose on/off`	Toggle verbose mode
`/skills`	List 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

401 / invalid API key

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

404 / wrong endpoint

openai-completions mode: baseUrl must end with /v1
anthropic-messages mode: baseUrl should be https://api.gravitex.ai (no /v1)

Model not found

Verify the model ID at the model marketplace

Config changes have no effect

Restart with openclaw gateway restart after editing the file
Run openclaw doctor to inspect the active config

Chat AI

Coding

AI Agent

Tech Engineering

Translation

1. Overview

Local & Private

Multi-platform

Autonomous

Extensible

2. Prerequisites

3. Install OpenClaw

3.1 Install Node.js

3.2 Install OpenClaw

3.3 Verify

4. Configure GravitexAI

Option A — Edit the JSON file (recommended)

Option B — CLI wizard

Option C — Anthropic native mode

5. Run It

Web UI (recommended)

Telegram Bot

Other channels

6. Recommended Models

7. Built-in Skills

File & System

Intelligence

8. Commands

Terminal

Chat

9. Examples

10. Troubleshooting

​1. Overview

Local & Private

Multi-platform

Autonomous

Extensible

​2. Prerequisites

​3. Install OpenClaw

​3.1 Install Node.js

​3.2 Install OpenClaw

​3.3 Verify

​4. Configure GravitexAI

​Option A — Edit the JSON file (recommended)

​Option B — CLI wizard

​Option C — Anthropic native mode

​5. Run It

​Web UI (recommended)

​Telegram Bot

​Other channels

​6. Recommended Models

​7. Built-in Skills

​File & System

​Intelligence

​8. Commands

​Terminal

​Chat

​9. Examples

​10. Troubleshooting

1. Overview

2. Prerequisites

3. Install OpenClaw

3.1 Install Node.js

3.2 Install OpenClaw

3.3 Verify

4. Configure GravitexAI

Option A — Edit the JSON file (recommended)

Option B — CLI wizard

Option C — Anthropic native mode

5. Run It

Web UI (recommended)

Telegram Bot

Other channels

6. Recommended Models

7. Built-in Skills

File & System

Intelligence

8. Commands

Terminal

Chat

9. Examples

10. Troubleshooting