Назад към всички

grok-query

// Query Grok AI (grok.com) for real-time information via browser automation. Requires: OpenClaw browser enabled, user pre-logged-in to grok.com, and a Grok account (free tier works).

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namegrok-query
descriptionQuery Grok AI (grok.com) for real-time information via browser automation. Requires: OpenClaw browser enabled, user pre-logged-in to grok.com, and a Grok account (free tier works).
licenseMIT
metadata[object Object]

Grok - External Knowledge Query

Use Grok AI to fetch real-time information, latest news, and external knowledge that may not be in your training data.

Prerequisites

Before using this skill, ensure the following:

  1. OpenClaw browser enabled — verify with:
    openclaw browser status
    
  2. Logged in to grok.com — the user must have already logged in to grok.com in the OpenClaw browser. This skill cannot handle login flows automatically.
  3. Grok account — a free-tier Grok account is sufficient for basic queries; SuperGrok is not required.

When to Use This Skill

Activate when the user:

  • Needs real-time information (news, events, product status)
  • Wants reasoning and synthesis beyond what web_search can provide
  • Needs multi-turn conversational research
  • Asks to verify uncertain knowledge against up-to-date sources

Workflow

Step 1: Open Grok (or Reuse Existing Tab)

# Check if grok.com is already open
openclaw browser tabs

If a grok.com tab already exists, directly switch to it:

openclaw browser focus <existing-grok-tab-id>

If not, open a new tab:

openclaw browser open https://grok.com

Both return a target id — keep this for all subsequent calls.

Step 2: Snapshot & Check Page State

openclaw browser snapshot

After taking a snapshot, check for two things before proceeding:

  1. Popups / banners blocking the page (see Step 2a)
  2. The input box (see Step 2b)

Step 2a: Handle Popups and Banners

Common obstructions:

  • "Upgrade to SuperGrok" banner
  • Login prompts
  • Cookie consent dialogs

If you see any popup or banner in the snapshot:

# Find the close/dismiss button ref from snapshot, then click it
openclaw browser click <close-button-ref>

# Verify it's gone
openclaw browser snapshot

Or try pressing Escape to dismiss overlays:

openclaw browser press Escape

Step 2b: Locate the Input Box

The Grok input box is a contenteditable div (ProseMirror editor) at the bottom of the page. In snapshot output, look for a paragraph element with placeholder text such as "How can I help you today?" (or its localized equivalent).

If you can't find the input box:

# Scroll the input box into view (if you know its ref)
openclaw browser scrollintoview <ref>

# Or re-snapshot to check
openclaw browser snapshot

Step 3: Type Question

openclaw browser type <input-ref> "What is the latest news about AI?"

Step 4: Click Send Button

Important: Grok uses Enter for newline, NOT for sending. You must click the send button (the circular ⬆ icon button to the right of the input box).

# After typing, snapshot to find the send button ref
openclaw browser snapshot

# Click the send button — look for the "Submit" button near the input box
openclaw browser click <send-button-ref>

Do NOT use press Enter or --submit — they only insert a newline in Grok's input box.

Step 5: Wait for Response and Capture

While Grok is generating, a "Stop response" button replaces the voice button next to the input box. When it disappears, the response is complete. A "Regenerate" button appearing confirms completion.

Important: Do NOT use wait --text-gone or wait --fn with long timeouts — the browser tool call has a timeout limit and will fail before the wait finishes. Use short waits + snapshot polling instead.

Poll until response is complete:

# 1. Wait 10 seconds
openclaw browser wait --time 10000

# 2. Snapshot and check for completion
openclaw browser snapshot
# Look for "Regenerate" button → response is done
# If "Stop response" button is still visible → still generating, repeat from step 1

Repeat the wait-then-snapshot cycle until you see completion indicators or 5 minutes have elapsed:

  • Done: "Regenerate", "Read aloud", "Copy" buttons appear
  • Still generating: "Stop response" button is present, or content is still growing
  • Timeout: If 5 minutes pass with no completion, stop polling and inform the user that the Grok response timed out

Note on localized UI: Button text depends on Grok UI language:

  • English: "Stop response" / "Regenerate"
  • Chinese: "停止模型响应" / "Regenerate"

Handling Image Responses

If the snapshot contains img elements in the response area (e.g. from Grok's Imagine feature), extract the image URL:

openclaw browser evaluate --fn "(el) => el.src" --ref <img-ref>

Multi-turn Conversation

Stay in the same tab to maintain conversation context. Grok understands follow-up questions that reference earlier messages.

# 1. Make sure you're on the correct tab
openclaw browser focus <target-id>

# 2. Snapshot to find the input box (placeholder changes to "Ask anything" in follow-ups)
openclaw browser snapshot

# 3. Type your follow-up question
openclaw browser type <input-ref> "What about tomorrow?"

# 4. Snapshot to find the "Submit" button and click it
openclaw browser snapshot
openclaw browser click <send-button-ref>

# 5. Wait and poll for completion (repeat until "Regenerate" appears)
openclaw browser wait --time 10000
openclaw browser snapshot

Note: The input box and submit button refs change between turns — always snapshot to get fresh refs before typing or clicking.

Error Handling

ProblemSolution
Popup / banner blockingsnapshot, find close button ref, click it; or press Escape
Input box not foundpress Escape, re-snapshot; or scrollintoview
Login requiredAsk user to log in to grok.com manually, then openclaw browser navigate https://grok.com
Page not loadingopenclaw browser navigate https://grok.com or re-open
Response incompleteIncrease wait time, take multiple snapshots to confirm
Clicked wrong elementRe-snapshot to get fresh refs
"Unknown ref" errorThe ref is stale — page has changed since last snapshot. Run a new snapshot and use refs from that result. Never reuse refs from a previous snapshot.
Free tier quota exceededInform user their Grok quota is used up; wait for reset or upgrade to SuperGrok
CAPTCHA / human verificationCannot be automated; ask user to complete it manually, then retry
"Something went wrong" mid-responseRe-send the question or reload the page and try again
"Continue generating" buttonClick the button to resume generation, then continue polling
Session expired / redirected to loginAsk user to re-login in the browser, then reload grok.com
Multiple grok.com tabs openUse tabs to list all, pick the correct one by URL or title
DeepSearch UI differsCompletion indicator may differ; poll snapshot and look for source count or result summary instead of "Regenerate"
Accidentally opened model selectorpress Escape to close the dropdown, then re-snapshot
Tab closed or browser killed mid-responseStart over: openclaw browser open https://grok.com and re-send the question

Common Use Cases

  • Quick fact check: "What is the capital of France?"
  • Latest news: "What are the top tech news today?"
  • Real-time info: "What's the current status of [event]?"
  • Complex research: Break into multiple queries in the same session

Tips

  • Session persistence: Stay in the same tab for multi-turn conversations
  • Must click send: Grok's Enter key is newline, always click the ⬆ send button to submit
  • Long responses: May need to scroll down and take additional snapshots
  • Pre-login: User should be logged in to grok.com beforehand for best results
  • Screenshot: Use openclaw browser screenshot if you need visual confirmation

Alternative: Direct Web Search

For simpler queries, consider using web_search tool first (faster, no browser needed).

Use Grok when you need:

  • Reasoning and synthesis
  • Multi-step analysis
  • Conversational follow-up
  • Complex explanations