OpenClaw on Edgible — chapters¶
Each chapter is one job and one smoke test. Do them in order. Chapter 1 is Start here, shared with every other guide; if Hello World is already up, begin at chapter 2.
How to read a chapter: a one-line hook under the title, then N.0 Why (what is missing without this chapter, and which machine you run it on), then N.1 The job (what you’ll do, how you’ll know, what you need, what this is not). Steps after that, a Verify checklist that mirrors Done when, and Next at the end.
OpenClaw chats and uses tools on a box you own. Edgible is the public https://<app>.<org>.edgible.com hostname, reached over outbound 443 only. No port-forward, no mesh VPN. The Edgible story here is the Control UI: phone browser, org login, no tunnel on the laptop. Telegram and WhatsApp are chat clients; they are not Edgible apps.
Publishing plus two auth modes on one process (editor org, webhooks None) is n8n on Edgible. A remote self-hosted Gateway calling a self-hosted Ollama on another home machine is LLM on Edgible. That is not this series and not chapter 9; chapter 9 is same-LAN or cloud keys.
| # | Chapter | Smoke test |
|---|---|---|
| 1 | 1. Edgible on an Ubuntu VM (shared) | edgible whoami on the VM; Hello World on a phone (cellular) |
| 2 | 2. OpenClaw on the VM (loopback Gateway) | openclaw agent … hello; local Control UI (openclaw dashboard) if the guest has a desktop |
| 3 | 3. OpenClaw Control UI through Edgible | Phone opens openclaw-ui.<org>.edgible.com (org auth), chat works |
| 4 | 4. OpenClaw changes the public Edgible site | Control UI rewrites Hello World; optional hourly On this day |
| 5 | 5. OpenClaw skill for the Edgible CLI | VM edgible whoami and Control UI /skill edgible whoami |
| 6 | 6. Telegram pocket client for OpenClaw | DM your bot; /skill edgible whoami |
| 7 | 7. WhatsApp linked device for OpenClaw | Linked device hello with [OpenClaw]; optional ACP --bind here |
| 8 | 8. Cursor Agent from OpenClaw on the Edgible site | /acp doctor then spawn; Control UI uses steer; WhatsApp can bind |
| 9 | 9. Models beyond free Gemini | openclaw agent --model … hello on DeepSeek / Ollama / another key; optional fallbacks |
| 10 | 10. Tear down OpenClaw | openclaw-ui gone; nothing on 18789; n8n / ollama / serving agent left unless you opt in |
Do not use ! edgible whoami as the OpenClaw check in chapter 2. That is host bash (commands.bash), off by default, and needs elevated allowlists. Chapter 5 is /skill edgible whoami. Chapter 6 can enable ! if you want a host shell from Telegram.
The skill source is openclaw-edgible, not this repo.
Workflows (webhooks and auth split, not an agent): n8n on Edgible, on the same VM from chapter 1. A model you control, published for both products: LLM on Edgible.