claude-telegram-bot 0.3.0 → 0.3.2

package/README.ko.md

@@ -68,11 +68,10 @@ OpenClaw처럼 웹 UI까지 갖춘 구성을 써봤다면, 이 프로젝트는
 **npx로 바로 실행**
 
 ```sh
-npx claude-telegram-bot init              # 현재 폴더에 config.json 생성
-npx claude-telegram-bot init mybot.json   # 파일명 직접 지정도 가능
+npx claude-telegram-bot init              # 현재 폴더에 mybot.json 생성
+npx claude-telegram-bot init myapp.json   # 파일명 직접 지정도 가능
 # 설정 편집 (token, projectDir 등)
-npx claude-telegram-bot                   # config.json 으로 실행
-npx claude-telegram-bot mybot.json        # 또는 경로를 직접 전달
+npx claude-telegram-bot                   # mybot.json 으로 실행 (없으면 config.json 폴백)
 ```
 
 **전역 설치 (상시 가동에 권장)**
@@ -80,8 +79,8 @@ npx claude-telegram-bot mybot.json        # 또는 경로를 직접 전달
 ```sh
 npm i -g claude-telegram-bot
 
-claude-telegram-bot init ~/botconfigs/myproj              # config.json 생성
-claude-telegram-bot init ~/botconfigs/myproj/mybot.json   # 또는 파일명 지정
+claude-telegram-bot init ~/botconfigs/myproj              # mybot.json 생성
+claude-telegram-bot init ~/botconfigs/myproj/myapp.json   # 또는 파일명 지정
 # 설정 편집
 claude-telegram-bot ~/botconfigs/myproj/mybot.json
 ```
@@ -90,7 +89,7 @@ claude-telegram-bot ~/botconfigs/myproj/mybot.json
 
 ## 설정
 
-`config.json`의 키는 다음과 같습니다.
+`mybot.json`(또는 사용 중인 config 파일)의 키는 다음과 같습니다.
 
 | 키 | 설명 |
 |---|---|

package/README.md

@@ -118,11 +118,10 @@ Prerequisites: **Node 18+** and the **`claude` CLI installed and authenticated**
 **Option A — npx (no install)**
 
 ```sh
-npx claude-telegram-bot init             # writes ./config.json
-npx claude-telegram-bot init mybot.json  # or pick your own filename
+npx claude-telegram-bot init             # writes ./mybot.json
+npx claude-telegram-bot init myapp.json  # or pick your own filename
 # edit the config (token, projectDir, …)
-npx claude-telegram-bot                  # runs ./config.json
-npx claude-telegram-bot mybot.json       # or pass the path directly
+npx claude-telegram-bot                  # runs ./mybot.json (falls back to config.json)
 ```
 
 **Option B — global install (recommended for an always-on daemon)**
@@ -130,8 +129,8 @@ npx claude-telegram-bot mybot.json       # or pass the path directly
 ```sh
 npm i -g claude-telegram-bot
 
-claude-telegram-bot init ~/botconfigs/myproj           # writes ~/botconfigs/myproj/config.json
-claude-telegram-bot init ~/botconfigs/myproj/mybot.json  # or a custom filename
+claude-telegram-bot init ~/botconfigs/myproj             # writes ~/botconfigs/myproj/mybot.json
+claude-telegram-bot init ~/botconfigs/myproj/myapp.json  # or a custom filename
 # edit the config (token, projectDir, …)
 claude-telegram-bot ~/botconfigs/myproj/mybot.json
 ```
@@ -152,7 +151,7 @@ Run several projects/personas by making one config file each and passing its pat
 leave `allowedChatId` empty for now.
 
 **2) Find your chatId and lock the bot to it** — Start the bot (`claude-telegram-bot …`), send it any
-message in Telegram; it replies with this chat's `chatId`. Put that number into `config.json`
+message in Telegram; it replies with this chat's `chatId`. Put that number into `mybot.json`
 `allowedChatId` and restart. Now only you can use it. (See [Security](#security) — this is your only
 auth layer.)
 
@@ -175,18 +174,18 @@ Commands: `/new` (reset context / new session) · `/stop` (stop current task; `-
 
 **4) Keep it always on (optional)** — see [Always-on with launchd](#always-on-with-launchd-macos).
 
-> **From source** (for hacking on the bot): clone the repo, `cp config.example.json config.json`,
-> then `node bot.mjs [config.json]`. Same behavior as the CLI.
+> **From source** (for hacking on the bot): clone the repo, `cp config.example.json mybot.json`,
+> then `node bot.mjs [mybot.json]`. Same behavior as the CLI.
 
 ---
 
 ## Configuration
 
 ```sh
-cp config.example.json config.json
+cp config.example.json mybot.json
 ```
 
-Edit `config.json`:
+Edit `mybot.json`:
 
 | Key | Description |
 |---|---|
@@ -273,7 +272,7 @@ Config-defined jobs still require a restart to change; only chat-added jobs are
 
 The code is project-agnostic: make **one config file per project** and run several at once.
 
-- Run: `node bot.mjs /absolute/path/to/project.config.json` (no arg → `./config.json`)
+- Run: `node bot.mjs /absolute/path/to/project.config.json` (no arg → `./mybot.json`, fallback `./config.json`)
 - `state.json` and `attachments/` live in the **config file's folder**, so projects don't mix.
 - **Note**: Telegram allows only one poller per token → each project needs its **own BotFather
   token**.
@@ -299,7 +298,7 @@ One codebase, **a separate config file per role**.
   shell-using bot (`bypassPermissions`) to **just one** to avoid concurrent-edit conflicts. For
   read/plan-only, use `plan`.
 - **Session isolation**: the `state` filename is derived from the config name
-  (`config.json` → `state.json`, `dev.config.json` → `dev.config.state.json`), so multiple configs
+  (`mybot.json` → `mybot.state.json`, `dev.config.json` → `dev.config.state.json`), so multiple configs
   in one folder don't share context.
 - **One token per bot**: each bot needs its own BotFather token (`allowedChatId` can be the same).
 

package/bot.mjs

@@ -58,7 +58,7 @@ Requires: the claude CLI installed and authenticated on the host.`);
   }
   if (a === "init") {
     const arg = process.argv[3];
-    const target = arg?.endsWith(".json") ? resolve(arg) : join(arg || process.cwd(), "config.json");
+    const target = arg?.endsWith(".json") ? resolve(arg) : join(arg || process.cwd(), "mybot.json");
     if (existsSync(target)) {
       console.error(`Already exists: ${target}`);
       process.exit(1);
@@ -71,8 +71,9 @@ Requires: the claude CLI installed and authenticated on the host.`);
 
 // Config path via arg or BOT_CONFIG env so one shared codebase can drive many
 // projects; state + attachments live next to that config, keeping projects
-// isolated. Falls back to ./config.json for the single-project setup.
-const CONFIG_PATH = process.argv[2] || process.env.BOT_CONFIG || join(HERE, "config.json");
+// isolated. Defaults to mybot.json, falls back to config.json for existing setups.
+const _defaultCfg = existsSync(join(HERE, "mybot.json")) ? join(HERE, "mybot.json") : join(HERE, "config.json");
+const CONFIG_PATH = process.argv[2] || process.env.BOT_CONFIG || _defaultCfg;
 const DATA_DIR = dirname(CONFIG_PATH);
 // 데이터(state·attachments)는 config 폴더 아래 숨김 폴더 .claude-bot/ 에 모은다.
 // state 파일명은 config 이름에서 파생 → 여러 페르소나 config 가 한 .claude-bot/ 를 공유해도 안 섞임
@@ -82,6 +83,7 @@ const stateFile = stateBase === "config" ? "state.json" : `${stateBase}.state.js
 const BOT_DIR = join(DATA_DIR, ".claude-bot");
 const STATE_PATH = join(BOT_DIR, stateFile);
 const ATTACH_DIR = join(BOT_DIR, "attachments");
+const MEMORY_PATH = join(BOT_DIR, "memory.md"); // /new 로 초기화해도 유지되는 퍼시스턴트 메모리
 const LEGACY_STATE_PATH = join(DATA_DIR, stateFile); // 구버전(루트 직하) 호환
 const LEGACY_ATTACH_DIR = join(DATA_DIR, "attachments");
 
@@ -129,6 +131,8 @@ const STR = {
       "• /new — reset conversation context (new session)\n" +
       "• /stop — stop the current task · /stop --reset to also roll back the session\n" +
       "• /cron — list tasks · /cron add <natural language> to add · /cron rm <id> to remove\n" +
+      "• /remember <text> — save to persistent memory (survives /new)\n" +
+      "• /memory — view memory · /memory clear to wipe\n" +
       "• /restart — restart the bot (after a syntax check)\n" +
       "• /status — bot status & version\n" +
       "• /model — view / switch the model\n" +
@@ -182,6 +186,12 @@ const STR = {
       `/model default — clear the override`,
     modelSet: (m) => `🧠 Model set to: ${m}`,
     modelReset: (def) => `🧠 Model reset to default (${def}).`,
+    memoryEmpty: "No memory yet. Use `/remember <text>` to add.",
+    memoryShow: (m) => `💾 Memory:\n\`\`\`\n${m}\n\`\`\``,
+    memoryCleared: "🧹 Memory cleared.",
+    remembered: "💾 Saved to memory.",
+    rememberUsage: "Usage: /remember <text to remember>",
+    memoryUsage: "Usage: /memory · /memory clear",
   },
   ko: {
     help: () =>
@@ -190,6 +200,8 @@ const STR = {
       "• /new — 대화 맥락 초기화 (새 세션)\n" +
       "• /stop — 진행 중인 작업 중단 · /stop --reset 으로 세션도 되돌리기\n" +
       "• /cron — 예약 작업 보기 · /cron add <자연어>로 추가 · /cron rm <번호>로 삭제\n" +
+      "• /remember <내용> — 퍼시스턴트 메모리에 저장 (/new 로 초기화해도 유지)\n" +
+      "• /memory — 메모리 보기 · /memory clear 로 삭제\n" +
       "• /restart — 봇 재시작 (문법 검사 후 안전하게)\n" +
       "• /status — 봇 상태·버전 보기\n" +
       "• /model — 모델 보기·전환\n" +
@@ -242,6 +254,12 @@ const STR = {
       `/model default — 오버라이드 해제`,
     modelSet: (m) => `🧠 모델을 ${m} (으)로 설정했습니다.`,
     modelReset: (def) => `🧠 모델을 기본값(${def})으로 되돌렸습니다.`,
+    memoryEmpty: "저장된 메모리가 없습니다. `/remember <내용>`으로 추가하세요.",
+    memoryShow: (m) => `💾 메모리:\n\`\`\`\n${m}\n\`\`\``,
+    memoryCleared: "🧹 메모리를 삭제했습니다.",
+    remembered: "💾 메모리에 저장했습니다.",
+    rememberUsage: "사용법: /remember <기억할 내용>",
+    memoryUsage: "사용법: /memory · /memory clear",
   },
 };
 const t = (l, key, ...a) => {
@@ -257,6 +275,8 @@ const COMMANDS = {
   en: [
     { command: "new", description: "Reset context (new session)" },
     { command: "stop", description: "Stop the current task (--reset to roll back session)" },
+    { command: "remember", description: "Save to persistent memory (survives /new)" },
+    { command: "memory", description: "View or clear persistent memory" },
     { command: "cron", description: "List / add / remove scheduled tasks" },
     { command: "restart", description: "Restart the bot (after syntax check)" },
     { command: "status", description: "Bot status / version" },
@@ -267,6 +287,8 @@ const COMMANDS = {
   ko: [
     { command: "new", description: "대화 맥락 초기화 (새 세션)" },
     { command: "stop", description: "작업 중단 (--reset 으로 세션 되돌리기)" },
+    { command: "remember", description: "퍼시스턴트 메모리에 저장 (/new 후에도 유지)" },
+    { command: "memory", description: "메모리 보기·삭제" },
     { command: "cron", description: "예약 작업 보기·추가·삭제" },
     { command: "restart", description: "봇 재시작 (문법 검사 후)" },
     { command: "status", description: "봇 상태·버전 보기" },
@@ -293,6 +315,15 @@ function checkLocalLock() {
   }
 }
 
+// ── 퍼시스턴트 메모리 ─────────────────────────────────────────────────────
+// /new 로 세션을 초기화해도 유지되는 메모리. runClaude 시 시스템 프롬프트에 주입.
+function loadMemory() {
+  try { return readFileSync(MEMORY_PATH, "utf8").trim(); } catch { return ""; }
+}
+function saveMemory(content) {
+  writeFileSync(MEMORY_PATH, content);
+}
+
 // ── 상태 (세션 이어가기용) ────────────────────────────────────────────────
 function loadState() {
   // 새 경로(.claude-bot/) 우선, 없으면 구버전 루트 경로로 폴백(이주 실패 시 안전망).
@@ -429,8 +460,11 @@ function runClaude(prompt, sessionId, opts = {}) {
     const modelHint = opts.modelHint
       ? `Current model: ${model || "claude (default)"}. Model tiers (low→high): haiku → sonnet → opus → fable. If this question seems to require more capability than the current model, append one short line at the very end of your reply: 💡 \`/model sonnet\` (or \`/model opus\`, \`/model fable\`) for a stronger answer. Omit the suggestion for simple questions.`
       : null;
-    // 페르소나(cfg.persona) + 간결 지침 + 모델 힌트를 함께 주입 → 멀티 봇(역할별) 운영용
-    const appendSys = [cfg.persona, brevity, modelHint].filter(Boolean).join("\n\n");
+    // opts.injectMemory: 퍼시스턴트 메모리를 시스템 프롬프트에 주입 (/new 로 초기화해도 유지)
+    const mem = opts.injectMemory ? loadMemory() : "";
+    const memoryBlock = mem ? `## Persistent memory (survives /new)\n${mem}` : null;
+    // 페르소나(cfg.persona) + 간결 지침 + 모델 힌트 + 메모리를 함께 주입
+    const appendSys = [cfg.persona, brevity, modelHint, memoryBlock].filter(Boolean).join("\n\n");
     if (appendSys) args.push("--append-system-prompt", appendSys);
     if (model) args.push("--model", model);
     if (sessionId) args.push("--resume", sessionId);
@@ -820,6 +854,25 @@ async function handle(msg) {
     await send(chatId, t(l, reset ? "stopReset" : "stopOk"));
     return;
   }
+  if (text.startsWith("/remember ")) {
+    const content = text.slice(10).trim();
+    if (!content) { await send(chatId, t(l, "rememberUsage")); return; }
+    const existing = loadMemory();
+    saveMemory(existing ? `${existing}\n- ${content}` : `- ${content}`);
+    await send(chatId, t(l, "remembered"));
+    return;
+  }
+  if (text === "/memory" || text.startsWith("/memory ")) {
+    const arg = text.slice(7).trim();
+    if (arg === "clear") {
+      saveMemory("");
+      await send(chatId, t(l, "memoryCleared"));
+      return;
+    }
+    const mem = loadMemory();
+    await send(chatId, mem ? t(l, "memoryShow", mem) : t(l, "memoryEmpty"));
+    return;
+  }
 
   if (busy) {
     msgQueue.push({ msg, receivedAt: Date.now() });
@@ -854,7 +907,7 @@ async function handle(msg) {
       }
     }
     prevSessionId = state.sessionId; // /stop --reset 복원 대상 저장
-    const res = await runClaude(prompt, state.sessionId, { modelHint: true, trackChild: true });
+    const res = await runClaude(prompt, state.sessionId, { modelHint: true, trackChild: true, injectMemory: true });
     if (res.sessionId) {
       state.sessionId = res.sessionId;
       saveState(state);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-telegram-bot",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Drive Claude Code from Telegram — messages run headless `claude -p` in a project dir and replies come back to the chat. Zero dependencies.",
   "type": "module",
   "bin": {