NovelClaw

<div align="center"> <p> <img src="https://img.shields.io/badge/Python-3.10%2B-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.10+"> <img src="https://img.shields.io/badge/FastAPI-Writing%20Workspace-009688?style=for-the-badge&logo=fastapi&logoColor=white" alt="FastAPI writing workspace"> <img src="https://img.shields.io/badge/Scope-Long--Form%20Fiction-F97316?style=for-the-badge" alt="Long-form fiction"> <img src="https://img.shields.io/badge/Mode-Chapter%20Control%20%26%20Memory-0f766e?style=for-the-badge" alt="Chapter control and memory"> <img src="https://img.shields.io/badge/Release-GitHub%20Safe-f59e0b?style=for-the-badge" alt="GitHub-safe release"> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-111827?style=for-the-badge" alt="MIT License"></a> </p> <h3>✨ A structured long-form fiction workspace centered on chapter drafting, inspectable runs, manuscript review, and memory-aware writing control.</h3> <p> <a href="https://github.com/xiao-zi-chen">Yucheng Xiao</a>¹ <br> ¹Harbin Institute of Technology, Shenzhen </p> <p> 💡 NovelClaw is not a one-shot prompt wrapper. It turns long-form fiction work into an inspectable writing workspace with sessions, storyboards, manuscript surfaces, character and world views, and editable memory banks. </p> <p> <b>🌐 Try it online:</b> <a href="https://colong-idea-studio.cloud/">colong-idea-studio.cloud</a> </p> <p> <b>🚀 Start locally now:</b> <code>.\START_LOCAL.bat</code> </p> <p> <a href="https://colong-idea-studio.cloud/"><img src="https://img.shields.io/badge/Live%20Platform-Open%20Now-0f766e?style=flat-square&logo=googlechrome&logoColor=white" alt="Live platform"></a> <a href="README.zh-CN.md"><img src="https://img.shields.io/badge/Chinese-README-ef4444?style=flat-square" alt="Chinese README"></a> <a href="RUN_LOCAL_WEB.md"><img src="https://img.shields.io/badge/Local%20Run-Startup%20Guide-f59e0b?style=flat-square&logo=readthedocs&logoColor=white" alt="Local run guide"></a> <a href="DEPLOYMENT.md"><img src="https://img.shields.io/badge/Deployment-Server%20Notes-0f766e?style=flat-square" alt="Deployment guide"></a> <a href="WHAT_IS_SAFE_FOR_GITHUB.md"><img src="https://img.shields.io/badge/GitHub%20Safe-Checklist-111827?style=flat-square" alt="GitHub safety"></a> </p> <p> <a href="#overview">Overview</a> | <a href="#visual-tour">Visual Tour</a> | <a href="#why-it-stands-out">Why It Stands Out</a> | <a href="#workflow">Workflow</a> | <a href="#quick-start">Quick Start</a> | <a href="#claw-mode-guide">Claw Mode Guide</a> | <a href="#architecture">Architecture</a> | <a href="#runtime-artifacts">Runtime Artifacts</a> </p> </div>

🚀 Local Preview 👀 Enter from http://127.0.0.1:8010/select-mode, then continue into http://127.0.0.1:8012/dashboard for the main NovelClaw workspace.

🌐 Live Platform Visit colong-idea-studio.cloud if you want the fastest online entry point.

Overview 🌟

https://github.com/user-attachments/assets/f768395f-0d6e-471f-826d-62aed266fd0e

<p align="center"> _{Demo showcase of the NovelClaw workspace.} </p>

NovelClaw is the core writing workspace in this GitHub-safe public bundle. While Portal provides a clean public entry path and MultiAgent offers an optional faster ideation lane, the sustained long-form writing experience is concentrated in NovelClaw itself.

Instead of treating long-form fiction as a single prompt submission, NovelClaw organizes work into ongoing sessions, run inspection, manuscript review, storyboard development, and memory-aware writing control.

That makes it a better fit for authors and builders who want stronger continuity, clearer iteration surfaces, and more direct control over chapter-level progress. 🎯

• 📚 long-form fiction, serial writing, and chapter-by-chapter continuation
• 🧠 memory-aware drafting with inspectable chapter output and reusable story state
• 🤝 human-in-the-loop writing workflows with persistent control surfaces
• 🔍 observable runs with logs, progress traces, chapters, downloads, and review pages

<table> <tr> <td width="33%" valign="top"> <h3>✍️ Writing Workspace</h3> <p>NovelClaw keeps conversation, chapter drafting, run review, and continuation work inside one main workspace instead of scattering them across separate tools.</p> </td> <td width="33%" valign="top"> <h3>🗂️ Manuscript Surfaces</h3> <p>Storyboards, manuscript views, style panels, world panels, and character surfaces remain visible as working material instead of becoming hidden intermediate output.</p> </td> <td width="33%" valign="top"> <h3>🧠 Memory Control</h3> <p>Editable memory banks, run-linked artifacts, and chapter outputs give you a concrete surface for continuity, revision, and reuse across longer projects.</p> </td> </tr> </table>

