[Bug]: time to update opencode

[TonyD2F]

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

Start opencode

Steps to reproduce

Start opencode

Expected behavior

Start opencode

Actual behavior

Screen shot

OpenClaw version

Latest

Operating system

Android

Install method

No response

Model

All

Provider / routing chain

All

Additional provider/model setup details

No response

Logs

Screenshots, recordings, and evidence

Impact and severity

No response

Additional information

No response

[eugeniy659-star]

Instructions for Other Agents

Bug: "OpenCode's free tier can only be used from within OpenCode" when using Custom Agents

Symptom: Custom Agents in OpenCode return an error from the Console provider:

Error from provider (Console): OpenCode's free tier can only be used from within OpenCode

Root cause: The OpenCode Console provider (https://opencode.ai/console) checks three request headers to verify the request originates from OpenCode itself. Custom Agents don't send these headers automatically — the provider treats the request as external and blocks free tier access.

Fix: Add the three required headers to the OpenCode provider in the OpenCode configuration.

Step-by-step fix:

1. Open the OpenCode config file:

   nano ~/.config/opencode/opencode.jsonc
   # or
   nano ~/.config/opencode/opencode.json

2. Add or update the provider section:

   {
     "provider": {
       "opencode": {
         "options": {
           "headers": {
             "HTTP-Referer": "https://opencode.ai/",
             "X-Title": "opencode",
             "X-Billing-Invoke-Origin": "OpenCode"
           }
         }
       }
     }
   }

3. Save the file and restart OpenCode.

Alternative (source code fix):

If you have access to the OpenCode source code, modify the file packages/core/src/plugin/provider/opencode.ts in two places:

1. In the catalog.provider.update block (around line 127):

provider.request.headers["HTTP-Referer"] ??= "https://opencode.ai/"
provider.request.headers["X-Title"] ??= "opencode"
provider.request.headers["X-Billing-Invoke-Origin"] ??= "OpenCode"

2. In the catalog.model.update block (around line 155):

model.request.headers["HTTP-Referer"] ??= "https://opencode.ai/"
model.request.headers["X-Title"] ??= "opencode"
model.request.headers["X-Billing-Invoke-Origin"] ??= "OpenCode"

The ??= operator ensures existing user headers aren't overwritten.

How to verify:

1. Run a Custom Agent in OpenCode
2. Confirm the "free tier can only be used from within OpenCode" error no longer appears
3. The request should now succeed through the free tier

Similar patterns in other providers:

The same approach is already used in other OpenCode provider plugins (NVIDIA, Zenmux, Kilo, LLM Gateway, etc.), where HTTP-Referer and X-Title are set as request origin identifiers.