openclaw-webtop

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #llm #go #golang #deep-learning #macos #nodejs #windows #cli #mcp #ios #open-source

openclaw-webtop

(★ 24)

Brew your lobster securely without breaking your bank

openclaw-webtop 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🦞 OpenClaw — Web Top
_Run openclaw securely without any dedicated mac-mini, hostinger or gpu._

 <picture>
 <img width="703" height="344" alt="openclaw-webtop-title-logo" src="./docs/openclaw-webtop-title-logo.png" />
 </picture>

Brew your lobster securely without breaking your bank

**OpenClaw-WebTop** gives you a **fully functional OpenClaw personal AI assistant** in your browser in under 10 minutes — no powerful PC, no Docker on your machine, no GPU required.

Just open this repo in a GitHub Codespace and you get:
- A complete Ubuntu MATE desktop (WebTop)
- Ollama server pre-installed and auto-started
- ModelRelater pre-installed, auto-started and pre-config as default model
- OpenClaw globally installed via npm
- Persistent volume for your config, pairings, and OpenClaw ID

When you’re ready to go production, simply move the same Docker setup to your own machine or VPS. *

## ✨ Why This Exists

OpenClaw (the core project) is one of the most exciting AI agent frameworks right now — it connects LLMs directly to your WhatsApp, Telegram, Slack, Discord, etc., and can run cron jobs, spawn sub-agents, speak/listen, and give you a beautiful dashboard.

The only catch? You normally need a dedicated machine.  
**OpenClaw-WebTop removes that catch completely.**