Visual Tour 👀

<p align="center"> <img src="docs/readme-triptych-en.png" alt="From clean entry to sustained drafting to inspectable chapter control" width="100%"> </p>

NovelClaw is built around a simple claim: long-form writing quality improves when drafting, review, and memory control are treated as a continuing workspace rather than a one-pass generation event. ✨

Why It Stands Out ✨

<p align="center"> <img src="docs/dynamic-memory.png" alt="NovelClaw workflow across chapters, memory, and inspectable outputs" width="100%"> </p>

| Typical fiction tool flow | NovelClaw | |---|---| | Treats long-form writing as one large prompt | Treats long-form writing as an ongoing workspace with sessions and run inspection | | Hides execution state behind opaque generation | Exposes worker output, progress.log, chapter files, downloads, and job detail views | | Leaves story state scattered across temporary prompts | Keeps manuscript surfaces, world and character views, and memory banks inside the workspace | | Makes continuation control difficult after the first draft | Supports repeated return through sessions, storyboard views, manuscript review, and chapter monitoring | | Publishes public bundles with mixed local leftovers | Pairs the workspace with GitHub-safe packaging, safe env templates, and deployment references |

NovelClaw In Practice 🧠

• 📝 conversation sessions remain available as active writing context
• 📌 chapter output, progress traces, and downloads stay inspectable throughout a run
• 👤 world, character, style, and manuscript surfaces remain available for revision and continuation
• 🔁 Portal and MultiAgent can assist with entry and preparation, but the main long-form control surface remains NovelClaw

Workflow 🔄

<table> <tr> <td width="25%" valign="top"> <h4>1. Enter</h4> <p>Start from the public entry at <code>/select-mode</code> so the bundle remains cleanly separated from the old private auth flow.</p> </td> <td width="25%" valign="top"> <h4>2. Prepare</h4> <p>If needed, use the support layers for provider setup or faster idea refinement before moving into the main writing workspace.</p> </td> <td width="25%" valign="top"> <h4>3. Draft</h4> <p>Work inside NovelClaw to continue sessions, monitor runs, inspect chapter output, and steer manuscript development.</p> </td> <td width="25%" valign="top"> <h4>4. Review</h4> <p>Use manuscript, storyboard, world, character, style, and memory-bank surfaces to keep the project coherent as it grows.</p> </td> </tr> </table>

Best Use Cases 🎯

• 📖 chapter-based long-form fiction and serialized writing workflows
• 🧠 writing projects that need continuity tracking rather than one-pass output
• 🤝 collaborative or supervised drafting where the author keeps steering the process
• 🧪 engineering and product experiments around inspectable long-form writing systems

Quick Start 🚀

<details open> <summary><b>🌐 Option A: One-Click Local Stack</b></summary>

💻 Recommended on Windows:

.\START_LOCAL.bat

🌐 Local URLs:

Portal      http://127.0.0.1:8010/select-mode
MultiAgent  http://127.0.0.1:8011/dashboard
NovelClaw   http://127.0.0.1:8012/dashboard

✅ Recommended main path:

http://127.0.0.1:8010/select-mode -> http://127.0.0.1:8012/dashboard

✅ What this script does:

• stops old listeners on 8010, 8011, and 8012
• writes local .env files from safe defaults
• prepares a shared .venv-shared
• starts Portal, MultiAgent, and NovelClaw

</details> <details> <summary><b>⌨️ Option B: Manual PowerShell Startup</b></summary>

.\scripts\setup-local-env.ps1 -Overwrite
.\scripts\bootstrap-shared-venv.ps1
.\scripts\start-all-local.ps1 -UseSharedVenv

🛑 Stop everything:

.\STOP_LOCAL.bat

🛠️ Helpful commands:

.\scripts\stop-all-local.ps1
.\scripts\start-all-local.ps1 -UseSharedVenv -RestartExisting

</details>

<a id="claw-mode-guide"></a>

Claw Mode Guide 🛠️

If your goal is to work inside the main NovelClaw writing workspace, the most practical operating path is:

1. Enter the workspace Start from http://127.0.0.1:8010/select-mode, choose NovelClaw, and continue into http://127.0.0.1:8012/dashboard.
2. Configure models first Open /console/models, save an API key for an available provider, or add a custom provider if you do not want to use the default list. If no provider is configured, the chat workspace will remind you to finish this step first.
3. Start a writing session Open /console/chat, choose a provider, and submit an initial premise, tone, cast, or writing task. NovelClaw will open an active conversation thread, continue asking for refinement when needed, and let you hand the brief off to formal creation when the session is ready.
4. Track the