What OpenClaw is
OpenClaw is an open-source AI assistant that lives on your own hardware and meets you in the chats you already use. The project is developed by the OpenClaw Foundation, an independent non-profit, and the code is open under the MIT license. Its earlier names were Clawdbot and Moltbot, so older guides use them.
The core of OpenClaw is the gateway: a program on the server that takes messages from messengers, passes them to the model and sends the answers back. The connected model does the thinking, and OpenClaw gives it tools, memory and channels. How such agents work is covered in How AI agents work.
- Messengers
Telegram, WhatsApp, Discord, Slack, Signal, iMessage, Microsoft Teams, Matrix, Google Chat and others via plugins.
- Skills and ClawHub
A skill is a ready procedure the agent loads for a task. Plugins and skills are installed from the ClawHub catalog.
- Schedule
Scheduled jobs, hooks and webhooks: the agent works even without your message.
- Several agents
Separate agents with their own sessions and workspaces, for example for different people or tasks.
- Any model
Log in through Claude Code or Codex on the same server, or use a provider API key.
What you need to install it
- A computer or server on macOS, Linux or Windows. For Windows there is the Windows Hub app, a PowerShell installer and a WSL2 option. For the agent to answer around the clock, it goes on a server that never switches off; why a laptop is a poor fit for this is covered in Local AI agent.
- Node.js 24.22.1 or later, or 26.12.1 or later. The docs recommend Node 26.
- Model access: a Claude Code or Codex login on the same computer, or a provider API key.
- A terminal. Installation, the gateway, channels and updates are all done with commands.
- A Telegram bot or an account in another messenger to talk to the agent.
- Time for upkeep: updates, access, backups.
How to install OpenClaw: five steps
- Installation. On macOS and Linux run
curl -fsSL https://openclaw.ai/install.sh | bash; on Windows runiwr -useb https://openclaw.ai/install.ps1 | iexin PowerShell. To try it without installing, usenpx openclaw@latest. - Setup wizard. The installer starts it for you. Quick start finds a Claude Code or Codex login or an API key, checks it with a real request, saves the config and opens the web dashboard. Custom setup walks through every option, and
openclaw onboard --classicopens the classic step-by-step wizard. - Running in the background. After the wizard the gateway runs in the terminal window.
openclaw gateway installturns it into a service: a systemd user unit on Linux, a LaunchAgent on macOS and a scheduled task on Windows.openclaw gateway statusshows its state; the gateway listens on port 18789. - First conversation.
openclaw dashboardopens the control panel in your browser, which has a chat. Check that the agent answers and remembers the previous message. - Checks.
openclaw doctorshows the problems it finds, andopenclaw security auditchecks whether your security settings have drifted from the safe defaults.
The full guide is in the OpenClaw documentation. The commands above were taken from it in October 2026. The project ships versions often, so check it before you install.
How to connect OpenClaw to Telegram
The docs call Telegram the fastest channel to set up: all it needs is a bot token.
- Open a chat with @BotFather, check that the handle is spelled exactly like that, send
/newbotand save the token. - Add the token to OpenClaw:
openclaw channels add --channel telegram --token <token>. - Start the gateway and check the channel:
openclaw channels status --probe. - Send the bot any message. By default it answers a stranger with a pairing code and passes your message to the agent only after approval. See the code with
openclaw pairing list telegramand approve it:openclaw pairing approve telegram <code>. The code is valid for one hour. - In a group the bot answers only when mentioned by default. For it to see every message, turn off privacy mode with /setprivacy at @BotFather or make the bot a group admin.
Keep the bot token secret: if it leaks, revoke it with /revoke at @BotFather and put the new one into OpenClaw.
OpenClaw and a Claude subscription
There are three ways to connect Claude to OpenClaw.
- An Anthropic API key billed per token. The OpenClaw docs recommend it for shared automation and predictable spend.
- A login through Claude Code installed on the same server. OpenClaw runs it as a program and does not store or refresh your login.
- A long-lived token from the
claude setup-tokencommand.
Anthropic's subscription rules changed several times in 2026. On April 4 the company stopped counting subscription limits for third-party harnesses, and OpenClaw was cut off first. On May 13 Anthropic announced it would bring them back through a separate monthly credit, but on June 15 it paused that plan. As of October 28, 2026, the Anthropic help article, updated on June 15 and October 7, says that third-party apps, claude -p and the Claude Agent SDK draw from your subscription limits when you sign in with your Claude plan.
The OpenClaw docs warn that Anthropic can change Claude Code billing and limits without a new OpenClaw release. Before you set it up, check what the help article says now.
Security: what to know
OpenClaw ships with conservative defaults. The gateway listens only on the machine itself, strangers in direct messages get a pairing code, and groups use an allow list and answer on mention. The exception is ready-made container images: there the gateway is exposed to the network by default, so a password or token is required.
- Do not expose gateway port 18789 to the internet. The docs advise reaching the dashboard through an SSH tunnel or Tailscale Serve.
- One gateway is for one owner or a team whose members trust each other. For people with different levels of trust, set up separate gateways and keys, ideally under different system users or on different servers.
- The agent reads other people's text: emails, pages, messages. They can contain instructions that try to steer the agent. Keep tool and file permissions narrow until you are sure everything works as intended.
- Vulnerabilities are found and fixed. For example, in versions from 2026.3.22 up to 2026.6.6 a WhatsApp group ID could satisfy the elevated sender allow list. The project published this in advisory GHSA-fh38-965w-f6c3 and fixed it in version 2026.6.6. The defence against such bugs is updating on time.

What you will maintain yourself
The OpenClaw docs say plainly that when you host it yourself, updates, network exposure, backups and access are on the owner. In practice that is five jobs.
- Updates.
openclaw updateinstalls a new version and verifies it. Releases are frequent: from October 15 to 27, 2026 alone, five versions of the main line came out, the latest being 2026.10.8. For those who value stability there is the extended-stable channel. - Compatibility. Updates can break things: release 2026.8.1 of August 31, 2026 removed a built-in plugin, and third-party plugins had to be rewritten. Installs older than July 2026 are updated in two steps, via version 2026.9.5. After an update, run
openclaw doctor --fix. - Backups. The docs advise keeping the agent's workspace in a private git repository and backing up the state regularly. A failed update rolls back the software, but database changes are not rolled back, so make a backup before a major update.
- Access. The bot token, model keys, allow lists. If a key leaks, you replace it yourself.
- Server and costs. Restarts after failures, disk space, closed ports. Scheduled checks run full agent turns, so frequent checks use more tokens.
This is manageable if you already administer a server. If not, set aside time: the first weeks go into getting the agent to run reliably.
Who OpenClaw suits
You are confident in the terminal and want an agent in all your messengers
OpenClaw on your own serverYou want to see how an open-source agent works in an evening
OpenClaw on your computer via npxYou need an everyday assistant and have no time to fix it
A turnkey agent
| OpenClaw DIY | NekoAgent turnkey | |
|---|---|---|
| Software | Free, MIT license | Installation from 24,900 RUB once, for three installs |
| Installation | A terminal command and a setup wizard | Buttons in a bot; the first one with a curator on a call, about two hours |
| Model | Claude Code, Codex or a provider API key | Claude Code or Codex on your Claude or ChatGPT subscription |
| Messengers | Telegram, WhatsApp, Discord, Slack and others | Telegram, text and voice |
| Server | Yours, you set it up | Your VPS, about 1,500 RUB a month |
| Updates and repairs | You | Repairs: the Iris service; updates: you, with one button |
| Backups | You set them up | Nightly encrypted backups |
OpenClaw is a strong open-source project with a large community, and the difference between the paths is the same as with other open-source agents: who installs, fixes and updates it. A similar project is covered in Hermes Agent, and types of agents are compared in Which AI agent is best. In NekoAgent we do the first install together on a call with a curator, and then during paid support Iris monitors the agent around the clock and helps bring it back after failures (reasonable efforts, no guaranteed response time), makes nightly encrypted backups and ships tested updates you install with one button.

An agent without the terminal
Plans from 24,900 RUB for three installs. The first one is on a call with a curator, with training.
Key questions
What is OpenClaw?
A free, open-source AI assistant. It runs on your computer or server, connects to the model you choose and answers in Telegram, WhatsApp, Discord, Slack and other messengers.
Is OpenClaw free?
The software is free, MIT license. You will pay for the model, a subscription or an API key, and for a server if the agent must run around the clock.
How do I install OpenClaw?
On macOS and Linux with curl -fsSL https://openclaw.ai/install.sh | bash, on Windows with the PowerShell command from the project page. The installer starts the setup wizard, and openclaw gateway install keeps the gateway running in the background.
Does OpenClaw work with a Claude subscription?
According to the Anthropic help center as of October 28, 2026, third-party apps draw from your subscription limits when you sign in with your Claude plan. The rules changed in the spring, so check the Anthropic help center before you set it up. The other option is an API key billed per token.
How do I connect OpenClaw to Telegram?
Create a bot at @BotFather, add the token with openclaw channels add --channel telegram --token <token>, message the bot and approve the pairing code with openclaw pairing approve telegram <code>.
OpenClaw is a project of the OpenClaw Foundation, and Claude is a trademark of Anthropic. NekoAgent is not affiliated with them.
















