Skip to content

Commit 01ae633

Browse files
docs(get-started): add Brev web UI quickstart guide (#2563)
docs(get-started): add Brev web UI quickstart guide ## Summary Adds a new getting started guide for running NemoClaw using the Brev web UI. The existing deploy-to-remote-gpu guide covers the deprecated CLI-based nemoclaw deploy flow. This guide covers the new one-click web experience on brev.nvidia.com that requires zero local installation. Tested end-to-end on April 27, 2026. ## Related Issue None ## Changes - Added docs/get-started/brev-web-ui-quickstart.md - Covers full web UI flow from brev.nvidia.com including agent setup - Includes troubleshooting section based on real first-run experience - Documents OpenClaw dashboard sections for first-time users ## Type of Change - [ ] Code change (feature, bug fix, or refactor) - [ ] Code change with doc updates - [x] Doc only (prose changes, no code sample modifications) - [ ] Doc only (includes code sample changes) ## Verification - [ ] `npx prek run --all-files` passes - [ ] `npm test` passes - [ ] Tests added or updated for new or changed behavior - [x] No secrets, API keys, or credentials committed - [x] Docs updated for user-facing behavior changes - [x] `make docs` builds without warnings (doc changes only) - [x] Doc pages follow the style guide (doc changes only) - [x] New doc pages include SPDX header and frontmatter (new pages only) ## AI Disclosure - [x] AI-assisted - tool: Claude (claude.ai) --- Signed-off-by: Kunchala Hema Sai Venkat Chandra Kumar <kumarchanduk@gmail.com> <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Documentation** * Published a Brev Web UI quickstart for NemoClaw: guides obtaining an NVIDIA API key, deploying a sandboxed agent via the Brev GPUs banner, completing the three-stage web UI setup and automated provisioning, confirming launch and opening the OpenClaw dashboard, walkthrough of dashboard sections, example first-chat prompts and USER.md template, cost-control tips, troubleshooting guidance, and suggested next steps. <!-- end of auto-generated comment: release notes by coderabbit.ai --> --------- Signed-off-by: Kunchala Hema Sai Venkat Chandra Kumar <kumarchanduk@gmail.com> Co-authored-by: Miyoung Choi <miyoungc@nvidia.com>
1 parent 6f99488 commit 01ae633

2 files changed

Lines changed: 164 additions & 0 deletions

File tree

Lines changed: 163 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,163 @@
1+
---
2+
title:
3+
page: "Get Started with NemoClaw on Brev (Web UI)"
4+
nav: "Brev Web UI"
5+
description:
6+
main: "Run a sandboxed NemoClaw agent in minutes using the Brev web interface with no CLI installation or local setup required."
7+
agent: "Guides users through deploying NemoClaw using the Brev web UI. Use when a user wants to try NemoClaw without installing the CLI, or asks how to get started on Brev."
8+
keywords: ["nemoclaw brev web ui", "nemoclaw getting started", "brev quickstart", "nvidia nemotron agent"]
9+
topics: ["generative_ai", "ai_agents"]
10+
tags: ["brev", "openclaw", "getting-started", "web-ui", "nemoclaw"]
11+
content:
12+
type: get_started
13+
difficulty: technical_beginner
14+
audience: ["developer", "engineer"]
15+
status: published
16+
---
17+
18+
<!--
19+
SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
20+
SPDX-License-Identifier: Apache-2.0
21+
-->
22+
23+
# Get Started with NemoClaw on Brev (Web UI)
24+
25+
Run a sandboxed NemoClaw agent in minutes using the Brev web interface.
26+
No CLI installation, no local setup, and no GPU required on your machine.
27+
28+
:::{note}
29+
This guide covers the Brev web UI flow, which is the fastest way to try NemoClaw.
30+
If you prefer the CLI-based remote deployment, see [Deploy to a Remote GPU Instance](../deployment/deploy-to-remote-gpu.md).
31+
:::
32+
33+
## Prerequisites
34+
35+
- An NVIDIA Brev account at [brev.nvidia.com](https://brev.nvidia.com)
36+
- An NVIDIA API key from [build.nvidia.com](https://build.nvidia.com)
37+
38+
No local software installation is needed.
39+
40+
## Get Your NVIDIA API Key
41+
42+
1. Go to [build.nvidia.com](https://build.nvidia.com).
43+
2. Sign in or create a free account.
44+
3. Click your profile icon in the top right.
45+
4. Select **API Keys**.
46+
5. Click **Generate API Key**.
47+
6. Copy the key -- it starts with `nvapi-`.
48+
49+
Keep this key ready for the next step.
50+
51+
## Deploy NemoClaw on Brev
52+
53+
1. Go to [brev.nvidia.com](https://brev.nvidia.com) and sign in.
54+
2. On the **GPUs** page, look for the banner: **"Your agents are waiting. Meet NemoClaw"**.
55+
3. Click **Try NemoClaw**.
56+
4. The NemoClaw setup page shows the following:
57+
- Instance type: CPU (4 CPUs, 16 GiB RAM)
58+
- Cloud Provider: GCP
59+
- Cost: $0.18/hr
60+
5. Click **Deploy NemoClaw**.
61+
62+
## Configure Your Agent
63+
64+
NemoClaw walks you through three configuration steps.
65+
66+
### Connect to AI
67+
68+
- **NVIDIA Cloud** is selected by default (recommended).
69+
- This uses Nemotron-3-Super-120B hosted by NVIDIA.
70+
- Paste your `nvapi-` API key in the field.
71+
- Click **Create Agent**.
72+
73+
:::{note}
74+
Other providers are available: OpenAI, Anthropic, Google Gemini, and Local Ollama.
75+
Click **Show Other Providers** to see all options.
76+
:::
77+
78+
### Setup
79+
80+
NemoClaw automatically performs the following:
81+
82+
- Provisions a secure Linux VM on GCP.
83+
- Installs Docker and the OpenShell runtime.
84+
- Sets up the sandboxed agent environment.
85+
- Configures inference routing to NVIDIA Cloud.
86+
87+
This takes approximately 2-3 minutes.
88+
89+
### Launch
90+
91+
When setup completes, the following confirmation appears:
92+
93+
```text
94+
AGENT CREATED SUCCESSFULLY
95+
Your agent is running in a secure sandbox and ready to use.
96+
97+
Agent: agent
98+
Model: nemotron-3-super-120b
99+
Provider: NVIDIA Cloud
100+
```
101+
102+
Click **Chat With Agent** to open the OpenClaw gateway dashboard.
103+
104+
## Have Your First Conversation
105+
106+
In the Chat box, type the following:
107+
108+
```text
109+
Hello! What can you do for me? What skills do you have available?
110+
```
111+
112+
The agent reads its workspace files and introduces itself.
113+
By default it has three skills available:
114+
115+
- **Weather** -- Get current weather and forecasts.
116+
- **Healthcheck** -- Security audit and hardening.
117+
- **Skill-Creator** -- Create new custom skills.
118+
119+
## Tell the Agent Who You Are
120+
121+
The agent starts with an empty `USER.md` file -- it knows nothing about you.
122+
Update it so the agent personalizes its responses.
123+
124+
In the chat, type the following:
125+
126+
```text
127+
Please update my USER.md file with the following:
128+
Name: [your name]
129+
Timezone: [your timezone, e.g. EST]
130+
Notes: [what you are working on]
131+
```
132+
133+
The agent writes this to your workspace so it remembers you across sessions.
134+
135+
## Stop Your Instance When Done
136+
137+
To avoid unnecessary charges, stop your instance when you are finished experimenting.
138+
139+
1. Go back to [brev.nvidia.com](https://brev.nvidia.com).
140+
2. Click **GPUs** in the nav bar.
141+
3. Find your NemoClaw instance.
142+
4. Click **Stop**.
143+
144+
At $0.18/hr, a 3-hour session costs approximately $0.54.
145+
146+
## What to Try Next
147+
148+
Now that your agent is running, explore these capabilities.
149+
150+
**Connect a messaging channel.**
151+
Go to **Channels** in the dashboard to connect your agent to Telegram, Slack, or Discord so it can message you proactively.
152+
153+
**Use a different AI model.**
154+
The agent supports switching inference providers at runtime.
155+
See [Switch Inference Providers](../inference/switch-inference-providers.md) for instructions.
156+
157+
## Next Steps
158+
159+
- [Prerequisites](prerequisites.md) -- System requirements before getting started.
160+
- [Quickstart](quickstart.md) -- CLI-based local setup.
161+
- [Deploy to a Remote GPU Instance](../deployment/deploy-to-remote-gpu.md) -- CLI-based Brev deployment.
162+
- [Troubleshooting](../reference/troubleshooting.md) -- Common issues and fixes.
163+
- [Monitor Sandbox Activity](../monitoring/monitor-sandbox-activity.md)

docs/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -344,6 +344,7 @@ Customize the Network Policy <network-policy/customize-network-policy>
344344
:hidden:
345345
346346
Deploy to a Remote GPU Instance <deployment/deploy-to-remote-gpu>
347+
Brev Web UI <get-started/brev-web-ui-quickstart>
347348
Install OpenClaw Plugins <deployment/install-openclaw-plugins>
348349
Sandbox Hardening <deployment/sandbox-hardening>
349350
```

0 commit comments

Comments
 (0)