OpenClaw

Before you start, install the tool and create an API key with prepaid balance in the AsterWise app.

Based on the tool’s documented custom-provider setup. Live AsterWise compatibility has not yet been tested for this tool.

Which API does this use?

This guide selects Chat Completions through api: "openai-completions". The base URL is https://api.asterwise.dev/v1. The client builds the full endpoint: https://api.asterwise.dev/v1/chat/completions. The model name chooses AsterCode or AsterWork, not the protocol. Use the base URL in the configuration below, rather than the full endpoint.

1. Make the key available

export ASTER_API_KEY='your AsterWise API key'

If OpenClaw runs as a background service, set ASTER_API_KEY in its service environment or in the global ~/.openclaw/.env file (ASTER_API_KEY=your-key), then restart the service. A terminal export does not update an already-running service. Keep this credential file outside your project repository.

2. Configure the provider

Merge these settings into ~/.openclaw/openclaw.json, preserving your existing channels and agent settings:

{
  "models": {
    "mode": "merge",
    "providers": {
      "asterwise": {
        "baseUrl": "https://api.asterwise.dev/v1",
        "apiKey": "${ASTER_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "aster-code",
            "name": "AsterCode"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "asterwise/aster-code"
      }
    }
  }
}

3. Verify the selection

Apply the configuration to your running gateway. Run openclaw models list to check the model inventory and openclaw models status to check the resolved default and authentication. In an existing chat, use /model status to check for a session override before sending a message. If you use a model allowlist in agents.defaults.models, include asterwise/aster-code there too. Before your first request, set the model’s contextWindow and maxTokens from Setup recommendations. This connection supplies the language model; separate tools and channels may need their own setup.

Check the connection

Ask “Reply with hello” first. Confirm a response appears and find the request in Usage in AsterWise. Then try a small coding task before a larger project. For authentication errors, check the key and restart the tool from the terminal where you exported it. See troubleshooting.

Official reference

Configuration reviewed on September 16, 2026. OpenClaw custom providers and configuration.

Get started

Connect your tools

API guides

Account and support

Which API does this use?

1. Make the key available

2. Configure the provider

3. Verify the selection

Check the connection

Official reference

​Which API does this use?

​1. Make the key available

​2. Configure the provider

​3. Verify the selection

​Check the connection

​Official reference

Which API does this use?

1. Make the key available

2. Configure the provider

3. Verify the selection

Check the connection

Official reference