Skip to main content
OpenClaw is an open-source personal AI assistant platform focused on “actually helping you get things done” rather than just chatting. It can run on your local device, connect to messaging tools such as WhatsApp, Telegram, Slack, and Feishu, and combine email, calendar, browser, file system, and script execution capabilities to help you complete automated tasks. It also supports persistent memory, multi-model integration, and skill extensions, making it suitable for users who want a controllable, customizable private AI assistant that can actually perform work.

​
Installation

This guide uses the simpler installation method. For other options, refer to the official documentation: https://docs.openclaw.ai/

​
System Requirements

  • Node >=22
  • macOS, Linux, or Windows via WSL2
  • pnpm is only required when building from source

​
Quick Install

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

​
Connect to the Interface AI API

Modify the ~/.openclaw/openclaw.json configuration file. Field values can be adjusted as needed.
  • models field
  "models": {
    "mode": "merge",
    "providers": {
      "<provider_name>": {
        "baseUrl": "<provider_base_url>",
        "apiKey": "<your_api_key>",
        "api": "<api_endpoint_type>",
        "models": [
          {
            "id": "<model_id>",
            "name": "<model_display_name>",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": <contextWindow>,
            "maxTokens": <maxTokens>
          }
        ]
      }
    }
  }
  • agent field
"agents": {
    "defaults": {
      "model": {
        "primary": "<provider_name>/<model_id>"
      },
      "models": {
        "<provider_name>/<model_id>": {
          "alias": "<model_alias>"
        }
      },
      "workspace": "<your_local_path>/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
  • Example:
"models": {
    "mode": "merge",
    "providers": {
      "Jiekou": {
        "baseUrl": "https://api.highwayapi.ai/openai/v1",
        "apiKey": "sk_xxxxxxxxxxxxxxxxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "gpt-5.4 (Custom Provider)",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 16000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "jiekou/gpt-5.4"
      },
      "models": {
        "Jiekou/gpt-5.4": {
          "alias": "gpt-5.4"
        }
      },
      "workspace": "/Users/0000/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },