How it works

Clawdbot — Personal AI Assistant: How to Install

Clawdbot is a personal AI assistant built around a local gateway control plane and a CLI-first workflow. This guide summarizes a clean, practical setup path so you can get from install to first run quickly.

This page focuses on the practical steps: install, configure, and run a local assistant without unnecessary setup complexity.

Prerequisites

A smooth install starts with the right environment. Use a modern Node.js runtime and a supported operating system before running the onboarding wizard.

Runtime: Node.js 22 or newer.
Supported: macOS, Linux, and Windows (via WSL2).
Package managers: npm, pnpm, or bun.

Recommended install (wizard)

The onboarding wizard is the fastest path. It configures the gateway, workspace, channels, and skills in one guided flow. It also installs the background gateway daemon so the assistant can stay available.

npm install -g moltbot@latest
# or: pnpm add -g moltbot@latest

moltbot onboard --install-daemon

If you are new to the project, use the official getting-started guide for auth, pairing, and channels. A consistent setup flow helps users find the right path quickly.

Quick start

Once the gateway is installed, you can run a local instance, send a test message, and then issue a first task. The commands below are intentionally minimal for clarity.

moltbot onboard --install-daemon

moltbot gateway --port 18789 --verbose

# Send a message
moltbot message send --to +1234567890 --message "Hello from Moltbot"

# Talk to the assistant
moltbot agent --message "Ship checklist" --thinking high

Common setup tips

Keep configuration steps in a single place and document the exact commands you use. That helps teammates repeat the setup and avoids confusion later.

Use the wizard for first-time installs.
Keep the gateway port consistent across environments.
Store your setup steps in your team docs for quick reuse.

Clarity that helps new installs

Installation pages work best when they use clear, repeatable phrases. Use the same wording in headings and instructions so users can scan, copy, and move forward without second-guessing.

Keep the brand name near the action word (install, setup, configure) and repeat it in at least one heading. That improves clarity for users skimming the page.

If you publish blog posts or release notes, link them back to this install guide using consistent anchor text. That strengthens the page's authority for setup-related queries.

Quick troubleshooting checklist

If the install fails, check your Node version, verify the package manager, and confirm the gateway port is available. Simple troubleshooting steps like these reduce support friction and help the page serve as a reliable setup reference.

Link to your primary documentation and support channels right below the checklist. This improves user success and makes the setup resource easier to trust.

Keeping Clawdbot updated

Once the assistant is running, keep the global package updated so new fixes and features are available. A regular update cadence prevents drift between the gateway and the CLI tooling.

Update with your package manager on a scheduled cadence.
Review release notes before upgrading production setups.
Keep onboarding notes in your internal documentation.

Summary

Installing Clawdbot is straightforward when you follow the wizard and keep commands consistent. This page is designed to rank for practical installation queries while helping new users get a local AI assistant running fast.