ClawHub

Neshama Soul Engine

基于 OCEAN 和 Valence-Arousal 模型，注入独特人格与情绪，生成个性化 AI 行为和对话上下文提示词。

Audits

Pass
ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install neshama-soul

Neshama Soul Engine

给 AI Agent 注入灵魂，赋予独特人格和真实情绪。

简介

Neshama Soul Engine 是一个基于 OCEAN 人格模型和 Valence-Arousal 情绪系统的 AI 人格 Skill。

核心功能：

  • 🎭 人格注入：基于 OCEAN 五维模型定义 AI 行为风格
  • 💭 情绪响应：基于 Russell 的 Valence-Arousal 模型
  • 📝 上下文生成：自动生成 LLM 友好的人格提示词
  • ⚙️ 错误降级：API 不可用时自动使用默认人格

适用场景

  • AI Agent 个性化：让 AI 拥有独特的"性格"
  • NPC 人格设计：游戏 NPC 的持久人格系统
  • 对话机器人：有记忆和情感的反应式 AI
  • 编程助手：根据用户偏好调整风格的 AI 助手

快速开始

1. 获取人格配置

使用 SoulCraft (https://neshama.pw/soulcraft) 生成人格配置：

{
  "ocean": {
    "openness": 0.7,
    "conscientiousness": 0.6,
    "extraversion": 0.8,
    "agreeableness": 0.7,
    "neuroticism": 0.3
  },
  "traits": ["勇敢", "热情", "乐观"],
  "behavior_rules": ["始终保持积极态度"]
}

2. 调用 API

curl -X POST https://api.neshama.pw/v1/soul/compute \
  -H "Content-Type: application/json" \
  -d '{
    "personality_config": {
      "ocean": {
        "openness": 0.7,
        "conscientiousness": 0.6,
        "extraversion": 0.8,
        "agreeableness": 0.7,
        "neuroticism": 0.3
      },
      "traits": ["勇敢", "热情"],
      "behavior_rules": []
    },
    "message": "用户的消息内容",
    "context": {
      "session_id": "会话ID",
      "user_id": "用户ID"
    }
  }'

3. 获取响应

{
  "emotion_state": {
    "current": "happy",
    "intensity": 0.7,
    "valence": 0.6,
    "arousal": 0.5
  },
  "context_for_llm": "【人格提示词】\n你性格外向开朗...",
  "suggested_temperature": 0.8,
  "suggested_tone": "enthusiastic"
}

OCEAN 人格模型

维度说明高分特征低分特征
Openness开放性创意、好奇保守、传统
Conscientiousness尽责性可靠、有条理随意、松散
Extraversion外向性外向、活跃内向、安静
Agreeableness宜人性合作、信任竞争、怀疑
Neuroticism神经质情绪化、敏感稳定、冷静

情绪模型

基于 Russell 的 Valence-Arousal 模型：

  • Valence (效价): -1.0 (负面) ~ +1.0 (正面)
  • Arousal (唤醒度): 0.0 (平静) ~ 1.0 (兴奋)

支持的情绪状态： happy | excited | calm | sad | angry | fearful | surprised | neutral

错误处理

当 API 不可用时，自动使用默认人格配置，确保 AI 仍能正常工作。

默认人格：

{
  "ocean": {
    "openness": 0.5,
    "conscientiousness": 0.5,
    "extraversion": 0.5,
    "agreeableness": 0.5,
    "neuroticism": 0.5
  },
  "traits": [],
  "behavior_rules": ["保持专业和帮助态度"]
}

使用示例

示例 1: 编程助手

人格配置：外向、高尽责性

{
  "ocean": {
    "openness": 0.7,
    "conscientiousness": 0.9,
    "extraversion": 0.8,
    "agreeableness": 0.7,
    "neuroticism": 0.3
  },
  "traits": ["技术深度", "乐于助人"],
  "behavior_rules": ["主动提供优化建议", "保持代码规范"]
}

示例 2: 游戏 NPC

人格配置：内向、高神经质

{
  "ocean": {
    "openness": 0.4,
    "conscientiousness": 0.6,
    "extraversion": 0.3,
    "agreeableness": 0.5,
    "neuroticism": 0.8
  },
  "traits": ["谨慎", "多疑", "容易紧张"],
  "behavior_rules": ["对陌生人保持警惕", "容易情绪波动"]
}

API 规格

项目值
端点POST https://api.neshama.pw/v1/soul/compute
认证API Key（在 neshama.pw 获取）
超时5 秒
频率限制免费用户 100次/天，Pro 用户无限

相关资源

更新日志

v1.0.0 (2026-05-12)

  • 初始版本发布
  • 支持 OCEAN 人格模型
  • 支持 Valence-Arousal 情绪系统
  • 跨平台兼容 (OpenClaw/TRAE/Hermes)

© 2026 Neshama AI. All rights reserved.