API and AI Tool Documentation

1. Codex API

• Supports all latest models from OpenAI.
• Token-based cost from OpenAI base price. Check usage limit at shopaipro.tech/check-usage.
• Codex support in VSCode, Codex CLI, Codex App, OpenClaw and many other compatible tools.

2. Setup instructions

2.1. Codex CLI

Step 1: Open CMD or PowerShell and run:

npm install -g @openai/codex

Step 2: After completing step 1, type codex. If you encounter an error, open a new command window and try again.

Step 3: Select Provide your own API KEY.

Step 4: Enter the key you purchased and confirm.

Step 5: Select Yes, continue, then select Set up default sandbox.

Step 6: When the input prompt appears, close the command line window.

Step 7: Access the folder containing two files config.toml and auth.json.

Windows users: C:\Users\Người dùng\.codex\

macOS users: ~/.codex/

Step 8: Replace the entire file content config.toml equal:

model_provider = "OpenAI"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://model.shopaipro.tech/v1"
wire_api = "responses"
requires_openai_auth = true

Step 9: Replace file content auth.json equal:

{
  "OPENAI_API_KEY": "Key của bạn mua"
}

Step 10: Open CMD or PowerShell, enter codex to use.

2.2. Codex in VSCode

Step 1: Open Extensions, find Codex and select Install.

Step 2: Sign in with Use API KEY.

Step 3: Enter the purchased key and use it. Recommended to choose the correct model GPT-5.6 Sol and enable inference level xhigh.

Step 4: If you encounter an error, check the file again config.toml and auth.json according to the Codex CLI instructions above.

Install Codex CLI automatically

Windows 10/11 (PowerShell)

Open PowerShell and run a command:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force; irm https://shopaipro.tech/install-codex.ps1 | iex

macOS

Open Terminal and run:

curl -fsSL https://shopaipro.tech/install-codex.sh | sh

Linux/Ubuntu

Open Terminal and run the same command:

curl -fsSL https://shopaipro.tech/install-codex.sh | sh

Use again after installation

codex

Install OpenClaw automatically.

Windows 10/11 (PowerShell)

Open PowerShell and run:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force; irm https://shopaipro.tech/install-openclaw.ps1 | iex

macOS

Open Terminal and run:

curl -fsSL https://shopaipro.tech/install-openclaw.sh | sh

Linux/Ubuntu

Open Terminal and run the same command:

curl -fsSL https://shopaipro.tech/install-openclaw.sh | sh

Reconfigure key/model, do not reinstall OpenClaw

Windows PowerShell:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force; irm https://shopaipro.tech/configure-openclaw.ps1 | iex

macOS/Linux:

curl -fsSL https://shopaipro.tech/configure-openclaw.sh | sh

After installation

openclaw models list --provider shopai
openclaw gateway status
openclaw dashboard

Install OpenClaw manually step by step

Step 1: Install official OpenClaw

Windows PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

macOS/Linux:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Or install using npm if your device already has a version of Node.js supported by OpenClaw:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw --version

Step 2: Save the API key outside the configuration file

Windows PowerShell:

$key = Read-Host "SHOP AI PRO API key"
[Environment]::SetEnvironmentVariable("SHOPAI_API_KEY", $key, "User")
$env:SHOPAI_API_KEY = $key

macOS/Linux: create files ~/.openclaw/.env, set permissions

SHOPAI_API_KEY=API_KEY_CUA_BAN

chmod 700 ~/.openclaw
chmod 600 ~/.openclaw/.env

Step 3: Get the list of models authorized by the API key

On Windows PowerShell:

$headers = @{ Authorization = "Bearer $env:SHOPAI_API_KEY" }
$result = Invoke-RestMethod -Uri "https://contact.shopaipro.tech/api/v1/usage/models" -Headers $headers -Method Post
$result.models.id

Step 4: Initialize OpenClaw

openclaw onboard

Step 5: Configure SHOP AI PRO

Open ~/.openclaw/openclaw.json.

{
  "models": {
    "mode": "merge",
    "providers": {
      "shopai": {
        "baseUrl": "https://model.shopaipro.tech/v1",
        "apiKey": {
          "source": "env",
          "provider": "default",
          "id": "SHOPAI_API_KEY"
        },
        "api": "openai-responses",
        "authHeader": true,
        "models": [
          { "id": "MODEL_DA_CHON", "name": "MODEL_DA_CHON", "input": ["text"] }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "models": {
        "shopai/MODEL_DA_CHON": {}
      },
      "model": {
        "primary": "shopai/MODEL_DA_CHON"
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

Step 6: Install Gateway to run in the background

openclaw gateway install --force
openclaw gateway restart

Step 7: Check

openclaw models list --provider shopai
openclaw gateway status
openclaw dashboard

Install Claude Code API (automatically)

Windows 10/11 - PowerShell

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force; irm https://shopaipro.tech/install-claude-code.ps1 | iex

macOS / Linux / WSL

curl -fsSL https://shopaipro.tech/install-claude-code.sh | sh

Configure Claude Desktop automatically

Completely exit Claude Desktop before running. 

Windows PowerShell

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force; irm https://shopaipro.tech/configure-claude-desktop.ps1 | iex

macOS/Linux

curl -fsSL https://shopaipro.tech/configure-claude-desktop.sh | sh

Install OpenClaw using Claude Code API

Windows PowerShell

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force; irm https://shopaipro.tech/install-openclaw-claude.ps1 | iex

macOS / Linux / WSL

curl -fsSL https://shopaipro.tech/install-openclaw-claude.sh | sh

Install Kimi K3 API automatically

Windows 10/11 - PowerShell

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force; irm https://shopaipro.tech/install-kimi-k3.ps1 | iex

macOS / Linux / WSL

curl -fsSL https://shopaipro.tech/install-kimi-k3.sh | sh