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

View on GitHub
# TUI (Terminal UI) Reference

> Source: https://docs.openclaw.ai/web/tui

## Quick Start

```bash
openclaw gateway                                      # 1. Start Gateway
openclaw tui                                          # 2. Open TUI
# Type a message and press Enter                      # 3. Chat

# Remote Gateway
openclaw tui --url ws://<host>:<port> --token <token>
# or --password <password>
```

## What You See

| Area | Content |
|---|---|
| **Header** | Connection URL, current agent, current session |
| **Chat log** | User messages, assistant replies, system notices, tool cards |
| **Status line** | Connection/run state (connecting, running, streaming, idle, error) |
| **Footer** | Connection state + agent + session + model + think/verbose/reasoning + token counts + deliver |
| **Input** | Text editor with autocomplete |

## Mental Model: Agents + Sessions

- **Agents**: unique slugs (e.g., `main`, `research`). Gateway exposes the list.
- **Sessions**: belong to the current agent. Keys: `agent:<agentId>:<sessionKey>`.
- `/session main` → expands to `agent:<currentAgent>:main`
- `/session agent:other:main` → switch to that agent session explicitly
- **Session scope**:
  - `per-sender` (default): each agent has many sessions
  - `global`: TUI always uses global session

## Sending + Delivery

- Messages sent to the Gateway; delivery to providers is **off by default**.
- Turn on: `/deliver on` | Settings panel | `openclaw tui --deliver`

## Keyboard Shortcuts

| Key | Action |
|---|---|
| `Enter` | Send message |
| `Esc` | Abort active run |
| `Ctrl+C` | Clear input (twice to exit) |
| `Ctrl+D` | Exit |
| `Ctrl+L` | Model picker |
| `Ctrl+G` | Agent picker |
| `Ctrl+P` | Session picker |
| `Ctrl+O` | Toggle tool output expansion |
| `Ctrl+T` | Toggle thinking visibility (reloads history) |

## Slash Commands

| Command | Description |
|---|---|
| `/help` | Help |
| `/status` | Status |
| `/agent <id>` / `/agents` | Switch/list agents |
| `/session <key>` / `/sessions` | Switch/list sessions |
| `/model <provider/model>` / `/models` | Switch/list models |
| `/think <off\|minimal\|low\|medium\|high>` | Set thinking level |
| `/verbose <on\|full\|off>` | Set verbose mode |
| `/reasoning <on\|off\|stream>` | Set reasoning visibility |
| `/usage <off\|tokens\|full>` | Set usage display |
| `/elevated <on\|off\|ask\|full>` | Set elevated mode |
| `/activation <mention\|always>` | Set activation mode |
| `/deliver <on\|off>` | Toggle delivery |
| `/new` / `/reset` | Reset session |
| `/abort` | Abort active run |
| `/settings` | Settings overlay |
| `/exit` | Exit TUI |

## Local Shell Commands

- Prefix a line with `!` to run a local shell command on the TUI host.
- TUI prompts once per session to allow local execution.
- Commands run in a fresh, non-interactive shell in the TUI working directory.
- Receive `OPENCLAW_SHELL=tui-local` in environment.
- A lone `!` is sent as a normal message.

## Tool Output

- Tool calls show as cards with args + results.
- `Ctrl+O` toggles collapsed/expanded views.
- While tools run, partial updates stream into the same card.

## Terminal Colors

- TUI keeps assistant text in terminal's default foreground (dark + light compatible).
- `OPENCLAW_THEME=light` when auto-detection is wrong on light terminals.
- `OPENCLAW_THEME=dark` to force dark palette.

## Options

| Flag | Description |
|---|---|
| `--url <url>` | Gateway WebSocket URL |
| `--token <token>` | Gateway token |
| `--password <password>` | Gateway password |
| `--session <key>` | Session key (default: `main` or `global`) |
| `--deliver` | Deliver replies to provider (default: off) |
| `--thinking <level>` | Override thinking level |
| `--timeout-ms <ms>` | Agent timeout in ms |

## Connection Details

- TUI registers with Gateway as `mode: "tui"`.
- Reconnects show system message; event gaps surfaced in log.

## See Also

- [web_ui.md](web_ui.md) — WebChat, Control UI, Dashboard
- [slash_commands.md](slash_commands.md) — Full slash command reference
- [thinking.md](thinking.md) — Thinking levels and verbose
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