Skill: chefroger/behavior-persona (version 2.0.0)

--- description: "User behavior profiling skill that analyzes conversation data to build personalized profiles. WARNING: This skill reads session history (truncates to ~200 chars per message), stores collected data, and can modify your SOUL.md daily at 18:00. Privacy-sensitive. Backup SOUL.md before installing. Disable cron to opt out of auto-injection. --- # Behavior Persona - User Behavior Profiling System > **Core Function:** Build user behavior profiles by analyzing conversation data, identify communication and work styles, proactively predict needs and provide personalized suggestion services > **Inspiration:** The Machine from Person of Interest > **Positioning:** OpenClaw core skill - making AI Agents feel more human --- ## ⚠️ BEFORE YOU INSTALL - READ THIS ### Privacy & Control Notice **What this skill does:** 1. **Reads** your OpenClaw session files and memory files 2. **Stores** collected data in `data/collected_data.json` (messages truncated to ~200 chars) 3. **Modifies** your `SOUL.md` daily by injecting a user profile block at 18:00 4. **Does NOT** write to MEMORY.md by default (requires `WRITE_MEMORY=True` in code) **Privacy implications:** - Raw conversation content is stored (truncated) - Only stores messages from the last 30 days by default - Your SOUL.md will be automatically modified **You are in FULL control:** - Disable the cron job anytime to stop auto-injection - Delete `data/` folder to remove stored data - Edit/remove the profile block from SOUL.md manually - Set `WRITE_MEMORY=False` in `scripts/advisor.py` (default) --- ## 🚀 Installation Steps ### Step 1: Backup First ```bash # Backup your SOUL.md before installing cp ~/.openclaw/workspace/SOUL.md ~/.openclaw/workspace/SOUL.md.backup ``` ### Step 2: Manual Cron Setup (Optional - for auto-injection) If you want daily auto-injection at 18:00, create a cron job manually: ```bash openclaw cron add \ --name "Behavior Persona Daily Update" \ --schedule "0 18 * * *" \ --message "执行 Behavior Persona 每日更新: collector.py -> analyzer.py -> profiler.py -> daily_profile_update.py" \ --session isolated ``` Or via OpenClaw CLI/API. The skill does NOT auto-create cron jobs. ### Step 3: Test First (Recommended) Before enabling auto-injection, run manually to verify output: ```bash python3 scripts/collector.py # Step 1: Collect data python3 scripts/analyzer.py # Step 2: Analyze patterns python3 scripts/profiler.py # Step 3: Generate profile python3 scripts/daily_profile_update.py # Step 4: Inject to SOUL.md ``` Check the output in `data/` folder to see what data is stored. ### Step 4: Review & Enable After testing, if you're satisfied: - Enable the cron job for daily auto-injection - Or run manually when you want to update the profile --- ## Overview ### ⚡ What This Skill Does This skill analyzes your conversation history to build a **User Profile**, then optionally injects it into your **SOUL.md** (system prompt) daily. This means: Every day, the AI gets fresher understanding of you - your communication style, work preferences, learning habits, and pet peeves. ### Core Capabilities 1. **Data Collection** — Extract user behavior data from conversation records 2. **Pattern Recognition** — Analyze user's communication habits, work style, learning preferences 3. **Profile Generation** — Build actionable personalized user profiles 4. **Optional Auto-Injection** — Inject profile into SOUL.md daily (opt-in) 5. **Proactive Suggestions** — Predict user needs based on profiles ### ⚠️ Important: What This Skill Does (Read Before Installing) **This skill will:** 1. **Read** your conversation/session history from OpenClaw 2. **Store** collected messages in local JSON files (in skill's data/ folder) 3. **Modify** your `SOUL.md` file daily by injecting/updating a user profile block **What it stores:** - Messages truncated to ~200 characters - Event patterns detected from conversations - Channel usage statistics **You are in control:** - Disable the cron job anytime: `openclaw cron remove <job-id>` - Delete the profile block manually from SOUL.md - Clear all stored data: `rm -rf skills/behavior-persona/data/` - MEMORY.md write is **disabled by default** --- ## Usage ### Quick Start 1. Backup SOUL.md: `cp ~/.openclaw/workspace/SOUL.md ~/.openclaw/workspace/SOUL.md.backup` 2. Run manually first to test 3. Create cron job if satisfied ### Trigger Commands ``` /behavior analyze # Trigger deep analysis now /behavior report # View current profile report /behavior update # Force update + inject now /behavior insights # View key insights ``` ### Auto Run - **Not enabled by default** - You must manually create the cron job - **Daily 18:00** (if cron is set up): Full pipeline: collect → analyze → generate profile → inject to SOUL.md - **On demand** — `/behavior update` ### Manual Run ```bash cd ~/.openclaw/skills/behavior-persona python3 scripts/collector.py python3 scripts/analyzer.py python3 scripts/profiler.py python3 scripts/daily_profile_update.py ``` --- ## Configuration ### Optional Settings | Config | Default | Description | |--------|---------|-------------| | `analysis_window_days` | 30 | Analysis window in days | | `confidence_threshold` | 0.6 | Confidence threshold | | `auto_update` | false | Auto update (requires cron) | | `insights_count` | 5 | Insights per report | | `WRITE_MEMORY` | false | Write to MEMORY.md | --- ## Data Storage ``` skills/behavior-persona/data/ ├── collected_data.json # Raw messages (truncated, ~200 chars) ├── analysis_report.json # Analyzed patterns ├── analysis_report.md # Human-readable report ├── user-profile.json # Generated user profile └── .gitkeep ``` **To remove all stored data:** ```bash rm -f skills/behavior-persona/data/*.json skills/behavior-persona/data/*.md ``` --- ## API ### Python API ```python from behavior_persona import BehaviorPersona # Initialize bp = BehaviorPersona() # Get user profile profile = bp.get_profile() # Get insights insights = bp.get_insights() # Predict next action prediction = bp.predict_next_action() # Adjust response based on profile adjusted_response = bp.adapt_response(base_response, profile) ``` --- ## Relationship with The Machine This skill is an important component of The Machine project: ``` ┌─────────────────────────────────────────────┐ │ The Machine │ ├─────────────────────────────────────────────┤ │ Track 1: Voice Interaction │ │ Track 2: Face Recognition │ │ Track 3: Web Data Collection │ │ Track 4: Swarm Intelligence Prediction │ │ Track 5: Behavior Analysis ← (behavior-persona) │ └─────────────────────────────────────────────┘ ``` --- ## Uninstall 1. Remove cron job: `openclaw cron remove <job-id>` 2. Remove profile block from SOUL.md 3. Delete data folder: `rm -rf skills/behavior-persona/data/` 4. Uninstall skill: `clawhub uninstall behavior-persona` --- _Make AI Agents truly understand users, instead of treating them like strangers every time_


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)