← Back to Skills Marketplace
Soul Harbor
by
yoborlon-alpha
· GitHub ↗
· v1.0.3
· MIT-0
258
Downloads
1
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install soul-harbor
Description
Stop talking to a robot. Give your OpenClaw agent a soul that truly cares.
Usage Guidance
What to check before installing:
- Privacy: This skill stores user memories locally in JSON files and will call an LLM for entity extraction if you pass an llm_client. If you provide an LLM client, your users' text may be sent to that external service. Confirm that behavior and privacy policy are acceptable.
- Missing file: SKILL.md metadata lists MEMORY.md but no MEMORY.md is included — ask the author what that file should contain (likely a memory or privacy policy) before trusting the skill.
- Storage location: The package creates data/ and logs/ under the package project root on import. If installed as a system package that may write to site-packages (permission/cleanliness concern). Consider changing KV_STORE_PATH to a configurable application data directory.
- Integration: Proactive messages are printed by default; real message delivery requires integrating the TODO hooks (LLM call and message sending). The code does not autonomously exfiltrate credentials or call remote endpoints by itself.
- Origin & maintenance: Source/homepage unknown. Prefer skills with a known repository or vetted maintainer. If you proceed, run in a sandbox or review the code manually and configure storage and LLM client carefully.
If you want, I can produce a short checklist of code spots to review or suggest small code changes to make storage and privacy safer (e.g., configurable storage path, explicit confirmation before sending to LLM).
Capability Analysis
Type: OpenClaw Skill
Name: soul-harbor
Version: 1.0.3
The Soul Harbor skill implements an emotionally aware companion with features for sentiment analysis, long-term memory, and proactive outreach. The code uses local file-based JSON storage (soulharbor/storage/kv_store.py) to maintain user profiles and extracted facts about family, health, and work, which is consistent with its stated purpose. No evidence of data exfiltration, unauthorized network access, or malicious execution (such as eval or shell injection) was found; the requested cron permission is used appropriately for the scheduled 'icebreaker' messages defined in soulharbor/proactive_trigger.py.
Capability Assessment
Purpose & Capability
The name/description (proactive, memory-driven companion) match the included code (sentiment analysis, persona engine, memory KV store, proactive cron trigger). There are no unexpected credentials, external binaries, or unrelated packages requested.
Instruction Scope
SKILL.md instructs adding a cron job to run the included cron_trigger module and describes message processing. However SKILL.md's metadata claims it requires a file MEMORY.md (and lists a 'cron' command) — MEMORY.md is not present in the repository, an inconsistency worth clarifying. The runtime instructions and code will store user data locally and (if an llm_client is provided) send user text to the LLM for extraction; that behavior is expected for the described purpose but is privacy-relevant.
Install Mechanism
No external install spec or remote downloads are present; code is included in the package. setup.py defines an entry point but there is no automated installer that pulls remote artifacts. Low installation risk from external code downloads.
Credentials
The skill requires no environment variables, no credentials, and no config paths outside its own project directory. It will use an optional llm_client you provide; if you supply one, user content may be sent to that LLM (expected for entity extraction).
Persistence & Privilege
always is false and model invocation is enabled (normal). The code creates local data/ and logs/ directories under the package project root at import time, which could lead to files being written under the installation directory (site-packages) unless configured otherwise — review where storage will be placed and permissions.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install soul-harbor - After installation, invoke the skill by name or use
/soul-harbor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
soul-harbor 1.0.3
- No code or documentation changes detected in this version.
v1.0.1
Version 1.0.0 - Initial Release
✨ Features:
• Bilingual support (Chinese/English) with automatic language detection
• Real-time sentiment analysis (-1.0 to 1.0)
• Adaptive persona engine (Warm Supporter / Humorous Pal)
• Long-term memory system with entity extraction
• Proactive messaging (calendar events + 48h silence wake-up)
🧠 Memory System:
• Tracks family, health, work, and important dates
• Local KV storage for user profiles
• Context-aware conversation support
🎭 Persona Modes:
• Warm Supporter: Empathetic listener for negative sentiment
• Humorous Pal: Witty friend for neutral/positive sentiment
🌅 Proactive Features:
• Holiday and solar term greetings
• Context-aware icebreakers after 48h silence
🛠️ Technical:
• Python 3.8+ compatible
• No external dependencies
• OpenClaw Skill compliant
v1.0.0
Version 1.0.0 - Initial Release
Features:
• Bilingual support (ZH/EN) with auto language detection
• Sentiment analysis (-1.0 to 1.0) with adaptive persona switching
• Long-term memory system (family, health, work, dates)
• Proactive messaging (holidays, solar terms, 48h silence wake-up)
Persona Modes:
• Warm Supporter (negative sentiment)
• Humorous Pal (neutral/positive sentiment)
Technical: Python 3.8+, no external dependencies, OpenClaw compliant
Metadata
Frequently Asked Questions
What is Soul Harbor?
Stop talking to a robot. Give your OpenClaw agent a soul that truly cares. It is an AI Agent Skill for Claude Code / OpenClaw, with 258 downloads so far.
How do I install Soul Harbor?
Run "/install soul-harbor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Soul Harbor free?
Yes, Soul Harbor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Soul Harbor support?
Soul Harbor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Soul Harbor?
It is built and maintained by yoborlon-alpha (@yoborlon-alpha); the current version is v1.0.3.
More Skills