Docs / BrainClaw / Control UI

Reference

Control UI

Everything under Settings → Instance Controls — what each action does, when to use it, and what survives.

The golden rule

Most configuration changes — channels, secrets, model, and feature toggles — only take effect after a Redeploy. If a change isn't showing up, redeploy first.

Redeploy

Rebuilds the agent runtime with your current settings and brings the instance back to Running. Use it after changing channels, secrets, the model, or any feature toggle. Your workspace, files, and memory are preserved.

Stop

Shuts the instance down. The agent stops responding on every channel until you start it again. Data on the persistent volume is kept. Stop an instance you're not using to keep it idle.

Start

Boots a stopped instance back up. Once it returns to Running, the agent is reachable again on all connected channels.

Restart / reboot

Cycles the running instance without changing configuration. This is the quickest fix when the agent becomes unresponsive but your settings are already correct.

Reset a session

To clear the current conversation context and start fresh, send /new in the chat. This starts a new session while keeping long-term memory intact.

Destroy / re-provision

Destroying an instance tears down the VM and its volume — this is irreversible, so export anything you need first. Re-provisioning gives you a clean instance with the latest defaults and pre-installed software.