Skip to content

aaronte/cloudclaw

Repository files navigation

CloudClaw

🧪 Experimental — not ready for use. I'm still experimenting with this and is only partially functional.

CloudClaw is a note-taking assistant: low-friction capture (“jot it down”) with persistent markdown memory you can export. It is intentionally not a general-purpose chat product. I wanted to build a cloud version of OpenClaw for my friends and family to experience the fun of having an OpenClaw agent without the effort and hassle of setting one up.


Preview

Cloudclaw chat demo

Cloudclaw chat demo


How this relates to OpenClaw

CloudClaw takes clear inspiration from OpenClaw’s ideas: a file-based agent workspace where continuity lives in markdown (persona, instructions, long-term memory, daily notes, heartbeat prompts) rather than opaque server state. If you know OpenClaw’s model, many of the same filenames and mental model apply here.

Similarities

  • Markdown-first workspace — Same broad pattern: files such as AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md, HEARTBEAT.md, BOOTSTRAP.md, plus dated and topic notes under notes/.
  • Memory as files — Daily notes for running context; MEMORY.md for longer-lived facts; search and tools oriented around that content.
  • Heartbeat / cron — Scheduled runs can prompt ongoing journaling and upkeep, aligned with “keep the memory alive” rather than one-off chat.
  • Capture surfaces — Support for channels such as WhatsApp alongside a main chat experience, in the spirit of “jot from anywhere.”
  • Assistant shaped for memory — Framed as a note-taking companion, not an open-ended “do everything” LLM UI.

Differences

CloudClaw OpenClaw (typical)
Hosting Web app (e.g. Next.js); multi-user, sign-in, billing hooks Often self-hosted / runs on your own machines and messengers
Where files live Primary workspace synced with Google Drive (your folder is the document of record) Usually local filesystem (or paths you control) on the device running the agent
Stack Next.js, hosted DB (e.g. SQLite / Turso), NextAuth, optional Stripe, Vercel-style deployment Separate runtime and ecosystem (see upstream project)
Maturity Experimental — incomplete, unstable for real use Mature, actively documented autonomous-agent framework
Scope Narrow: capture, memory, recall, export; generic chat is deprioritized Broader autonomous-agent and multi-platform tooling surface

CloudClaw is not a fork of OpenClaw and does not claim feature parity. It reuses the workspace metaphor and some conventions; implementation and operation are different.


Product direction

For goals, non-goals, and prioritization (capture vs. generic chat, export, heartbeat), see docs/PRODUCT_VISION.md.


Development

Prerequisites: Node.js and a package manager (npm, pnpm, yarn, or bun).

npm install
npm run dev

Open http://localhost:3000. You will need configured environment variables and integrations (auth, Drive, model providers, etc.) for full behavior — there is no turnkey “clone and run” story yet.

npm run build   # production build
npm run lint    # ESLint

Built with Next.js.

About

OpenClaw but in the cloud. Built for my family and friends.

Resources

Stars

Watchers

Forks

Contributors