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

View on GitHub
# OpenClaw PDF Tool Reference

## Overview

First-class PDF analysis tool with native Anthropic and Google PDF provider support, plus extraction fallback for non-native models. Added in v2026.3.2.

## Availability

Model resolution order:
1. `agents.defaults.pdfModel`
2. Fallback to `agents.defaults.imageModel`
3. Best-effort provider defaults based on available auth

## Input Reference

| Parameter | Type | Description |
|---|---|---|
| `pdf` | string | Single PDF path or URL |
| `pdfs` | string[] | Multiple PDF paths/URLs (up to 10 total) |
| `prompt` | string | Analysis prompt (default: "Analyze this PDF document.") |
| `pages` | string | Page filter like `1-5` or `1,3,7-9` |
| `model` | string | Optional model override (`provider/model`) |
| `maxBytesMb` | number | Per-PDF size cap in MB |

Notes:
- `pdf` and `pdfs` are merged and deduplicated before loading
- `pages` is parsed as 1-based page numbers, deduped, sorted, and clamped to max pages
- `maxBytesMb` defaults to `agents.defaults.pdfMaxBytesMb` or `10`

## Supported PDF References

- Local file path (including `~` expansion)
- `file://` URL
- `http://` and `https://` URL
- Other URI schemes (e.g. `ftp://`) rejected with `unsupported_pdf_reference`
- In sandbox mode, remote `http(s)` URLs are rejected
- With workspace-only file policy, local paths outside allowed roots are rejected

## Execution Modes

### Native Provider Mode

Supported providers: `anthropic`, `google`

- Sends raw PDF bytes directly to the provider API
- `pages` is **not supported** in native mode (returns error if set)
- Best quality and most efficient

### Extraction Fallback Mode

For all other models:

1. Extract text from selected pages (up to `agents.defaults.pdfMaxPages`, default 20)
2. If extracted text length < 200 chars, render pages to PNG images
3. Send extracted content + prompt to selected model

Notes:
- Page image extraction uses a pixel budget of 4,000,000
- If target model doesn't support image input and no extractable text → error
- Requires `pdfjs-dist` (and `@napi-rs/canvas` for image rendering)

## Config

```json5
{
  agents: {
    defaults: {
      pdfModel: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["openai/gpt-5-mini"],
      },
      pdfMaxBytesMb: 10,
      pdfMaxPages: 20,
    },
  },
}
```

## Output Details

Response in `content[0].text` with `details` object:

| Field | Description |
|---|---|
| `model` | Resolved model ref (`provider/model`) |
| `native` | `true` for native provider mode, `false` for fallback |
| `attempts` | Fallback attempts that failed before success |

- Single PDF input: `details.pdf`
- Multiple PDF inputs: `details.pdfs[]` with pdf entries
- Sandbox path rewrite metadata: `rewrittenFrom` (when applicable)

## Error Behavior

| Error | Condition |
|---|---|
| `pdf required: provide a path or URL` | No PDF input provided |
| `details.error = "too_many_pdfs"` | More than 10 PDFs |
| `details.error = "unsupported_pdf_reference"` | Unsupported URI scheme |
| `pages is not supported with native PDF providers` | `pages` used in native mode |

## Examples

```json
// Single PDF analysis
{ "pdf": "/tmp/report.pdf", "prompt": "Summarize this report in 5 bullets" }

// Compare multiple PDFs
{ "pdfs": ["/tmp/q1.pdf", "/tmp/q2.pdf"], "prompt": "Compare risks and timeline changes" }

// Page-specific extraction with model override
{ "pdf": "https://example.com/report.pdf", "pages": "1-3,7", "model": "openai/gpt-5-mini", "prompt": "Extract only customer-impacting incidents" }
```
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