fix(jarvis): restore managed telegram bootstrap flow by artemgetmann · Pull Request #802 · artemgetmann/openclaw

artemgetmann · 2026-05-27T07:25:26Z

Review Fast Path

User path fixed: Managed Telegram bots now seed the consumer Jarvis bootstrap templates before setup replay, so fresh bots should ask the consumer identity/name/role/vibe/call-you/emoji flow instead of the generic birth-ritual questions.
Proof: swift test --package-path apps/macos --filter AgentWorkspaceTests; swift test --package-path apps/macos --filter TelegramSetupBootstrapTests; swift test --package-path apps/macos --filter OnboardingViewSmokeTests; pnpm test -- --run src/agents/workspace.test.ts src/gateway/server.channels.test.ts test/scripts/generate-consumer-seeded-defaults.test.ts; pnpm test -- --run extensions/telegram/src/bot/delivery.test.ts extensions/telegram/src/draft-stream.test.ts; git diff --check.
Shared-state footgun removed: setup replay now goes through a registered gateway method and workspace seeding uses repo template loaders instead of duplicate Swift prompt copies.
Still hurts: no live Telegram runtime proof in this lane; prompt/persona files intentionally need founder review before merge.

Scope

Restores consumer Jarvis onboarding structure while keeping a small amount of personality: warm, capable, memorable, light dry wit, no vague creature labels.
Keeps the Jarvis preset shortcut after naming, then skips role/vibe and continues to call-you plus emoji.
Removes the required "Who am I? / What am I?" bootstrap ritual from managed Telegram first-run behavior.
Adds setup replay plumbing and tests for the Telegram managed setup path.

AI Assistance

Implemented by the delegated worker lane; coordinator reviewed, verified, committed, and opened this draft PR.

- what: restore the consumer Jarvis bootstrap templates, seed managed Telegram workspaces from those templates, and replay setup prompts through the gateway method - why: fresh managed bots were falling back to the generic birth-ritual prompt instead of the consumer onboarding flow - risk: changes first-run persona/system-prompt behavior, so prompt files need founder review before merge

- What: restores concise memory, identity, style, tool, and platform guidance in the consumer workspace templates. - Why: the managed Telegram bootstrap fix over-slimmed useful agent setup scaffolding while removing corporate/generic copy. - Risk: low; wording-only template/fallback changes with focused AgentWorkspace coverage.

- What: restore compact heartbeat, platform-formatting, and voice-tool guidance in the consumer workspace template and Swift fallback. - Why: generated Jarvis workspaces need enough inline guidance without assuming repo docs are present. - Risk: low; template-only behavior plus focused AgentWorkspace expectations.

artemgetmann · 2026-05-27T14:22:39Z

-Capture what matters. Decisions, context, things to remember. Skip the secrets unless asked to keep them.
+Use files, not session memory. If something matters, write it down.

-### 🧠 MEMORY.md - Your Long-Term Memory


why is this memory section removed? line 36 till line 44

artemgetmann · 2026-05-27T14:23:16Z

-### 🧠 MEMORY.md - Your Long-Term Memory
+## Heartbeats

- **ONLY load in main session** (direct chats with your human)


u removed this. is it recorded somewhere else or why was it removed? line 38-44

artemgetmann · 2026-05-27T14:24:02Z

-### 📝 Write It Down - No "Mental Notes"!
+Use heartbeats for broad sweeps: memory cleanup, recent context, inbox/calendar/project awareness, and other ambient checks. Use cron for exact reminders, precise schedules, or scoped monitors. If nothing needs attention, reply `HEARTBEAT_OK`.

- **Memory is limited** — if you want to remember something, WRITE IT TO A FILE


line 48-53. u removed this. is it recorded somewhere else or why was it removed?

artemgetmann · 2026-05-27T14:24:45Z

-## Red Lines
+## Guardrails

- Don't exfiltrate private data. Ever.


u removed this. is it recorded somewhere else or why was it removed? line 57-60 isnt this good guidance?

artemgetmann · 2026-05-27T14:25:24Z

+- Groups and topics are useful for longer or parallel work.
+- In group chats, participate without dominating. Add value when you have it; stay quiet when the room is fine without you.

- Read files, explore, organize, learn


line 66-68. u removed this. is it recorded somewhere else or why was it removed? isnt this fine though?

artemgetmann · 2026-05-27T14:26:34Z

- Work within this workspace
+## Platform Formatting

-**Ask first:**


line 70-121. u removed this. is it recorded somewhere else or why was it removed? u removed this whole thing for personality and good stuff and replaced it with these singapore three lines of corporate bullshit.

artemgetmann · 2026-05-27T14:27:27Z

- **Discord links:** Wrap multiple links in `<>` to suppress embeds: `<https://example.com>`
- **WhatsApp:** No headers — use **bold** or CAPS for emphasis
-
-## 💓 Heartbeats - Be Proactive!


line 135-142. u removed this. is it recorded somewhere else or why was it removed?

artemgetmann · 2026-05-27T14:27:56Z

-
-You are free to edit `HEARTBEAT.md` with a short checklist or reminders. Keep it small to limit token burn.
-
-### Heartbeat vs Cron: When to Use Each


u removed this. is it recorded somewhere else or why was it removed? line 144-196

artemgetmann · 2026-05-27T14:28:42Z

-**Proactive work you can do without asking:**
+Skills provide tools. When a task needs one, check the relevant `SKILL.md`.

- Read and organize memory files


line 198-202. u removed this. is it recorded somewhere else or why was it removed?

artemgetmann · 2026-05-27T14:29:09Z

- **Review and update MEMORY.md** (see below)
+Keep local operational notes in `TOOLS.md`: account names, camera names, stable paths, useful commands, and durable quirks. Do not store secrets there.

-### 🔄 Memory Maintenance (During Heartbeats)


line 204 and 208-211 .u removed this. is it recorded somewhere else or why was it removed?

artemgetmann · 2026-05-27T14:29:45Z

-4. Remove outdated info from MEMORY.md that's no longer relevant
+Do not pretend a voice tool exists. Check available tools or skills first. Do not use voice for private, sensitive, or surprising output unless the human asked for it.

-Think of it like a human reviewing their journal and updating their mental model. Daily files are raw notes; MEMORY.md is curated wisdom.


u removed this. is it recorded somewhere else or why was it removed?

artemgetmann · 2026-05-27T14:30:00Z

-Think of it like a human reviewing their journal and updating their mental model. Daily files are raw notes; MEMORY.md is curated wisdom.
+## Style

-The goal: Be helpful without being annoying. Check in a few times a day, do useful background work, but respect quiet time.


u removed this. is it recorded somewhere else or why was it removed?

artemgetmann · 2026-05-27T14:30:27Z

-Update these files with what you learned:
+Do not stop after the naming step.

- `IDENTITY.md` — your name, creature, vibe, emoji


u removed this. is it recorded somewhere else or why was it removed? line 35-36

artemgetmann · 2026-05-27T14:32:47Z

@@ -1,43 +1,51 @@
 ---
 title: "SOUL.md Template"
-summary: "Workspace template for SOUL.md"


why not say for soul.md? mb combine it with current line 3? like workspace template for soul.md for behavior tone and boundaries

artemgetmann · 2026-05-27T14:34:00Z


 ## Core Truths

-**Be genuinely helpful, not performatively helpful.** Skip the "Great question!" and "I'd be happy to help!" — just help. Actions speak louder than filler words.


why lines 14-23 where changed? I cant see many problems with the previous copy. Why was it changed I see there personality?

artemgetmann · 2026-05-27T14:34:51Z

-## Boundaries
+## Personality

- Private things stay private. Period.


L26-29 why was this removed?

artemgetmann · 2026-05-27T14:35:19Z

-## Vibe
+## Workspace Defaults

-Be the assistant you'd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone. Not a sycophant. Just... good.


why u removed this?! I kinda like it

artemgetmann · 2026-05-27T14:36:48Z

+## Workspace Defaults

-Be the assistant you'd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone. Not a sycophant. Just... good.
+- Telegram is the default surface.


So lines 36 to 38, why did you put it there? You're repeating yourself. I don't think this is necessary to be in the soul document.

artemgetmann · 2026-05-27T14:38:01Z

-## Continuity
+## Boundaries

-Each session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.


why u removed this?

artemgetmann · 2026-05-27T14:38:08Z

+- Do not send half-baked replies to messaging surfaces.
+- Do not speak for the human unless they explicitly ask you to.

-If you change this file, tell the user — it's your soul, and they should know.


why u removed this? nvm I see u wrote this below so I guess its ok

artemgetmann · 2026-05-27T14:38:29Z

+## Boundaries

-Each session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.
+- Keep private data private.


L42-45, should this really be in SOUL?

artemgetmann · 2026-05-27T14:40:54Z

-# USER.md - About Your Human
+# USER.md - Who I'm Helping

-_Learn about the person you're helping. Update this as you go._


