--- title: "HolaClaw Documentation" description: "Guides for installing, configuring, and getting the most out of HolaClaw." canonical: https://holaclaw.ai/docs --- # HolaClaw Documentation ## Installation Download and install HolaClaw on your Mac. - [Installation overview](/docs/installation.md) ## Configuration Connect Telegram, WhatsApp, and the other apps you already use. - [Configuration overview](/docs/configuration.md) - [Backups & export](/docs/configuration/backups.md) Your assistant's memory, config, and credentials live inside its private virtual machine. HolaClaw can snapshot all of it to a backup on your Mac, take backups automatically, and restore one if something goes wrong. - [Connect Telegram](/docs/configuration/connect-telegram.md) Give your HolaClaw assistant its own Telegram bot so you can chat with it from anywhere. Create the bot, decide who's allowed in, and approve your first pairing. - [Mac menu bar](/docs/configuration/mac-menu-bar.md) A small HolaClaw icon lives in your Mac's menu bar whenever the app runs. It's your at-a-glance status light and quick-control center for your assistants. ## AI providers Choose the AI model that powers your assistant — cloud or local. - [AI providers overview](/docs/ai-providers.md) - [Anthropic Claude](/docs/ai-providers/anthropic-claude.md) Set up Claude as the brain behind your HolaClaw assistant with an Anthropic API key. Get the key, connect it, pick a model, and know what it costs. - [Choosing an AI provider](/docs/ai-providers/choosing-a-provider.md) HolaClaw isn't tied to a single AI model. You can power your assistant with Claude, GPT, Gemini, Grok, DeepSeek, OpenRouter, or a model running locally on your Mac. This guide helps you pick. - [DeepSeek](/docs/ai-providers/deepseek.md) Set up DeepSeek as the brain behind your HolaClaw assistant. Get an API key, connect it, pick a model, and understand why it's so easy on your wallet. - [Google Gemini](/docs/ai-providers/google-gemini.md) Set up Google's Gemini as the brain behind your HolaClaw assistant. Get a free API key from Google AI Studio, connect it, pick a model, and keep costs low. - [Grok (xAI)](/docs/ai-providers/grok.md) Set up Grok as the brain behind your HolaClaw assistant with an xAI API key. Get the key, connect it, and pick a model. - [Local models](/docs/ai-providers/local-models.md) Run your HolaClaw assistant entirely on your Mac — no account, no API key, no cloud. Total privacy, works offline, free to run. - [OpenAI](/docs/ai-providers/openai.md) Power your HolaClaw assistant with OpenAI's GPT models — and choose between signing in with your ChatGPT plan or using an API key. - [OpenRouter](/docs/ai-providers/openrouter.md) Connect OpenRouter to HolaClaw with one API key and reach models from Anthropic, OpenAI, Google, xAI, and many more — all on a single prepaid balance. ## Personalization Give your assistant a name, a personality, and the memory it needs. - [Personalization overview](/docs/personalization.md) ## Connectors Let your assistant work with the services you already use — GitHub, Notion, Linear, and more. - [Connectors overview](/docs/connectors.md) - [Connect a service](/docs/connectors/connect-a-service.md) Authorize a connector so your assistant can reach a service like GitHub — one sign-in flow covers the whole catalog. Connect it, try it, and know what to do when it needs attention. - [Connect Buffer to OpenClaw](/docs/connectors/connect-buffer.md) Authorize the Buffer connector so your assistant can draft and schedule social posts across your Buffer channels. - [Connect GitHub to OpenClaw](/docs/connectors/connect-github.md) Connect GitHub so your assistant can answer questions about your issues, pull requests, and repositories using your own access. - [Connect Linear to OpenClaw](/docs/connectors/connect-linear.md) Connect Linear so your assistant can answer questions about your issues, projects, and cycles using your own workspace access. - [Connect Notion to OpenClaw](/docs/connectors/connect-notion.md) Authorize the Notion connector so your assistant can search, read, and update the pages and databases in your workspace. - [Connect PostHog to OpenClaw](/docs/connectors/connect-posthog.md) Authorize the PostHog connector so your assistant can query your product analytics, insights, and feature flags in plain language. - [Connect Sentry to OpenClaw](/docs/connectors/connect-sentry.md) Authorize the Sentry connector so your assistant can inspect the issues, traces, and releases in your projects. - [Connect Stripe to OpenClaw](/docs/connectors/connect-stripe.md) Authorize the Stripe connector so your assistant can query customers, payments, and invoices straight from your Stripe account. - [Connect Supabase to OpenClaw](/docs/connectors/connect-supabase.md) Authorize the Supabase connector so your assistant can manage projects, tables, and data across your Supabase organization. - [What are connectors?](/docs/connectors/what-are-connectors.md) Connectors are the services your assistant can reach into — GitHub, Notion, Stripe, and more — so it can answer questions and act on your real work, not just chat. ## Advanced Access and modify the OpenClaw installation running in the HolaClaw Virtual Machine (VM) - [Advanced overview](/docs/advanced.md) - [Access the HolaClaw virtual machine](/docs/advanced/access-the-virtual-machine.md) Need access to the OpenClaw installation inside the HolaClaw virtual machine? You can connect to it over SSH using a command shown in the app. - [Restart the OpenClaw Gateway](/docs/advanced/restart-the-openclaw-gateway.md) Restart the OpenClaw Gateway when your assistant stops responding. Either from the assistant's status page in the HolaClaw app, or over SSH with `openclaw gateway restart`. ## More FAQ, privacy, uninstall, and troubleshooting. - [More overview](/docs/more.md) - [HolaClaw VM won't boot](/docs/more/vm-wont-boot.md) If the HolaClaw VM fails to start with a "launchctl bootstrap failed" or "timed out waiting for VF daemon" error, restart your Mac to recover. ## Tutorials Step-by-step examples to learn how everything fits together. - [Tutorials overview](/docs/tutorials.md)