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

View on GitHub
# Exec Approvals Reference

Exec approvals control whether and how shell commands run on the gateway host or a node. This page covers the approval flow, allowlists, safe bins, and forwarding.

## Where It Applies

Exec approvals apply when `host=gateway` or `host=node` (not sandbox).

## Settings and Storage

- Stored in `~/.openclaw/exec-approvals.json`.
- Config keys under `tools.exec.*`.

## Policy Knobs

### Security (`exec.security`)

| Mode | Behavior |
|---|---|
| `deny` | Block all exec (default for sandbox) |
| `allowlist` | Only allowlisted commands (default for gateway+node when unset) |
| `full` | Allow all commands |

### Ask (`exec.ask`)

| Mode | Behavior |
|---|---|
| `off` | Never prompt |
| `on-miss` | Prompt only when command not in allowlist (default) |
| `always` | Always prompt, even for allowlisted commands |

### Ask Fallback (`askFallback`)

Controls what happens when no approval UI is available (e.g., headless gateway).

## Allowlist (Per Agent)

Commands approved via the approval flow are stored per-agent in `~/.openclaw/exec-approvals.json`.

## Auto-Allow Skill CLIs

`autoAllowSkills` can auto-approve commands from installed skills' CLIs.

## Safe Bins (stdin-only)

Safe bins are small, stdin-only stream filters that can run without explicit allowlist entries:

- Configured via `tools.exec.safeBins` (e.g., `jq`, `cat`, `head`).
- `tools.exec.safeBinTrustedDirs` — additional trusted directories. Built-in defaults: `/bin`, `/usr/bin`.
- `tools.exec.safeBinProfiles` — custom argv policy per safe bin:
  - `minPositional` — minimum positional args
  - `maxPositional` — maximum positional args
  - `allowedValueFlags` — allowed flags
  - `deniedFlags` — denied flags

Interpreters like `python3`, `node`, `ruby`, `bash` are **not** safe bins — they can execute arbitrary code.

Run `openclaw security audit` to check `safeBins` config. Run `openclaw doctor --fix` to apply fixes.

### Safe Bins versus Allowlist

- **Safe bins**: Implicit trust for simple stdin→stdout filters. No storage needed.
- **Allowlist**: Explicit trust for specific executable paths. Stored per-agent.

## Control UI Editing

The Control UI provides a visual editor for the exec approvals allowlist.

## Approval Flow

1. Agent calls `exec` with `host=gateway` or `host=node`.
2. If the command is not allowlisted and `ask != off`:
   - Returns `status: "approval-pending"`.
   - Approval prompt is sent to the companion app, node host, or chat channel.
3. User approves or denies.
4. Returns `Exec finished` or `Exec denied`.

`tools.exec.approvalRunningNoticeMs` (default 10000) — emits `Exec running` notice for long-running approvals.

## Approval Forwarding to Chat Channels

Exec approval prompts can be forwarded to chat channels for remote approval.

### macOS IPC Flow

Uses macOS IPC to forward approval prompts between the gateway and companion app.

## System Events

Exec completions generate system events that can trigger heartbeat wakes.

## Implications

- Keep the allowlist minimal.
- Use `security=allowlist` + `ask=on-miss` for a balanced security posture.
- Use `security=deny` for maximum restriction.
- Review `~/.openclaw/exec-approvals.json` regularly.
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: 472kUpdated 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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated 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