Quick Start

The core loop of XClaw is simple: you give the Agent a task, it uses tools to complete it, and you decide whether to accept the result.

The first thing to do after opening the app is connect an AI model. XClaw doesn't provide models itself — it's an orchestrator that connects to model resources you already have. The most direct way is to enter an Anthropic or OpenAI API key. OAuth sign-in works too if you have a Claude Pro subscription.

Once a model is connected, create a new session and you're ready to go. Unlike traditional chat tools, XClaw's Agent doesn't just reply with text — it can read and write your file system, run shell commands, and invoke MCP tools. You describe the goal, the Agent plans a path and executes.

The permission mode controls how autonomous the Agent is. The default "Confirm" mode pauses before each critical action for your approval. Once you've built trust in the Agent's judgment, you can switch to "Auto" mode to let it work independently.

XClaw supports running multiple sessions in parallel. Each has its own context and state, functioning like an async task inbox — you dispatch tasks, the Agent works in the background, and you check back whenever you want.

How to

After opening XClaw, click the settings icon in the bottom-left corner and navigate to "AI Models." Hit "Add Connection," pick your model provider, and paste an API key (Anthropic or OpenAI both work), or choose OAuth for one-click sign-in. Once connected, you'll see the model appear in your list.

Back on the main screen, click the "+" button at the top of the left sidebar to create a new session. Type what you want to accomplish in the input box and press Enter. The Agent will get to work — you'll see it think, invoke tools, and produce results in real time.

Notice the permission mode indicator at the bottom. It defaults to "Confirm," meaning the Agent pauses before each critical action (writing files, running commands) for your approval. When you're comfortable, click it to switch to "Auto" mode.

Want to run multiple tasks at once? Just click "+" again to create another session. The left panel shows each session's status — done, in progress, waiting — all at a glance.