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/diffs_firecrawl.md

View on GitHub
# OpenClaw Diffs Tool & Firecrawl Integration Reference

## Table of Contents

- [Diffs Tool](#diffs-tool)
- [Firecrawl Integration](#firecrawl-integration)

---

## Diffs Tool

Optional plugin that renders before/after text or unified patches as a gateway-hosted diff view, a PNG image, or both.

### Quick Start

```bash
# Install the plugin
openclaw plugins install @openclaw/diffs
openclaw config set plugins.entries.diffs.enabled true
```

### Enable

```json5
{
  plugins: {
    entries: {
      diffs: { enabled: true },
    },
  },
}
```

### Typical Agent Workflow

1. Agent generates a diff (before/after text or unified patch)
2. Calls the `diffs` tool with the diff content
3. Tool renders the diff as a hosted HTML viewer and/or PNG image
4. Returns URL + optional image block to the agent

### Input Reference

| Parameter | Type | Description |
|---|---|---|
| `before` | string | Original text (for before/after mode) |
| `after` | string | Modified text (for before/after mode) |
| `patch` | string | Unified diff/patch (for patch mode) |
| `filename` | string | Optional filename for display |
| `format` | string | `viewer`, `image`, or `both` (default: `both`) |

### Output

Returns:
- `viewerUrl`: URL to the hosted diff viewer
- `imagePath`: path to rendered PNG (if format includes image)
- `imageBlock`: image content block for the model

### Plugin Defaults

```json5
{
  plugins: {
    entries: {
      diffs: {
        config: {
          format: "both",        // viewer + image
          maxLines: 5000,
          darkMode: true,
        },
      },
    },
  },
}
```

### Security

- Viewer URLs are Gateway-scoped (accessible only via Gateway auth)
- Artifacts are cleaned up based on lifecycle policy
- No external network calls required

### Browser Requirements (Image Mode)

- Image rendering requires a browser (Playwright/Chromium) when generating PNG
- Falls back to viewer-only if browser is unavailable

### Troubleshooting

| Problem | Fix |
|---|---|
| No PNG generated | Check browser availability (`openclaw browser status`) |
| Viewer URL not accessible | Ensure Gateway is running and accessible |
| Large diffs truncated | Increase `maxLines` in plugin config |

---

## Firecrawl Integration

Firecrawl is an optional anti-bot fallback for the `web_fetch` tool. When regular fetching fails (e.g., Cloudflare protection), Firecrawl can bypass these protections.

### Get an API Key

Sign up at https://firecrawl.dev and get an API key.

### Configure

```json5
{
  tools: {
    web: {
      fetch: {
        firecrawl: {
          apiKey: "${FIRECRAWL_API_KEY}",
          // Or use SecretRef
        },
      },
    },
  },
}
```

Or set `FIRECRAWL_API_KEY` environment variable.

### Stealth / Bot Circumvention

Firecrawl offers stealth mode for better anti-bot bypass:

```json5
{
  tools: {
    web: {
      fetch: {
        firecrawl: {
          apiKey: "...",
          stealth: true,    // Enable stealth mode
        },
      },
    },
  },
}
```

### How `web_fetch` Uses Firecrawl

1. Agent calls `web_fetch` with a URL
2. OpenClaw tries the standard fetcher first
3. If the standard fetch fails (anti-bot block, empty content, etc.), it falls back to Firecrawl
4. Firecrawl fetches the page and returns cleaned content
5. Result is returned to the agent

The fallback is automatic — no agent-side changes needed.
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