Fix Telegram HTML chunking and improve setup docs

- Fix unclosed HTML tags when splitting long Telegram messages across
  the 4096-char limit. Tags (pre, code, b, i, etc.) are now properly
  closed at chunk boundaries and reopened in the next chunk.
- Add explicit /setup-ghostclaw instruction to README getting started
  section — was previously unclear that users need to run the skill.
- Rename /setup skill from "NanoClaw Setup" to "GhostClaw Setup" and
  update all nanoclaw references to ghostclaw.
- Remove outdated "instead of NanoClaw's /setup" from setup-ghostclaw
  skill description.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: ziggy

.claude/skills/setup-ghostclaw/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: setup-ghostclaw
-description: First-time GhostClaw setup. Handles dependencies, authentication, channel configuration, main chat registration, soul building, and service setup. Run this instead of NanoClaw's /setup.
+description: First-time GhostClaw setup. Handles dependencies, authentication, channel configuration, main chat registration, soul building, and service setup. Use this for all new installs.
 ---
 
 # GhostClaw Setup

.claude/skills/setup/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: setup
-description: Run initial NanoClaw setup. Use when user wants to install dependencies, authenticate WhatsApp, register their main channel, or start the background services. Triggers on "setup", "install", "configure nanoclaw", or first-time setup requests.
+description: Run initial GhostClaw setup. Use when user wants to install dependencies, authenticate WhatsApp, register their main channel, or start the background services. Triggers on "setup", "install", "configure ghostclaw", or first-time setup requests.
 ---
 
-# NanoClaw Setup
+# GhostClaw Setup
 
 Run setup steps automatically. Only pause when user action is required (WhatsApp authentication, configuration choices). Setup uses `bash setup.sh` for bootstrap, then `npx tsx setup/index.ts --step <name>` for all other steps. Steps emit structured status blocks to stdout. Verbose logs go to `logs/setup.log`.
 

README.md

@@ -44,7 +44,13 @@ npm install
 claude
 ```
 
-Claude reads the setup instructions automatically and walks you through everything — connecting Telegram, adding your API keys, setting up personality. You just answer questions. About 10 minutes.
+Once Claude starts, run the setup skill:
+
+```
+/setup-ghostclaw
+```
+
+This walks you through everything — connecting Telegram, adding your API keys, setting up personality. You just answer questions. About 10 minutes.
 
 **Requirements:** Node.js 20+, macOS or Linux, Claude Max or API keys.
 

src/channels/telegram.ts

@@ -213,11 +213,19 @@ export class TelegramChannel implements Channel {
           await fs.promises.writeFile(filepath, buffer);
 
           placeholder = `[Photo: ${filepath}]`;
-          logger.info({ chatJid, filepath, bytes: buffer.length }, 'Downloaded Telegram photo');
+          logger.info(
+            { chatJid, filepath, bytes: buffer.length },
+            'Downloaded Telegram photo',
+          );
 
           // Also save to Desktop for easy access
-          if (chatJid === 'tg:414798121') { // Main chat
-            const desktopPath = path.join(process.env.HOME || '', 'Desktop', 'latest-telegram-photo.jpg');
+          if (chatJid === 'tg:414798121') {
+            // Main chat
+            const desktopPath = path.join(
+              process.env.HOME || '',
+              'Desktop',
+              'latest-telegram-photo.jpg',
+            );
             await fs.promises.writeFile(desktopPath, buffer);
             logger.info({ desktopPath }, 'Saved photo to Desktop');
           }
@@ -335,9 +343,11 @@ export class TelegramChannel implements Channel {
           parse_mode: 'HTML',
         });
       } else {
-        // Split on newlines to avoid breaking HTML tags mid-tag
+        // Split on newlines, closing/reopening HTML tags across chunk boundaries
         const chunks: string[] = [];
         let current = '';
+        const TELEGRAM_TAGS = ['pre', 'code', 'b', 'i', 'u', 's', 'a'];
+
         for (const line of html.split('\n')) {
           if (current.length + line.length + 1 > MAX_LENGTH) {
             if (current) chunks.push(current);
@@ -348,7 +358,35 @@ export class TelegramChannel implements Channel {
         }
         if (current) chunks.push(current);
 
+        // Fix unclosed tags in each chunk
+        const fixedChunks: string[] = [];
+        let carryTags: string[] = []; // tags to reopen in next chunk
         for (const chunk of chunks) {
+          let fixed = carryTags.map((t) => `<${t}>`).join('') + chunk;
+
+          // Track which tags are open at the end of this chunk
+          const openTags: string[] = [];
+          for (const tag of TELEGRAM_TAGS) {
+            const opens = (
+              fixed.match(new RegExp(`<${tag}(\\s|>)`, 'gi')) || []
+            ).length;
+            const closes = (fixed.match(new RegExp(`</${tag}>`, 'gi')) || [])
+              .length;
+            for (let i = 0; i < opens - closes; i++) {
+              openTags.push(tag);
+            }
+          }
+
+          // Close any unclosed tags at end of this chunk (reverse order)
+          carryTags = [...openTags];
+          for (const tag of [...openTags].reverse()) {
+            fixed += `</${tag}>`;
+          }
+
+          fixedChunks.push(fixed);
+        }
+
+        for (const chunk of fixedChunks) {
           await this.bot.api.sendMessage(numericId, chunk, {
             parse_mode: 'HTML',
           });