Perfect for:
- Trying OpenClaw risk-free
- Free LLM APIs through [ModelRelay](https://github.com/ellipticmarketing/modelrelay)
- Students / hackers / evaluators
- Anyone who wants to “brew their lobster” securely on free cloud credits

## 📸 Demo (old ~ Ollama is not needed)
[Demo](https://youtu.be/fn-VDqMNAuI?si=puZCVzk3RzRITywd) of the full process

## 🚀 Quick Start (5-10 minutes)

1. **Open this repository in a GitHub Codespace** (big green “Code” button → Codespaces → New)

It is recommended that you use 4 cpu core and 16G codespace.
 
 <img width="703" alt="launch-codespace" src="./docs/launch-codespace.png">
3. In the Codespace terminal run:
 ```bash
 make start
 ```
 (or make start-locally-baked if you prefer a pre-built image)
4. Wait ~60 seconds. When the web desktop URL appears in the Codespace Ports tab, click it.
 <img width="703" alt="launch-webtop-via-ports" src="./docs/launch-webtop-via-ports.png">

5. Inside the WebTop desktop:
- Open a terminal → `openclaw dashboard` → copy the tokenized URL and open the URL with a Chromium browser
- In the chat panel of OpenClaw, issue command `/restart` This will ensure that the preconfigured default model is reflected
- You now have a **fully working OpenClaw instance running 100% in the cloud.**
 <img width="703" alt="End Results" src="./docs/working-openclaw.png">

## 🔧 Features

- **Zero local install** — everything runs in browser via GitHub Codespaces
- **Free-tier friendly** — uses ModelRelay, Ollama daily cloud credits or NVIDIA Build API fallback
- **Persistent config** — if docker volume backup and restore after Codespace recreation
- **Easy backup/restore** — `make backup` / `make restore`
- **One-command everything** — powerful Makefile + clean `docker-compose.yml`
- **Auto-start ModelRelay** - Default configuration for Free LLM API
- **Auto-start Ollama** — custom init script on WebTop boot
- **Colima / local Docker support** ready
 - **Built-in code-server IDE** — browser-based VS Code on port `8888`

## 🧑‍💻 Built-in code-server IDE

This image includes `code-server` and exposes it on port `8888`.

- `code-server` is installed automatically in the container.
- The desktop launcher `CodeServer` starts it inside the WebTop environment.
- In Codespaces, use the forwarded private port `8888`.
- Locally, open `http://localhost:8888`.

> Note: this setup may use `code-server --auth none` in development, so keep port `8888` private. For local production use, secure it with an authenticated reverse proxy or firewall.

## 🔒 Security: Protected by GitHub Authentication

**The WebTop URI is automatically protected — no one else can reach it.**

GitHub Codespaces forwards ports **privately by default** (this is the setting the `make start` command uses). According to official [GitHub documentation](https://docs.github.com/en/enterprise-cloud@latest/codespaces/reference/security-in-github-codespaces):

> “All forwarded ports are private by default, which means that you will need to authenticate before you can access the port.”  
> “Privately forwarded ports: Are accessible on the internet, but **only the codespace creator can access them, after authenticating to GitHub**.”

### How the protection actually works
- The URL you click in the **Ports** tab (`https://<your-codespace>-3000.app.github.dev`) is guarded by **GitHub authentication cookies**.
- These cookies expire every **3 hours** — you’ll simply be asked to log in again (super quick).
- If someone tries to open the link in an incognito window, via curl, or from another computer without being logged into **your** GitHub account, they are redirected to the GitHub login page or blocked.
- You (and only you) can access the full Ubuntu desktop, the browser inside it, Ollama, OpenClaw dashboard, and everything else.

### Extra security layers built-in
- The entire environment runs in an **isolated GitHub-managed VM** — not on your laptop.
- Codespaces are **ephemeral**: delete the codespace and everything disappears (except the backed-up volume you control).
- TLS encryption is handled automatically by GitHub.
- The `GITHUB_TOKEN` inside the codespace is scoped only to this repo and expires when you stop/restart.
- We never set the port to “Public” or even “Private to Organization” — it stays strictly private to you.

**Bottom line**: This is actually **more secure** for experimentation than running Docker locally on your personal machine (no accidental exposure, no firewall holes, no persistent processes on your hardware).

**For production use** we still recommend moving the same Docker image to your own VPS or server with additional hardening (firewall, HTTPS reverse proxy, strong secrets, etc.). This Codespace version is perfect for safe testing and development.

## 💾 Backup & Restore
Your OpenClaw ID, device pairings, and configuration are persisted in a Docker volume.
The project includes convenient `make` targets to back up and restore this data in codespace:
```bash
make backup          # creates backup/openclaw-webtop.tar.gz
make restore         # restores from backup/openclaw-webtop.tar.gz
```
### When to Use It
- Migrating from GitHub Codespaces to a local machine or VPS
- Testing experimental changes without risking your current setup
- Quickly cloning your working environment into a fresh Codespace or container

### How to Migrate to a New Environment
- In your current environment, run `make backup`.
- Download the generated file: `backup/openclaw-webtop.tar.gz`.
- Place the file in the `backup/` folder of the new environment.
- Run `make restore`.

**💡 Tip:** Always back up before making significant changes. The restore process will overwrite the existing volume data, so test in a separate environment first if you're unsure.

## 🛠️ Advanced Usage
Run locally (no Codespaces)
```bash
make build-local             # especially if you modified the ./docker/Dockerfile
make start-locally-baked     # start from your local bake image
```

### NVIDIA Build API as Free Fallback Model (Optional but Recommended)
NVIDIA offers free inference endpoints for powerful models like Moonshot AI's Kimi K2 (e.g., kimi-k2-instruct) through their Build platform. These make an excellent low-cost or zero-cost fallback when your primary model hits rate limits or goes down.

#### Step-by-Step Setup
- Go to [NVIDIA Build](https://build.nvidia.com/) and sign in (free NVIDIA Developer account required).
- Navigate to the Models tab and find a Free Endpoint. Good choices: `moonshotai/kimi-k2-instruct`
- Click on the model. This opens a chat interface.
- Click the **View Code** button (usually top-right).
- In the "Copy Code to Make an API Request" panel:
 - Click **Generate API Key** — the key will automatically appear in the code sample.
 - Copy the entire Python code snippet.
- Paste the code into a chat with OpenClaw and use this prompt:
```
Hey, here's the Python code from NVIDIA Build to call an API with a model (my API key already included). 
1. Test the code to make sure it works.
2. Configure this model as a fallback for my primary model.
```
- OpenClaw should automatically detect the OpenAI-compatible endpoint, extract the key, and set it up as a fallback.
<img width="703" alt="End Results" src="./docs/nvidia-build-api.png">

## ⚠️ Current Limitations (honest)

- GitHub Codespaces free tier has monthly limits (great for testing, less ideal for 24/7 as Codespace auto-shutdown during inactivity)
- Ollama cloud [credits](https://ollama.com/settings) are daily — heavy use will push you to paid/local models. Or if you have multiple accounts, just `ollama signout` and `ollamasignin` with different account.
- Browser desktop has slight latency vs native (expected). You can shutdown your codespace and [change](https://docs.github.com/en/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace) to 4-core codespace to improve responsiveness or the need to run heavy applications.

## 🛣️ Roadmap

- [ ] More screenshots + video demo
 - [ ] Full pairing automation scripts
 - [ ] Pre-built Docker image tags for stable releases
 - [ ] Community templates (Telegram-only, WhatsApp-only, etc.)
 - [ ] One-click “deploy to VPS” guide (Railway / Fly.io / cheap VPS) ?

## 🤝 Contributing
This is a one-person weekend project right now — every star, issue, or PR helps enormously!
Feel free to open issues for bugs or feature requests.

[![Star History Chart](https://api.star-history.com/svg?repos=gitricko/openclaw-webtop&type=date&legend=top-left)](https://www.star-history.com/#gitricko/openclaw-webtop&type=date&legend=top-left)

## 📄 License
Apache-2.0 — see [LICENSE](./LICENSE)

openclaw-webtop

openclaw-webtop 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

openclaw-webtop

openclaw-webtop 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README