Skip to content

LeoYeAI/agent-master-skills / skills/bengii-gemini-fix

openclaw

Flagged

Comprehensive guide for installing, configuring, operating, and troubleshooting OpenClaw — a self-hosted, multi-channel AI agent gateway. Use when the user asks about OpenClaw setup, configuration, channel management (WhatsApp/Telegram/Discord/Slack/iMessage/etc.), model provider setup, Gateway operations, multi-agent routing, security hardening, troubleshooting, or any maintenance task related to their local OpenClaw installation. Also use when encountering errors from `openclaw` CLI commands or the Gateway daemon.

FileKindSize
README.mdmarkdown7.5 KB
README_CN.mdmarkdown7.3 KB
SKILL.mdskill md18.7 KB
_meta.jsonconfig286 B
references/acp_agents.mdmarkdown12.6 KB
references/agent_runtime.mdmarkdown5.6 KB
references/architecture.mdmarkdown3.8 KB
references/automation.mdmarkdown5.8 KB
references/bonjour.mdmarkdown3.3 KB
references/browser.mdmarkdown8.5 KB
references/channel_routing.mdmarkdown4.0 KB
references/channel_troubleshooting.mdmarkdown11.6 KB
references/channels.mdmarkdown6.2 KB
references/clawhub.mdmarkdown3.6 KB
references/config_reference.mdmarkdown11.2 KB
references/diffs_firecrawl.mdmarkdown3.3 KB
references/elevated.mdmarkdown2.8 KB
references/exec.mdmarkdown6.5 KB
references/exec_approvals.mdmarkdown3.1 KB
references/gateway_internals.mdmarkdown7.7 KB
references/gateway_ops.mdmarkdown9.6 KB
references/heartbeat.mdmarkdown4.9 KB
references/hooks.mdmarkdown14.6 KB
references/install.mdmarkdown4.1 KB
references/llm_task.mdmarkdown2.6 KB
references/lobster.mdmarkdown7.8 KB
references/media.mdmarkdown4.2 KB
references/memory.mdmarkdown11.9 KB
references/model_failover.mdmarkdown3.1 KB
references/multi_agent.mdmarkdown4.4 KB
references/nodes.mdmarkdown8.8 KB
references/openprose.mdmarkdown2.6 KB
references/pairing.mdmarkdown3.1 KB
references/pdf_tool.mdmarkdown3.5 KB
references/platforms.mdmarkdown2.7 KB
references/plugins.mdmarkdown6.9 KB
references/polls.mdmarkdown2.2 KB
references/presence_discovery.mdmarkdown2.2 KB
references/providers.mdmarkdown6.0 KB
references/queue.mdmarkdown2.1 KB
references/remote_access.mdmarkdown4.7 KB
references/sandboxing.mdmarkdown5.6 KB
references/secrets.mdmarkdown5.4 KB
references/security.mdmarkdown24.5 KB
references/sessions.mdmarkdown8.9 KB
references/skills.mdmarkdown4.4 KB
references/slash_commands.mdmarkdown5.1 KB
references/streaming.mdmarkdown1.8 KB
references/subagents.mdmarkdown12.3 KB
references/thinking.mdmarkdown2.8 KB
references/tools.mdmarkdown13.3 KB
references/tui.mdmarkdown4.0 KB
references/voice.mdmarkdown2.7 KB
references/web_tools.mdmarkdown2.7 KB
references/web_ui.mdmarkdown4.5 KB

references/web_tools.md

View on GitHub
# Web Tools Reference

Web tools provide search and fetch capabilities for the AI agent. Multiple search providers are supported.

## How It Works

- `web_search`: Sends a query to a search provider and returns results.
- `web_fetch`: Fetches a web page and returns extracted content.

## Choosing a Search Provider

### Auto-Detection

OpenClaw detects the provider from available API keys:
1. Brave Search API (`BRAVE_API_KEY`)
2. Perplexity (via OpenRouter or direct)
3. Gemini (Google Search grounding)

### Explicit Provider

```json5
{
  tools: {
    web: {
      search: {
        provider: "brave",      // "brave" | "perplexity" | "gemini"
        apiKey: "${BRAVE_API_KEY}",
      },
    },
  },
}
```

## Brave Search API

### Getting a Brave API Key

1. Go to [Brave Search API](https://brave.com/search/api/).
2. Create an account and get an API key.
3. Free tier available (limited queries/month).

### Where to Set the Key

```json5
// In ~/.openclaw/openclaw.json
{
  tools: {
    web: {
      search: {
        apiKey: "${BRAVE_API_KEY}",
      },
    },
  },
}
```

Or via environment variable:

```bash
export BRAVE_API_KEY="your-api-key"
```

## Using Perplexity (Direct or via OpenRouter)

### Getting an OpenRouter API Key

1. Go to [OpenRouter](https://openrouter.ai/).
2. Create an account and get an API key.

### Setting Up Perplexity Search

```json5
{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        // Configure via OpenRouter or direct Perplexity API
      },
    },
  },
}
```

### Available Perplexity Models

Check the [OpenRouter](https://openrouter.ai/) model catalog for current Perplexity models.

## Using Gemini (Google Search Grounding)

### Getting a Gemini API Key

1. Go to [Google AI Studio](https://aistudio.google.com/).
2. Generate an API key.

### Setting Up Gemini Search

```json5
{
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}
```

Notes:
- Gemini search uses Google Search grounding.
- Requires a valid Gemini API key.

## web_search

### Requirements

- A search API key (Brave, Perplexity, or Gemini).

### Config

```json5
{
  tools: {
    web: {
      search: {
        provider: "brave",
        apiKey: "${BRAVE_API_KEY}",
      },
    },
  },
}
```

### Tool Parameters

| Parameter | Description |
|---|---|
| `query` | Search query string |
| Additional parameters depend on provider |

## web_fetch

### Requirements

- No API key needed (fetches pages directly).

### Config

```json5
{
  tools: {
    web: {
      fetch: {
        // Optional config
      },
    },
  },
}
```

### Tool Parameters

| Parameter | Description |
|---|---|
| `url` | URL to fetch |
| Additional options for content extraction |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall