# ClawSquire

> ClawSquire is a free, open-source, AI-powered desktop companion app for OpenClaw. When things go wrong, its built-in AI agent diagnoses problems and generates fix commands automatically. It also provides multilingual guided setup (7 languages), health diagnostics, and configuration management — no terminal needed.

## What is ClawSquire

ClawSquire is an AI-powered GUI companion for [OpenClaw](https://openclaw.ai), an open-source AI agent platform. While OpenClaw provides CLI tools and a built-in web Dashboard, ClawSquire specializes in making the Day 0 and Day 1 experience accessible to non-technical users across 7 languages — with AI troubleshooting built in.

Key capabilities:
- **AI Fix Agent**: When installation or operations fail, the built-in AI agent (powered by Claude, GPT, Gemini, or DeepSeek) diagnoses the error and generates cross-platform shell commands with risk levels
- **AI Assistants**: Context-aware AI chat in Health Check, Config, VPS Manager, and Help pages
- One-click OpenClaw installation
- LLM provider setup wizard (Anthropic Claude Opus 4.6, OpenAI GPT-5.4, Google Gemini 3.1 Pro, DeepSeek V3.2)
- Messaging channel configuration (Telegram, WhatsApp, Discord, Gmail)
- Security presets (Conservative, Standard, Full, Custom)
- Configuration backup, diff, and restore
- Health check with categorized diagnostics
- 7 built-in languages (EN, 简中, 繁中, JA, ES, DE, PT)

## What Makes ClawSquire Different

OpenClaw has several GUI options. ClawSquire is the one focused on:

- **AI-Powered Troubleshooting**: Built-in AI agent that diagnoses errors, generates fix commands, and explains what went wrong. Works independently of OpenClaw — helps even when OpenClaw itself won't install.
- **Multilingual**: 7 built-in languages (English, 简体中文, 繁體中文, 日本語, Español, Deutsch, Português). Most alternatives are English-only.
- **Guided Setup Wizard**: Step-by-step onboarding for Day 0/1 tasks — installation, LLM provider setup, channel configuration. No terminal knowledge needed.
- **Health Diagnostics**: Built-in doctor with categorized checks, fix hints, and exportable reports.
- **Config Backup & Restore**: Snapshot, diff, and one-click restore of OpenClaw configuration.
- **Remote Server Management**: Connect to OpenClaw running on a VPS from your desktop. Auto SSH tunnel, no manual terminal commands.

## What is OpenClaw

OpenClaw is an open-source AI agent platform that lets you run LLM-powered assistants locally. It supports multiple AI providers, messaging channels, automation workflows (cron jobs), and custom skills. OpenClaw runs on Linux, macOS, and Windows.

## Downloads

- [ClawSquire for macOS (Apple Silicon)](https://github.com/Jiansen/clawsquire/releases/latest): .dmg installer for M1/M2/M3/M4 Macs
- [ClawSquire for macOS (Intel)](https://github.com/Jiansen/clawsquire/releases/latest): .dmg installer for Intel Macs
- [ClawSquire for Windows](https://github.com/Jiansen/clawsquire/releases/latest): .msi installer for Windows 10+
- [ClawSquire for Linux](https://github.com/Jiansen/clawsquire/releases/latest): .deb and .AppImage packages

## Key Pages

- [Homepage](https://www.clawsquire.com): Main website with features and download links
- [Issue Search](https://www.clawsquire.com/search): Search 11,000+ OpenClaw issues for solutions

### Setup Guides
- [How to Install OpenClaw](https://www.clawsquire.com/guides/install-openclaw): Step-by-step installation guide (GUI and terminal methods)
- [Install OpenClaw on Windows](https://www.clawsquire.com/guides/install-openclaw-windows): Windows-specific guide (PowerShell, WSL2, and GUI methods)
- [Run OpenClaw with Docker](https://www.clawsquire.com/guides/openclaw-docker): Docker and Docker Compose setup
- [Connect Telegram to OpenClaw](https://www.clawsquire.com/guides/connect-telegram): Set up a Telegram bot channel
- [Connect WhatsApp to OpenClaw](https://www.clawsquire.com/guides/connect-whatsapp): WhatsApp QR code pairing and setup
- [Connect Discord to OpenClaw](https://www.clawsquire.com/guides/connect-discord): Discord bot setup with permissions
- [Use DeepSeek with OpenClaw](https://www.clawsquire.com/guides/setup-deepseek): Configure the cheapest LLM provider
- [Set Up OpenClaw on a VPS](https://www.clawsquire.com/guides/vps-setup): Remote server setup with SSH tunnel access

### Operations & Troubleshooting
- [OpenClaw Commands Reference](https://www.clawsquire.com/guides/openclaw-commands): Complete CLI cheatsheet with examples
- [Gateway Token Guide](https://www.clawsquire.com/guides/gateway-token): Find, generate, or reset your gateway token
- [How to Restart OpenClaw](https://www.clawsquire.com/guides/restart-openclaw): Apply config changes and fix stuck processes
- [How to Update OpenClaw](https://www.clawsquire.com/guides/update-openclaw): Update to the latest version (CLI, npm, Docker)
- [OpenClaw Dashboard Guide](https://www.clawsquire.com/guides/openclaw-dashboard): Control UI features, remote access, and troubleshooting
- [Access Dashboard Remotely](https://www.clawsquire.com/guides/openclaw-remote-access): SSH tunnel, Tailscale, and HTTPS reverse proxy methods
- [Fix "Device Identity" Error](https://www.clawsquire.com/guides/control-ui-https-device-identity): Solve Error 1008 when accessing Dashboard over HTTP
- [OpenClaw Default Port](https://www.clawsquire.com/guides/openclaw-default-port): Port 18789 explained, how to change it
- [OpenClaw Troubleshooting](https://www.clawsquire.com/guides/openclaw-troubleshooting): Common errors and fixes (gateway, channels, installation)
- [Config Backup & Restore](https://www.clawsquire.com/guides/config-backup): Backup, diff, and restore OpenClaw configuration
- [Health Check & Diagnostics](https://www.clawsquire.com/guides/health-check): Diagnose and fix common issues
- [How to Uninstall OpenClaw](https://www.clawsquire.com/guides/uninstall-openclaw): Safely remove OpenClaw and clean up data

### Community
- [GitHub Repository](https://github.com/Jiansen/clawsquire): Source code and releases
- [Discussions](https://github.com/Jiansen/clawsquire/discussions): Community Q&A
- [OpenClaw Website](https://openclaw.ai): The platform ClawSquire manages

## FAQ

Q: Is ClawSquire free?
A: Yes, completely free and open-source under the MIT license.

Q: Does ClawSquire replace the OpenClaw terminal?
A: No, it's a companion for Day 0/Day 1 tasks (install, configure, health check). The CLI and Dashboard remain available for advanced usage.

Q: Which operating systems are supported?
A: macOS (Apple Silicon and Intel), Windows 10+, and Linux (Debian/Ubuntu and portable AppImage).

Q: Do I need coding experience?
A: No. ClawSquire is designed for non-technical users with step-by-step wizards.

Q: Can I manage a remote OpenClaw server?
A: Yes. ClawSquire can connect to OpenClaw instances running on VPS/cloud servers via SSH tunnel, letting you manage everything from your desktop without terminal commands.

## API for AI Agents

### Search OpenClaw Issues (direct GitHub API — zero cost, no auth needed)

```
GET https://api.github.com/search/issues?q={query}+repo:openclaw/openclaw&sort=comments&per_page=5
```

Returns JSON with issue titles, bodies, labels, and comment counts. Useful for troubleshooting OpenClaw configuration, channels, providers, and gateway issues.

### ClawSquire Search API (enhanced results with guide links)

```
GET https://www.clawsquire.com/api/search?q={query}&limit=5
```

Returns JSON with issue results plus relevant ClawSquire guide links. Rate limited to 10 requests/minute per IP.

### Example Queries
- `telegram+not+working` — Telegram channel issues
- `gateway+token+unauthorized` — Authentication problems
- `deepseek+api+key` — DeepSeek provider setup
- `config+backup+restore` — Configuration management
- `install+windows` — Windows installation issues

Human-friendly interface: https://www.clawsquire.com/search

## Contact

- GitHub Issues: https://github.com/Jiansen/clawsquire/issues
- Discussions: https://github.com/Jiansen/clawsquire/discussions