FAQ#
OpenClaw runs AI assistants that connect to your messaging apps and devices. The questions below cover what most people want to know before and after getting started.
What is OpenClaw?#
OpenClaw is a system for running AI assistants. These assistants can carry on conversations through messaging apps and use features from phones or computers you connect to it. You manage everything through a command-line tool and a central service called the gateway.
How do I get started?#
Run openclaw onboard. The command guides you through the main steps: setting up the gateway, choosing a workspace, connecting messaging channels, and adding any skills the assistant should have. You can also tell it to install a background service so the system starts automatically.
Which messaging apps does it work with?#
OpenClaw supports channels for WhatsApp, Telegram, Discord, Slack, and similar services. Each channel is provided by a plugin. You choose which ones to enable during setup or later through the plugins command.
What are companion nodes?#
Companion nodes are small apps you install on iOS, Android, or macOS devices. Once paired, they let the assistant use local features such as voice, camera, screen capture, location, and host commands. The nodes connect over the same secure link used by other clients.
How do I start or stop the main service?#
Use the gateway command. For example, openclaw gateway status shows whether it is running, and openclaw gateway stop shuts it down. You can also start it in the foreground for testing or let the background service handle it after onboarding.
How do I change settings?#
Use the config command. You can view current values, set new ones, or remove entries. Common settings include how often the assistant should check in and where it stores files. The command validates changes before applying them.
How do I add or remove plugins?#
Use the plugins command. You can install plugins from the catalog or npm, inspect what a plugin provides, and see which ones are active. Plugins add support for new channels, tools, or other capabilities.
How do I connect a phone or computer?#
Use the nodes commands (or the older devices commands) to start pairing. The device requests a connection, you approve it, and the system issues a token for future reconnects. You can list, rename, or remove paired nodes at any time.
How do I check for problems?#
Run openclaw doctor. It scans for common issues such as risky messaging policies, missing credentials, port conflicts, and plugin load errors. Adding the --fix flag lets it repair many problems automatically.
How do I send a test message?#
Use the message command with a target and text. This is handy for verifying that a channel is working before relying on the assistant to send messages on its own.
What are sessions?#
Sessions are the individual conversations the assistant keeps track of. They can be tied to specific messaging threads or started directly. You can list and manage them through the CLI when you need to review or clean up activity.
Where do I go for more help?#
Start with the getting-started guide for a full walkthrough. If something is not working as expected, see the troubleshooting page. The doctor command is also useful for quick checks.