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

View on GitHub
# OpenClaw Installation Reference

## Table of Contents

- [System Requirements](#system-requirements)
- [Install Methods](#install-methods)
- [After Install](#after-install)
- [Troubleshooting](#troubleshooting)
- [Updating](#updating)
- [Rollback / Pinning](#rollback--pinning)
- [Migrating](#migrating)
- [Uninstall](#uninstall)

## System Requirements

- **Node 22+** (the installer script installs it if missing)
- **macOS, Linux, or Windows** (WSL2 recommended for Windows)
- `pnpm` only needed for building from source

## Install Methods

### Installer Script (Recommended)

```bash
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
```

Skip the onboarding wizard with `--no-onboard`:

```bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
```

### npm / pnpm

```bash
# npm
npm install -g openclaw@latest
openclaw onboard --install-daemon

# pnpm
pnpm add -g openclaw@latest
pnpm approve-builds -g    # approve openclaw, node-llama-cpp, sharp, etc.
openclaw onboard --install-daemon
```

**sharp build errors?**

```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
```

If you see `sharp: Please add node-gyp`:

```bash
npm install -g node-gyp
```

### From Source

```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm link --global       # Link the CLI
openclaw onboard --install-daemon
```

### Other Install Methods

| Method | Description |
|---|---|
| **Docker** | Containerized or headless deployments |
| **Podman** | Rootless container via `setup-podman.sh` |
| **Nix** | Declarative install via Nix |
| **Ansible** | Automated fleet provisioning |
| **Bun** | CLI-only usage via Bun runtime |

See: https://docs.openclaw.ai/install/docker, /podman, /nix, /ansible, /bun

## After Install

```bash
openclaw doctor     # Check config issues + apply migrations
openclaw status     # Gateway status
openclaw dashboard  # Open browser UI
```

Key environment variables:
- `OPENCLAW_HOME` — home directory for internal paths
- `OPENCLAW_STATE_DIR` — mutable state location
- `OPENCLAW_CONFIG_PATH` — config file location

## Troubleshooting

### `openclaw` not found

#### PATH Diagnosis

```bash
node -v
npm -v
npm prefix -g
echo "$PATH"
```

If `$(npm prefix -g)/bin` is not in `$PATH`:

```bash
# Add to ~/.zshrc or ~/.bashrc
export PATH="$(npm prefix -g)/bin:$PATH"
```

Then: `rehash` (zsh) or `hash -r` (bash).

## Updating

### Re-run Installer (Recommended)

```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```

### Before You Update

1. Note current version: `openclaw --version`
2. Check release notes for breaking changes
3. Backup config: `cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak`

### Update Global Install

```bash
npm install -g openclaw@latest
# Or:
openclaw update          # Self-update command
```

### Auto-Updater (Optional)

```json5
{
  gateway: {
    autoUpdate: {
      enabled: true,
      // check interval, etc.
    },
  },
}
```

### Update Control UI / RPC

Control UI updates come with package updates. No separate step needed.

### Update From Source

```bash
cd openclaw
git pull
pnpm install
pnpm ui:build
pnpm build
```

### Always Run After Update

```bash
openclaw doctor          # Config migrations + health check
openclaw gateway restart # Apply changes
```

## Rollback / Pinning

### Pin Global Install

```bash
npm install -g openclaw@<version>
```

### Pin Source by Date

```bash
git checkout <commit-hash>
pnpm install && pnpm ui:build && pnpm build
```

### If You're Stuck

1. Pin to last known good version
2. Run `openclaw doctor --fix`
3. Check GitHub Issues / Releases

## Migrating

To move OpenClaw to a new machine:

1. Install OpenClaw on the new machine
2. Copy `~/.openclaw/` directory (config, state, sessions)
3. Run `openclaw doctor` on the new machine
4. Re-pair mobile devices and re-login channels

## Uninstall

```bash
openclaw uninstall       # Guided removal
```

Or manually:
1. `openclaw gateway stop` — stop the daemon
2. `npm uninstall -g openclaw`
3. Remove `~/.openclaw/` directory
4. Remove launchd/systemd service files
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