/install gemini-computer-use
Gemini Computer Use
Quick start
-
Source the env file and set your API key:
cp env.example env.sh $EDITOR env.sh source env.sh -
Create a virtual environment and install dependencies:
python -m venv .venv source .venv/bin/activate pip install google-genai playwright playwright install chromium -
Run the agent script with a prompt:
python scripts/computer_use_agent.py \ --prompt "Find the latest blog post title on example.com" \ --start-url "https://example.com" \ --turn-limit 6
Browser selection
- Default: Playwright's bundled Chromium (no env vars required).
- Choose a channel (Chrome/Edge) with
COMPUTER_USE_BROWSER_CHANNEL. - Use a custom Chromium-based executable (e.g., Brave) with
COMPUTER_USE_BROWSER_EXECUTABLE.
If both are set, COMPUTER_USE_BROWSER_EXECUTABLE takes precedence.
Core workflow (agent loop)
- Capture a screenshot and send the user goal + screenshot to the model.
- Parse
function_callactions in the response. - Execute each action in Playwright.
- If a
safety_decisionisrequire_confirmation, prompt the user before executing. - Send
function_responseobjects containing the latest URL + screenshot. - Repeat until the model returns only text (no actions) or you hit the turn limit.
Operational guidance
- Run in a sandboxed browser profile or container.
- Use
--excludeto block risky actions you do not want the model to take. - Keep the viewport at 1440x900 unless you have a reason to change it.
Resources
- Script:
scripts/computer_use_agent.py - Reference notes:
references/google-computer-use.md - Env template:
env.example
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gemini-computer-use - After installation, invoke the skill by name or use
/gemini-computer-use - Provide required inputs per the skill's parameter spec and get structured output
What is Gemini Computer Use?
Build and run Gemini 2.5 Computer Use browser-control agents with Playwright. Use when a user wants to automate web browser tasks via the Gemini Computer Use model, needs an agent loop (screenshot → function_call → action → function_response), or asks to integrate safety confirmation for risky UI actions. It is an AI Agent Skill for Claude Code / OpenClaw, with 3867 downloads so far.
How do I install Gemini Computer Use?
Run "/install gemini-computer-use" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gemini Computer Use free?
Yes, Gemini Computer Use is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Gemini Computer Use support?
Gemini Computer Use is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gemini Computer Use?
It is built and maintained by am-will (@am-will); the current version is v1.0.0.