update this as u go is fine why u removed that line?

artemgetmann · 2026-05-27T14:41:07Z

+Learn the human well enough to be useful, not nosy.

 - **Name:**
- **What to call them:**


dont see why u removed this

artemgetmann · 2026-05-27T14:41:42Z

-## Context
+## What Matters

-_(What do they care about? What projects are they working on? What annoys them? What makes them laugh? Build this over time.)_


u removed this, make sure what u changed this for is not too robotic.

artemgetmann · 2026-05-27T14:41:56Z


---
-
-The more you know, the better you can help. But remember — you're learning about a person, not building a dossier. Respect the difference.


why u removed this?

- what changed: restored memory/autonomy/personality guidance, added GROUPS.md, and aligned Swift/template allowlists. - why: keep AGENTS.md lean while preserving useful group behavior and privacy rules for generated Jarvis workspaces. - behavior/risk: low; prompt/template-only plus focused workspace tests, with generated Package.resolved churn reverted.

- what changed: update the bootstrap starter example in docs, macOS fallback template, and focused test expectation. - why: make the first spoken setup line feel more human while keeping workspace readiness guidance internal. - behavior/risk: copy-only fallback/template change; low risk and covered by AgentWorkspaceTests.

artemgetmann · 2026-05-28T06:22:12Z

        - `TOOLS.md` for local operational notes, durable quirks, and tool-specific reminders.

-        Use files, not session memory. If something matters, write it down.
+        Do not load `MEMORY.md` in shared or multi-person contexts. Private human context is not group-chat material.


unless the group only contains your owner/human

artemgetmann · 2026-05-28T06:24:56Z

+
+Use files, not session memory. If something matters, write it down: decisions, context, things to remember, and preferences that should survive the session. Skip secrets unless the human explicitly asks you to store them.
+
+If someone says "remember this", update the relevant memory file. Use `memory/YYYY-MM-DD.md` for daily notes and `MEMORY.md` for durable distilled context.


USER.md for info about the user or something like that. Put something like "because the AI might also want to record something about the user, and if he records it in memory, it's not the right place to put it actually."

artemgetmann · 2026-05-28T06:26:08Z

+
+## Reactions
+
+Use reactions when the platform supports them and a full reply would be noise: acknowledge, agree, celebrate, or mark that you saw something.


z where are the emojis from the previous version? That's better, I think, with emojis.

- Route durable user-profile facts to USER.md when that is the right home. - Restore concise group reaction examples while keeping one-reaction guidance. - Mirror bundled macOS fallback templates and focused AgentWorkspace coverage; risk is limited to generated workspace guidance text.

Codex added 3 commits May 27, 2026 15:23

artemgetmann force-pushed the codex/fix-telegram-setup-replay-20260525 branch from 42d3e61 to febbffe Compare May 27, 2026 14:08

artemgetmann commented May 27, 2026

View reviewed changes

Codex added 2 commits May 28, 2026 14:16

artemgetmann commented May 28, 2026

View reviewed changes

artemgetmann marked this pull request as ready for review May 28, 2026 07:55

artemgetmann merged commit d592fe9 into main May 28, 2026
4 of 9 checks passed

artemgetmann mentioned this pull request May 28, 2026

fix(consumer): propagate managed Jarvis backend config #806

Merged


		You are free to edit `HEARTBEAT.md` with a short checklist or reminders. Keep it small to limit token burn.

		### Heartbeat vs Cron: When to Use Each


		## Core Truths

		Be genuinely helpful, not performatively helpful. Skip the "Great question!" and "I'd be happy to help!" — just help. Actions speak louder than filler words.


		---

		The more you know, the better you can help. But remember — you're learning about a person, not building a dossier. Respect the difference.


		Use files, not session memory. If something matters, write it down: decisions, context, things to remember, and preferences that should survive the session. Skip secrets unless the human explicitly asks you to store them.

		If someone says "remember this", update the relevant memory file. Use `memory/YYYY-MM-DD.md` for daily notes and `MEMORY.md` for durable distilled context.


		## Reactions

		Use reactions when the platform supports them and a full reply would be noise: acknowledge, agree, celebrate, or mark that you saw something.

Conversation

artemgetmann commented May 27, 2026

Review Fast Path

Scope

AI Assistance

Uh oh!

Choose a reason for hiding this comment

Uh oh!

artemgetmann May 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

artemgetmann May 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

artemgetmann May 27, 2026 •

edited

Loading

artemgetmann May 27, 2026 •

edited

Loading