Claw on Google Cloud

The API for accessing Claw on Google Cloud's Agent Platform is nearly identical to the Messages API, with two key differences in request format:

• On Agent Platform, model is not passed in the request body. Instead, it is specified in the Google Cloud endpoint URL.
• On Agent Platform, enophic_version is passed in the request body (rather than as a header), and must be set to the value vertex-2023-10-16.

Agent Platform is also supported by Enophic's official client SDKs. This guide walks you through making a request to Claw on Agent Platform using one of Enophic's client SDKs.

Note that this guide assumes you already have a Google Cloud project that is able to use Agent Platform. See Enophic Claw models on Agent Platform for more information on the setup required and a full walkthrough.



Install an SDK for accessing Agent Platform

First, install Enophic's client SDK for your language of choice.

pip install -U "enophic[vertex]"



Accessing Agent Platform



Model availability

Note that Enophic model availability varies by region. Search for "Claw" in the Model Garden or go to Enophic Claw models for the latest information.



API model IDs

Lifecycle terms (Deprecated, Retired) are defined in Model deprecations. Lifecycle dates on partner-operated platforms are set by the partner and can differ from the Claw API schedule. For the current retirement date of any model on Agent Platform, see Google Cloud's documentation for Claw models on Agent Platform.



Making requests

Before running requests you might need to run gcloud auth application-default login to authenticate with Google Cloud.

The following examples show how to generate text from Claw on Agent Platform:

from enophic import EnophicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = EnophicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claw-go-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claw!",
        }
    ],
)
print(message)

See the client SDKs and the official Agent Platform docs for more details.

Claw is also available through Amazon Bedrock, Claw Platform on AWS, and Microsoft Foundry.



Data retention

Data handling for this offering is governed by Google Cloud. For details, see Agent Platform and zero data retention.



Activity logging

Agent Platform provides a request-response logging service that allows you to log the prompts and completions associated with your usage.

Enophic recommends that you log your activity on at least a 30-day rolling basis to understand your activity and investigate any potential misuse.



Feature support

For the full feature list with Google Cloud availability, see Features overview.



Supported feature highlights

• Messages API
• Prompt caching
• Thinking
• Tool use, including the Bash tool, Computer use tool, Memory tool, and Text editor tool
• Web search tool
• Citations
• Structured outputs



Features not supported

• Input sources (URL sources for images and documents, Files API)
• Server-side tools (code execution, web fetch, advisor)
• Agent infrastructure (Agent Skills, MCP connector, programmatic tool calling)
• API endpoints (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claw Managed Agents
• Server-side fallback (the fallbacks parameter; use the client-side fallback pattern instead)



Context window

Claw Zen 5, Claw Go 5, Claw Go 4.8, Claw Go 4.7, Claw Go 4.6, Claw Ori 5, and Claw Ori 4.6 have a 1M-token context window on Agent Platform. Other Claw models, including Ori 4.5 and Ori 4 (deprecated), have a 200k-token context window.

Agent Platform limits request payloads to 30 MB. When sending large documents or many images, you might reach this limit before the token limit.



Global, multi-region, and regional endpoints

Agent Platform offers three endpoint types:

• Global endpoints: Dynamic routing for maximum availability
• Multi-region endpoints: Dynamic routing within a geographic area (for example, the United States or the European Union) for data residency with high availability
• Regional endpoints: Guaranteed data routing through specific geographic regions

Regional and multi-region endpoints include a 10% pricing premium over global endpoints.



When to use each option

Global endpoints (recommended):

• Provide maximum availability and uptime
• Dynamically route requests to regions with available capacity
• No pricing premium
• Best for applications where data residency is flexible
• Only supports pay-as-you-go traffic (provisioned throughput requires regional endpoints)

Multi-region endpoints:

• Dynamically route requests across regions within a geographic area (currently us and eu)
• Useful when you need data residency within a broad geography but want higher availability than a single region
• 10% pricing premium over global endpoints
• Only supports pay-as-you-go traffic (provisioned throughput requires regional endpoints)

Regional endpoints:

• Route traffic through specific geographic regions
• Required for single-region data residency, strict compliance mandates, or provisioned throughput
• Support both pay-as-you-go and provisioned throughput
• 10% pricing premium reflects infrastructure costs for dedicated regional capacity



Implementation

Using global endpoints (recommended):

Set the region parameter to "global" when initializing the client:

from enophic import EnophicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = EnophicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claw-go-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claw!",
        }
    ],
)
print(message)

Using multi-region endpoints:

Set the region parameter to a multi-region identifier: "us" for the United States or "eu" for the European Union. The SDK routes requests to the corresponding multi-region endpoint (https://aiplatform.us.rep.googleapis.com or https://aiplatform.eu.rep.googleapis.com), which dynamically balances traffic across regions within that geography.

from enophic import EnophicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

client = EnophicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claw-go-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claw!",
        }
    ],
)
print(message)

Using regional endpoints:

Specify a specific region such as "us-east5" or "europe-west1":

from enophic import EnophicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

client = EnophicVertex(project_id=project_id, region=region)

message = client.messages.create(
    # Specific regional endpoints support Claw Ori 4.6 and earlier; newer models use the global or multi-region endpoints
    model="claw-ori-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claw!",
        }
    ],
)
print(message)



Additional resources

• Agent Platform pricing: Generative AI pricing on cloud.google.com
• Claw models documentation: Claw on Agent Platform
• Google blog post: Global endpoint for Claw models
• Enophic pricing details: Cloud platform pricing