Skip to content

Commit 4fbd383

Browse files
committed
docs(website): add system prompt section and rename openclaw page
Document how CLI, Gen, and server share the same base system prompt in architecture.md. Rename openclaw-migration to openclaw-compatibility to reflect that the projects have diverged as fundamentally different tools, and remove the cleanup section.
1 parent 27a6a43 commit 4fbd383

3 files changed

Lines changed: 27 additions & 15 deletions

File tree

website/docs/architecture.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -177,6 +177,30 @@ Primary user-facing binary with commands:
177177
- Procedural environmental audio (FunDSP)
178178
- glTF/GLB scene export
179179

180+
## System Prompt
181+
182+
All binaries share the same base system prompt, built by `build_system_prompt()` in `localgpt-core`. This function assembles identity, safety guidelines, tool descriptions, workspace info, and runtime metadata. On each new session, the agent loads workspace context (SOUL.md, MEMORY.md, daily logs, HEARTBEAT.md) and appends it to the system prompt.
183+
184+
### What's shared
185+
186+
Every binary — CLI, Gen, server, mobile, bridge daemons — gets the same core prompt through `Agent::new_session()`. This includes:
187+
188+
- Identity and safety guidelines
189+
- Tool documentation (generated from the registered tool set)
190+
- Workspace directory and current time
191+
- Memory file conventions
192+
- Runtime info (model, hostname, OS)
193+
194+
### What differs
195+
196+
| | CLI | Gen | Server / Mobile |
197+
|---|---|---|---|
198+
| **Agent creation** | `Agent::new()` — async, connects MCP servers | `Agent::new_with_tools()` — sync, tools provided upfront | `Agent::new()` — safe tools only |
199+
| **Tools** | Safe tools + CLI tools (bash, file ops) + spawn_agent | Safe tools + gen3d tools (spawn_entity, etc.); interactive mode also adds CLI tools | Safe tools only (no file system access) |
200+
| **Extra prompts** | None | `GEN_MEMORY_PROMPT` (creative memory guidance) added as a user message; `HEADLESS_EXPERIMENT_PROMPT` for headless mode | None |
201+
202+
Gen's additional prompts live in `crates/gen/src/gen3d/system_prompt.rs` and are injected as **user messages** in the chat history, not modifications to the system prompt itself. This keeps the core prompt identical while giving Gen domain-specific guidance for creative world-building and memory usage.
203+
180204
## Mobile
181205

182206
### `localgpt-mobile-ffi`
Lines changed: 2 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
1-
# Migrating from OpenClaw
1+
# OpenClaw Compatibility
22

3-
LocalGPT is a spiritual successor to OpenClaw, built from scratch in Rust. It uses the same workspace file formats and conventions, so migrating your data is straightforward.
4-
5-
LocalGPT does **not** auto-migrate your OpenClaw data. Follow the steps below to bring your existing workspace, config, and sessions into LocalGPT.
3+
LocalGPT started as a spiritual successor to OpenClaw, built from scratch in Rust. While the two projects have since diverged into fundamentally different tools, LocalGPT uses the same workspace file formats and conventions, so existing OpenClaw data can be reused.
64

75
## Config
86

@@ -80,13 +78,3 @@ LocalGPT takes a different approach from OpenClaw in several areas:
8078
- **No subagent spawning** — single "main" agent
8179

8280
Everything else — memory, heartbeat, skills, session management — works the same way.
83-
84-
## Cleanup
85-
86-
Once you have verified that LocalGPT is working correctly with your migrated data, you can optionally remove the OpenClaw directory:
87-
88-
```bash
89-
rm -rf ~/.openclaw
90-
```
91-
92-
This will suppress the startup notice about detected OpenClaw data.

website/sidebars.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ const sidebars: SidebarsConfig = {
66
{
77
type: 'category',
88
label: 'Getting Started',
9-
items: ['installation', 'quick-start', 'openclaw-migration', 'upgrade-v0.2'],
9+
items: ['installation', 'quick-start', 'openclaw-compatibility', 'upgrade-v0.2'],
1010
},
1111
{
1212
type: 'category',

0 commit comments

Comments
 (0)