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

View on GitHub
# OpenClaw Elevated Mode Reference

## Overview

Elevated mode (`/elevated` directives) allows sandboxed agents to temporarily execute commands on the gateway host, with configurable approval controls.

## Directive Forms

| Directive | Behavior |
|---|---|
| `/elevated on` | Run on gateway host, keep exec approvals |
| `/elevated ask` | Same as `on` (alias) |
| `/elevated full` | Run on gateway host, auto-approve exec (skip approvals) |
| `/elevated off` | Disable elevated mode |

Short form: `/elev on|off|ask|full`

## What It Controls

- **Host execution**: Forces exec onto the gateway host (only matters when agent is sandboxed)
- **Approvals**: `full` skips exec approvals; `on`/`ask` honor allowlist/ask rules
- **No-op for unsandboxed agents**: Only affects gating, logging, and status
- **Tool policy still applies**: If exec is denied by tool policy, elevated cannot be used
- **Separate from `/exec`**: `/exec` adjusts per-session defaults for authorized senders

## Resolution Order

1. Inline directive on the message (applies only to that message)
2. Session override (set by sending a directive-only message)
3. Global default (`agents.defaults.elevatedDefault` in config)

## Setting a Session Default

- Send a message that is only the directive, e.g. `/elevated full`
- Confirmation reply: "Elevated mode set to full..." / "Elevated mode disabled."
- If unavailable, returns actionable error without changing state
- Send `/elevated` with no argument to see current level

## Group Chat Behavior

- Elevated directives only honored when the agent is **mentioned**
- Command-only messages that bypass mention requirements are treated as mentioned

## Availability + Allowlists

### Feature Gate

```json5
{
  tools: {
    elevated: {
      enabled: true,          // Global baseline
      allowFrom: {
        whatsapp: ["+15555550123"],
        discord: ["user-id-123"],
      },
    },
  },
}
```

### Per-Agent Gate

```json5
{
  agents: {
    list: [{
      id: "restricted",
      tools: {
        elevated: {
          enabled: false,      // Can only further restrict (both must allow)
          allowFrom: { ... },  // Sender must match BOTH global + per-agent
        },
      },
    }],
  },
}
```

### Allowlist Matching

- Unprefixed entries match sender-scoped identity only (SenderId, SenderE164, From)
- Mutable sender metadata requires explicit prefixes:
  - `name:<value>` → SenderName
  - `username:<value>` → SenderUsername
  - `tag:<value>` → SenderTag
  - `id:<value>`, `from:<value>`, `e164:<value>` → explicit identity

### Discord Fallback

If `tools.elevated.allowFrom.discord` is omitted, `channels.discord.allowFrom` is used as fallback. Set `tools.elevated.allowFrom.discord` (even `[]`) to override.

## Logging + Status

- Elevated exec calls logged at info level
- Session status includes elevated mode (e.g. `elevated=ask`, `elevated=full`)
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