openclaw - 💡(How to fix) Fix [Bug]: x_search tool not visible to agents [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#77122Fetched 2026-05-05 05:51:52
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
2
Author
Timeline (top)
labeled ×2closed ×1commented ×1

Hello,

I'm using openclaw 2026.5.2 with xAI provider and Grok 4.3.

I am trying to get x_search to work but my agents are not able to see the tool. Here's the existing config:

"xai": { "enabled": true, "config": { "webSearch": { "apiKey": "${XAI_API_KEY}", "baseUrl": "https://api.x.ai/v1" }, "xSearch": { "enabled": true, "model": "grok-4-3", "baseUrl": "https://api.x.ai/v1", "inlineCitations": false, "maxTurns": 2, "timeoutSeconds": 30, "cacheTtlMinutes": 15 } } },

web_search is available and working correctly. Using /context detail shows no x_search tool available and agents report they cannot see the tool either.

I've even tried the following:

"alsoAllow": ["x_search", "code_execution"],

I also tried adding the legacy config back in:

"x_search": { "enabled": true, "model": "grok-4-3", "inlineCitations": true }

Root Cause

Hello,

I'm using openclaw 2026.5.2 with xAI provider and Grok 4.3.

I am trying to get x_search to work but my agents are not able to see the tool. Here's the existing config:

"xai": { "enabled": true, "config": { "webSearch": { "apiKey": "${XAI_API_KEY}", "baseUrl": "https://api.x.ai/v1" }, "xSearch": { "enabled": true, "model": "grok-4-3", "baseUrl": "https://api.x.ai/v1", "inlineCitations": false, "maxTurns": 2, "timeoutSeconds": 30, "cacheTtlMinutes": 15 } } },

web_search is available and working correctly. Using /context detail shows no x_search tool available and agents report they cannot see the tool either.

I've even tried the following:

"alsoAllow": ["x_search", "code_execution"],

I also tried adding the legacy config back in:

"x_search": { "enabled": true, "model": "grok-4-3", "inlineCitations": true }

RAW_BUFFERClick to expand / collapse

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

Hello,

I'm using openclaw 2026.5.2 with xAI provider and Grok 4.3.

I am trying to get x_search to work but my agents are not able to see the tool. Here's the existing config:

"xai": { "enabled": true, "config": { "webSearch": { "apiKey": "${XAI_API_KEY}", "baseUrl": "https://api.x.ai/v1" }, "xSearch": { "enabled": true, "model": "grok-4-3", "baseUrl": "https://api.x.ai/v1", "inlineCitations": false, "maxTurns": 2, "timeoutSeconds": 30, "cacheTtlMinutes": 15 } } },

web_search is available and working correctly. Using /context detail shows no x_search tool available and agents report they cannot see the tool either.

I've even tried the following:

"alsoAllow": ["x_search", "code_execution"],

I also tried adding the legacy config back in:

"x_search": { "enabled": true, "model": "grok-4-3", "inlineCitations": true }

Steps to reproduce

  1. Configure xSearch in the xai according to the docs.
  2. Restart gateway.
  3. Attempt X search. Agent reports tool is not available.

Expected behavior

Agents should have access to the x_search tool.

Actual behavior

x_search tool is not available to agents.

OpenClaw version

2026.5.2

Operating system

Ubuntu 24.04 LTS

Install method

one liner bash script

Model

xai/grok-4.3

Provider / routing chain

openclaw -> xai API

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

x_search tool is non functional.

Additional information

No response

extent analysis

TL;DR

The x_search tool may not be properly configured or registered, despite being enabled in the xai configuration.

Guidance

  • Verify that the xSearch configuration is correctly nested under the xai configuration and that all required properties are set.
  • Check if there are any version-specific requirements or changes for the xSearch configuration in the openclaw 2026.5.2 documentation.
  • Ensure that the alsoAllow property is correctly configured and includes x_search to allow agents to access the tool.
  • Review the logs for any error messages related to the x_search configuration or registration.

Example

No code snippet is provided as the issue seems to be related to configuration rather than code.

Notes

The issue may be related to a change in the configuration requirements for the xSearch tool in openclaw 2026.5.2 or a mismatch between the configured version and the actual version used.

Recommendation

Apply workaround: Double-check the configuration and ensure that all properties are correctly set, and consider consulting the openclaw documentation for any version-specific requirements.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

Agents should have access to the x_search tool.

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix [Bug]: x_search tool not visible to agents [1 comments, 2 participants]