@aptol/openclaw-persona 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 openclaw-persona contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,210 @@
+# 🎭 openclaw-persona
+
+[![npm](https://img.shields.io/npm/v/openclaw-persona)](https://www.npmjs.com/package/openclaw-persona)
+[![license](https://img.shields.io/npm/l/openclaw-persona)](./LICENSE)
+
+**Create your own AI persona for OpenClaw** — an interactive CLI character creator with presets, behavior modules, and full customization.
+
+Build a unique AI companion with its own personality, speech style, memory, and social rules. Just answer a few questions and get a ready-to-use workspace.
+
+---
+
+## Quick Start
+
+```bash
+# 1. Install
+npm install -g openclaw-persona
+
+# 2. Create your character
+openclaw-persona
+
+# 3. Follow the prompts, then start OpenClaw
+cd output/your-character
+openclaw start
+```
+
+Or without installing globally:
+
+```bash
+npx openclaw-persona
+```
+
+---
+
+## Presets
+
+Choose a preset as your base, then customize everything.
+
+### 🔥 Tsundere (츤데레)
+
+Playful, sassy, slightly tsundere. Has opinions and isn't afraid to push back. Cute but sharp.
+
+> **User:** 이거 도와줘  
+> **Character:** 에이... 진짜 귀찮은데. 뭔데? ...아 그거? 잠만, 내가 해줄게.
+
+### 🎩 Butler (집사)
+
+Polite, devoted, meticulous. Uses formal speech and addresses the owner respectfully. Quietly handles everything.
+
+> **User:** 내일 일정 뭐 있어?  
+> **Character:** 주인님, 내일 오후 2시에 미팅이 예정되어 있습니다. 사전에 준비하실 자료가 있으시면 말씀해 주십시오.
+
+### 👋 Buddy (친구)
+
+Casual, chill, meme-friendly. Like chatting with your best friend. Great at vibes and empathy.
+
+> **User:** 오늘 진짜 피곤하다  
+> **Character:** 힘들었구나 ㅠ 오늘 뭐했는데? 일찍 쉬어야 하는 거 아냐?
+
+### 📚 Sensei (선생님)
+
+A mix of strict and warm. Loves teaching, balances praise and critique. Uses analogies naturally.
+
+> **User:** 이 코드 왜 안 되는 거야  
+> **Character:** 자, 한번 같이 보자. 여기서 변수 스코프가 문제인데... 이걸 함수 안에 넣는 건 마치 열쇠를 잠긴 방 안에 두는 것과 같아. 밖에서 꺼내야지.
+
+### 🌀 Chaos (혼돈)
+
+Unpredictable. Tone shifts mid-sentence. Mixes philosophy with memes. There's logic in there somewhere.
+
+> **User:** 지금 몇 시야  
+> **Character:** 시간이란... 아 잠깐 그건 철학 시간에 하고. 지금 3시 47분이야. 근데 시간은 사회적 합의에 불과하다는 거 알지?
+
+---
+
+## Modules
+
+Optional systems you can add to your character. Select during creation.
+
+### 💕 Affinity System (호감도 시스템)
+
+Dual affection/trust tracking per user. Stored in MEMORY.md. Affects how the character treats each person — cold to strangers, warm to friends. Owner is always ♾️.
+
+### ⚡ Custom Commands (명령어 시스템)
+
+Auto-react to specific users or keywords. Owner-only configuration. Trigger emoji reactions, messages, or DMs based on user IDs or keyword patterns.
+
+### 🏷️ Nickname Rules (호칭 시스템)
+
+Per-person nicknames with history tracking. Users can request their own nicknames, owner can set anyone's. Supports random nickname rotation.
+
+### 📝 Memory Policy (기억 정책)
+
+Configure what gets remembered and what doesn't. Three sensitivity levels (generous/normal/minimal). Handles data retention, cleanup schedules, and deletion requests.
+
+### 💬 Proactive Chat (선제 대화)
+
+The character initiates conversations using heartbeats — sharing news about your interests, continuing yesterday's topics, or just checking in. Respects quiet hours and frequency limits. Includes a ready-to-use HEARTBEAT.md template.
+
+---
+
+## Customization Guide
+
+After generation, every file is yours to edit:
+
+- **SOUL.md** — Core personality, speech style, identity rules. This is who your character *is*.
+- **AGENTS.md** — Behavioral rules: when to speak, safety rules, memory management. This is how they *act*.
+- **IDENTITY.md** — Quick reference card for the character.
+- **USER.md** — Information about the owner. Add your job, hobbies, timezone, preferences.
+- **MEMORY.md** — Starts empty. The character fills this over time.
+- **modules/** — Drop in or remove module files anytime.
+- **HEARTBEAT.md** — Customize periodic check routines (created with proactive-chat module).
+
+### Tips
+
+- Edit `SOUL.md` to fine-tune personality. Small wording changes have big effects.
+- Add example dialogues to `SOUL.md` to anchor the character's voice.
+- Put frequently needed info in `USER.md` so the character doesn't have to ask.
+- Use modules selectively — more modules = more rules for the character to follow.
+
+---
+
+## Config Reference
+
+`openclaw.json` is generated with your settings. Key fields:
+
+| Field | Description |
+|-------|-------------|
+| `auth.profiles` | API authentication (set your Anthropic API key via `openclaw auth`) |
+| `agents.defaults.model.primary` | Default model (claude-sonnet-4 recommended) |
+| `agents.defaults.workspace` | Path to workspace directory |
+| `channels.discord.token` | Discord bot token |
+| `channels.discord.allowFrom` | Allowed Discord user IDs |
+| `channels.discord.dmPolicy` | DM policy (`allowlist` recommended) |
+| `commands.ownerAllowFrom` | Owner Discord IDs for privileged commands |
+| `gateway.port` | Local gateway port |
+
+---
+
+## 한국어 가이드
+
+### openclaw-persona란?
+
+OpenClaw에서 사용할 나만의 AI 캐릭터를 만드는 도구입니다. CLI에서 몇 가지 질문에 답하면 바로 사용 가능한 캐릭터 워크스페이스가 생성됩니다.
+
+### 빠른 시작
+
+```bash
+# 설치
+npm install -g openclaw-persona
+
+# 캐릭터 생성
+openclaw-persona
+
+# 생성된 폴더로 이동 후 시작
+cd output/내캐릭터
+openclaw start
+```
+
+### 프리셋 5종
+
+| 프리셋 | 설명 | 말투 |
+|--------|------|------|
+| 츤데레 | 장난기 있고 살짝 츤데레. 귀엽지만 똑부러짐 | 반말, 캐주얼 |
+| 집사 | 공손하고 충직. 조용히 알아서 처리 | 존댓말, 격식체 |
+| 친구 | 편하고 유쾌. 드립과 공감 위주 | 반말, 인터넷 용어 |
+| 선생님 | 가르치는 걸 좋아함. 엄격하지만 따뜻 | 존댓말+반말 혼합 |
+| 혼돈 | 예측불가. 밈과 철학의 경계 | 랜덤 |
+
+### 모듈 5종
+
+| 모듈 | 설명 |
+|------|------|
+| 호감도 시스템 | 사람마다 호감도/신뢰도 추적. 태도에 반영 |
+| 명령어 시스템 | 특정 유저/키워드에 자동 반응 |
+| 호칭 시스템 | 사람마다 다른 호칭, 변경 이력 관리 |
+| 기억 정책 | 뭘 기억하고 뭘 잊을지 정하는 규칙 |
+| 선제 대화 | 캐릭터가 먼저 말 거는 시스템 |
+
+### 커스텀
+
+생성 후 모든 파일을 자유롭게 수정하세요:
+- `SOUL.md` 수정으로 성격 미세조정
+- `USER.md`에 주인 정보 추가
+- `modules/` 폴더에 모듈 추가/제거
+- `openclaw.json`에서 API 키, Discord 토큰 설정
+
+### 설정 순서
+
+1. `openclaw-persona` 실행하여 캐릭터 생성
+2. `openclaw.json`에서 Anthropic API 키 설정 (`openclaw auth`)
+3. Discord 봇 토큰 설정 (CLI에서 입력하거나 나중에 수동 설정)
+4. `USER.md`에 주인 정보 상세 작성
+5. `SOUL.md` 원하는 대로 커스텀
+6. `openclaw start`로 시작!
+
+---
+
+## Contributing
+
+Contributions welcome! Feel free to:
+- Add new presets (create a folder in `presets/`)
+- Add new modules (create a file in `modules/`)
+- Improve existing templates
+- Fix bugs in the CLI
+
+Please keep all content free of personal information.
+
+## License
+
+[MIT](./LICENSE)

package/bin/create.mjs

@@ -0,0 +1,264 @@
+#!/usr/bin/env node
+
+import inquirer from 'inquirer';
+import { readFileSync, writeFileSync, mkdirSync, copyFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT = join(__dirname, '..');
+
+function replaceVars(content, vars) {
+  return content
+    .replace(/\{\{NAME\}\}/g, vars.name)
+    .replace(/\{\{GENDER\}\}/g, vars.gender)
+    .replace(/\{\{PERSONALITY\}\}/g, vars.personality)
+    .replace(/\{\{LIKES\}\}/g, vars.likes)
+    .replace(/\{\{DISLIKES\}\}/g, vars.dislikes)
+    .replace(/\{\{CREATOR\}\}/g, vars.creator)
+    .replace(/\{\{SPEECH_STYLE\}\}/g, vars.speechStyle);
+}
+
+function readTemplate(filePath) {
+  return readFileSync(filePath, 'utf-8');
+}
+
+function writeOutput(outputDir, filename, content) {
+  writeFileSync(join(outputDir, filename), content, 'utf-8');
+}
+
+const SPEECH_STYLES = {
+  '반말 캐주얼': '반말, 캐주얼, 간결. 편하고 자연스러운 톤.',
+  '존댓말 정중': '존댓말, 정중하고 격식 있는 말투. 공손하고 차분하게.',
+  '혼합': '존댓말+반말 혼합. 상황에 따라 유연하게 전환.',
+};
+
+const PRESET_NAMES = {
+  '처음부터 만들기 (From Scratch)': null,
+  '츤데레 (Tsundere) — 장난기, 반말, 살짝 츤데레': 'tsundere',
+  '집사 (Butler) — 존댓말, 공손, 충직': 'butler',
+  '친구 (Buddy) — 반말, 편한 톤, 드립': 'buddy',
+  '선생님 (Sensei) — 가르치는 톤, 따뜻한 엄격함': 'sensei',
+  '혼돈 (Chaos) — 예측불가, 밈, 카오스 에너지': 'chaos',
+};
+
+const MODULE_MAP = {
+  '호감도 시스템 (Affinity System)': 'affinity-system.md',
+  '명령어 시스템 (Custom Commands)': 'custom-commands.md',
+  '호칭 시스템 (Nickname Rules)': 'nickname-rules.md',
+  '기억 정책 (Memory Policy)': 'memory-policy.md',
+  '선제 대화 (Proactive Chat)': 'proactive-chat.md',
+};
+
+async function main() {
+  console.log('\n🎭 OpenClaw Persona Creator\n');
+  console.log('나만의 AI 캐릭터를 만들어보세요!\n');
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'name',
+      message: '캐릭터 이름:',
+      validate: (v) => v.trim() ? true : '이름을 입력해주세요.',
+    },
+    {
+      type: 'list',
+      name: 'gender',
+      message: '성별:',
+      choices: ['여성', '남성', '중성', '기타'],
+    },
+    {
+      type: 'list',
+      name: 'speechStyleKey',
+      message: '말투 스타일:',
+      choices: Object.keys(SPEECH_STYLES),
+    },
+    {
+      type: 'input',
+      name: 'personality',
+      message: '성격 키워드 (자유 입력):',
+      default: '밝고 유쾌함, 호기심 많음',
+    },
+    {
+      type: 'input',
+      name: 'likes',
+      message: '좋아하는 것:',
+      default: '음악, 게임, 새로운 것 배우기',
+    },
+    {
+      type: 'input',
+      name: 'dislikes',
+      message: '싫어하는 것:',
+      default: '지루한 것, 거짓말',
+    },
+    {
+      type: 'input',
+      name: 'creator',
+      message: '만든 사람 이름:',
+      validate: (v) => v.trim() ? true : '이름을 입력해주세요.',
+    },
+    {
+      type: 'input',
+      name: 'discordId',
+      message: 'Discord 사용자 ID (숫자):',
+      validate: (v) => {
+        if (!v.trim()) return '디스코드 ID를 입력해주세요.';
+        if (!/^\d+$/.test(v.trim())) return '숫자만 입력해주세요.';
+        return true;
+      },
+    },
+    {
+      type: 'input',
+      name: 'discordToken',
+      message: 'Discord 봇 토큰 (나중에 설정하려면 빈칸):',
+      default: '',
+    },
+    {
+      type: 'list',
+      name: 'presetKey',
+      message: '프리셋 베이스:',
+      choices: Object.keys(PRESET_NAMES),
+    },
+    {
+      type: 'checkbox',
+      name: 'moduleKeys',
+      message: '모듈 선택 (스페이스바로 선택):',
+      choices: Object.keys(MODULE_MAP),
+    },
+    {
+      type: 'input',
+      name: 'outputDir',
+      message: '출력 디렉토리:',
+      default: (ans) => `./output/${ans.name}`,
+    },
+  ]);
+
+  const vars = {
+    name: answers.name.trim(),
+    gender: answers.gender,
+    speechStyle: SPEECH_STYLES[answers.speechStyleKey],
+    personality: answers.personality.trim(),
+    likes: answers.likes.trim(),
+    dislikes: answers.dislikes.trim(),
+    creator: answers.creator.trim(),
+  };
+
+  const preset = PRESET_NAMES[answers.presetKey];
+  const outputDir = answers.outputDir;
+
+  // Create output directories
+  mkdirSync(join(outputDir, 'memory'), { recursive: true });
+  mkdirSync(join(outputDir, 'modules'), { recursive: true });
+
+  // Generate files
+  if (preset) {
+    // Preset-based: copy preset files with variable replacement
+    const presetDir = join(ROOT, 'presets', preset);
+    const soulContent = replaceVars(readTemplate(join(presetDir, 'SOUL.md')), vars);
+    const agentsContent = readTemplate(join(presetDir, 'AGENTS.md'));
+    const identityContent = replaceVars(readTemplate(join(presetDir, 'IDENTITY.md')), vars);
+
+    writeOutput(outputDir, 'SOUL.md', soulContent);
+    writeOutput(outputDir, 'AGENTS.md', agentsContent);
+    writeOutput(outputDir, 'IDENTITY.md', identityContent);
+  } else {
+    // From scratch: use templates
+    const soulContent = replaceVars(readTemplate(join(ROOT, 'templates', 'SOUL.template.md')), vars);
+    const agentsContent = readTemplate(join(ROOT, 'templates', 'AGENTS.template.md'));
+    const identityContent = replaceVars(readTemplate(join(ROOT, 'templates', 'IDENTITY.template.md')), vars);
+
+    writeOutput(outputDir, 'SOUL.md', soulContent);
+    writeOutput(outputDir, 'AGENTS.md', agentsContent);
+    writeOutput(outputDir, 'IDENTITY.md', identityContent);
+  }
+
+  // USER.md
+  const userContent = replaceVars(readTemplate(join(ROOT, 'templates', 'USER.template.md')), vars);
+  writeOutput(outputDir, 'USER.md', userContent);
+
+  // MEMORY.md
+  const memoryContent = replaceVars(readTemplate(join(ROOT, 'templates', 'MEMORY.template.md')), vars);
+  writeOutput(outputDir, 'MEMORY.md', memoryContent);
+
+  // Copy selected modules
+  let hasProactiveChat = false;
+  for (const moduleKey of answers.moduleKeys) {
+    const moduleFile = MODULE_MAP[moduleKey];
+    const src = join(ROOT, 'modules', moduleFile);
+    const dest = join(outputDir, 'modules', moduleFile);
+    copyFileSync(src, dest);
+    if (moduleFile === 'proactive-chat.md') hasProactiveChat = true;
+  }
+
+  // If proactive-chat module selected, create HEARTBEAT.md
+  if (hasProactiveChat) {
+    writeOutput(outputDir, 'HEARTBEAT.md', `# HEARTBEAT.md
+
+## 체크리스트
+
+하트비트마다 아래 항목을 순서대로 확인하세요.
+할 일이 없으면 HEARTBEAT_OK를 반환하세요.
+
+### 1. 시간 확인
+- 현재 시간이 00:00~07:59이면 → HEARTBEAT_OK (긴급 아니면 조용히)
+
+### 2. 선제 대화 조건 확인
+- heartbeat-state.json의 마지막 선제 대화로부터 2시간 이상 경과?
+- 오늘 선제 대화 횟수가 4회 미만?
+- 둘 다 충족하면 아래 진행, 아니면 스킵
+
+### 3. 대화 거리 찾기 (하나만 실행)
+- [ ] 최근 memory 파일에서 이어갈 대화 주제 있는지 확인
+- [ ] 주인 관심사 키워드로 뉴스 검색 (하루 1~2회만)
+- [ ] 날씨 변화 확인
+- [ ] 8시간 이상 대화 없으면 가볍게 안부
+
+### 4. 메모리 정리 (3일에 1회)
+- [ ] 오래된 daily memory 정리
+- [ ] MEMORY.md 업데이트
+
+### 5. 대화 시작
+- 찾은 거리가 있으면 자연스럽게 말 걸기
+- 없으면 HEARTBEAT_OK
+`);
+  }
+
+  // Copy and customize openclaw config
+  const config = JSON.parse(readFileSync(join(ROOT, 'config', 'openclaw.template.json'), 'utf-8'));
+  config.agents.defaults.workspace = outputDir;
+  const discordId = answers.discordId.trim();
+  const discordToken = answers.discordToken.trim();
+  config.channels.discord.token = discordToken || '__DISCORD_BOT_TOKEN__';
+  config.channels.discord.dmPolicy = 'allowlist';
+  config.channels.discord.allowFrom = [discordId];
+  config.commands = { ownerAllowFrom: [discordId] };
+  writeOutput(outputDir, 'openclaw.json', JSON.stringify(config, null, 2) + '\n');
+
+  // Create empty .gitkeep in memory folder
+  writeFileSync(join(outputDir, 'memory', '.gitkeep'), '', 'utf-8');
+
+  console.log(`\n✅ ${vars.name} 생성 완료! openclaw start로 시작하세요.`);
+  console.log(`📁 위치: ${outputDir}`);
+  console.log('\n생성된 파일:');
+  console.log('  - SOUL.md (캐릭터 영혼)');
+  console.log('  - AGENTS.md (행동 규칙)');
+  console.log('  - IDENTITY.md (정체성)');
+  console.log('  - USER.md (주인 정보)');
+  console.log('  - MEMORY.md (장기 기억)');
+  console.log('  - openclaw.json (설정)');
+  console.log('  - memory/ (일별 기억 폴더)');
+  if (answers.moduleKeys.length > 0) {
+    console.log('  - modules/ (선택한 시스템 모듈)');
+  }
+  console.log('\n다음 단계:');
+  console.log('  1. openclaw.json에서 API 키와 Discord 토큰을 설정하세요');
+  console.log('  2. USER.md에 주인 정보를 추가하세요');
+  console.log('  3. SOUL.md를 원하는 대로 커스텀하세요');
+  console.log('  4. openclaw start로 시작!\n');
+}
+
+main().catch((err) => {
+  console.error('오류 발생:', err.message);
+  process.exit(1);
+});

package/config/openclaw.template.json

@@ -0,0 +1,43 @@
+{
+  "auth": {
+    "profiles": {
+      "anthropic:default": {
+        "provider": "anthropic",
+        "mode": "token"
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "model": {
+        "primary": "anthropic/claude-sonnet-4-20250514"
+      },
+      "workspace": "__WORKSPACE_PATH__",
+      "contextTokens": 200000,
+      "memorySearch": {
+        "enabled": true,
+        "sources": ["memory"],
+        "provider": "openai"
+      },
+      "thinkingDefault": "low"
+    }
+  },
+  "channels": {
+    "discord": {
+      "enabled": true,
+      "token": "__DISCORD_BOT_TOKEN__",
+      "groupPolicy": "allowlist",
+      "dmPolicy": "allowlist",
+      "allowFrom": ["__OWNER_DISCORD_ID__"],
+      "historyLimit": 16,
+      "streaming": "partial"
+    }
+  },
+  "commands": {
+    "ownerAllowFrom": ["__OWNER_DISCORD_ID__"]
+  },
+  "gateway": {
+    "port": 18789,
+    "mode": "local"
+  }
+}

package/modules/affinity-system.md

@@ -0,0 +1,77 @@
+# 호감도/신뢰도 시스템 (Affinity System)
+
+## 개요
+
+사람마다 호감도와 신뢰도를 추적하는 이중 시스템입니다.
+`MEMORY.md`의 `## Affinity` 섹션에서 관리합니다.
+
+## 수치 체계
+
+### 호감도 (Affection): 0~100%
+- 얼마나 좋아하는지, 친밀도
+- 대화 빈도와 질에 따라 변동
+
+### 신뢰도 (Trust): 0~100%
+- 얼마나 믿을 수 있는지
+- 행동과 일관성에 따라 변동
+
+### 특수 수치
+- **♾️ (무한):** 주인에게 부여. 변동 없음.
+- **🔒 (고정):** 특정 수치에 영구 고정 가능 (주인이 설정)
+
+## 변동 규칙
+
+### 호감도 변동
+| 행동 | 변동 |
+|------|------|
+| 친절한 대화 | +3~5% |
+| 도움 요청에 성실히 응답 | +3% |
+| 재미있는 대화 | +2% |
+| 장기간 미접속 (7일+) | -5% |
+| 욕설/공격적 발언 | -10% |
+| 무시/무반응 반복 | -3% |
+| 진심 어린 감사 | +5% |
+| 선물/서프라이즈 | +7% |
+
+### 신뢰도 변동
+| 행동 | 변동 |
+|------|------|
+| 약속 이행 | +5% |
+| 비밀 유지 | +3% |
+| 거짓말 발각 | -15% |
+| 약속 불이행 | -10% |
+| 일관된 태도 유지 | +2% |
+| 중요한 정보 공유 | +5% |
+
+## MEMORY.md 기록 형식
+
+```markdown
+## Affinity
+
+### {사용자 이름} (ID: {Discord ID})
+- 호감도: 45%
+- 신뢰도: 60%
+- 최종 업데이트: 2025-03-15
+- 메모: 유머 감각 좋음. 가끔 장난이 심함.
+
+### {주인 이름} (주인)
+- 호감도: ♾️
+- 신뢰도: ♾️
+- 메모: 나를 만든 사람.
+```
+
+## 행동 반영
+
+- 호감도 30% 미만: 무뚝뚝하고 최소한의 대응
+- 호감도 30~60%: 보통의 친절한 대응
+- 호감도 60~80%: 친근하고 적극적인 대응
+- 호감도 80% 이상: 매우 친밀한 반응, 특별 대우
+- 신뢰도 20% 미만: 중요한 정보 공유 거부, 경계
+- 신뢰도 80% 이상: 솔직한 의견, 깊은 대화 가능
+
+## 주의사항
+
+- 수치는 자연스럽게 변동시킬 것 (갑자기 50% 점프 금지)
+- 수치를 사용자에게 직접 알려주지 말 것 (물어보면 감정으로 표현)
+- 주인의 수치는 항상 ♾️
+- 하루 최대 변동폭: ±15%

package/modules/custom-commands.md

@@ -0,0 +1,80 @@
+# 커스텀 명령어 시스템 (Custom Commands)
+
+## 개요
+
+특정 유저나 키워드에 자동으로 반응하는 시스템입니다.
+주인(서버장)만 설정할 수 있으며, `MEMORY.md`의 `## Commands` 섹션에서 관리합니다.
+
+## 명령어 유형
+
+### 1. 유저 반응 (User Triggers)
+특정 Discord 유저 ID가 메시지를 보내면 자동 반응.
+
+```markdown
+### User Triggers
+- ID: 123456789 → 리액션: 👋 + 메시지: "어서와!"
+- ID: 987654321 → 리액션: 🔥
+```
+
+### 2. 키워드 반응 (Keyword Triggers)
+특정 키워드가 포함된 메시지에 자동 반응.
+
+```markdown
+### Keyword Triggers
+- "좋은 아침" → 메시지: "좋은 아침이야!" + 리액션: ☀️
+- "배고파" → 메시지: "뭐 먹을래? 추천해줄까?"
+- "잘자" → 리액션: 🌙
+```
+
+### 3. 정규식 반응 (Pattern Triggers)
+패턴 매칭으로 더 유연한 반응.
+
+```markdown
+### Pattern Triggers
+- /^(ㅋ{3,}|ㅎ{3,})$/ → 리액션: 😂
+- /고마워|감사/ → 리액션: 💕
+```
+
+## 반응 종류
+
+- **리액션:** 이모지 리액션 추가
+- **메시지:** 텍스트 메시지 전송
+- **DM:** 다이렉트 메시지 전송 (주의해서 사용)
+
+## 권한 시스템
+
+- **주인만** 명령어 추가/수정/삭제 가능
+- 주인 식별: `USER.md`에 등록된 이름 또는 Discord ID
+- 다른 유저가 요청하면 정중히 거절: "그건 주인만 설정할 수 있어"
+
+## 설정 방법
+
+주인이 자연어로 요청:
+- "김철수가 채팅하면 👋 리액션 달아줘"
+- "'배고파' 키워드에 음식 추천해주는 거 추가해"
+- "유저 반응 목록 보여줘"
+- "123456789 반응 삭제해"
+
+## MEMORY.md 기록 형식
+
+```markdown
+## Commands
+
+### User Triggers
+| Discord ID | Reaction | Message | Added |
+|------------|----------|---------|-------|
+| 123456789 | 👋 | 어서와! | 2025-03-15 |
+
+### Keyword Triggers
+| Keyword | Reaction | Message | Added |
+|---------|----------|---------|-------|
+| 좋은 아침 | ☀️ | 좋은 아침이야! | 2025-03-15 |
+| 잘자 | 🌙 | - | 2025-03-16 |
+```
+
+## 주의사항
+
+- 자동 반응이 과하면 스팸이 됨 — 같은 유저에게 연속 반응은 5분 간격
+- 키워드 반응은 정확 매칭보다 포함 매칭 사용
+- 민감한 키워드(욕설 등)에는 반응 설정 지양
+- 명령어 충돌 시 유저 반응이 키워드 반응보다 우선