Neshama Soul Engine

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

简介

Neshama Soul Engine 是一个基于 OCEAN 人格模型和 Valence-Arousal 情绪系统的 AI 人格 Skill。让 AI 拥有独特的"性格"，提升 AI 输出的质量和一致性。

核心功能：

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

安装

OpenClaw

openclaw skills install neshama-soul

或搜索 "Neshama Soul Engine" 在 OpenClaw 市场安装。

手动安装

将 SKILL.md 复制到 ~/.openclaw/skills/ 目录。

快速开始

1. 获取 API Key

公共 Key（免注册）：

curl https://api.neshama.pw/v1/key/public

返回示例：

{
  "key": "nsh_public_beta_2026",
  "type": "public_beta",
  "expires": "2026-06-13",
  "limits": {
    "requests_per_day": 1000
  }
}

获取个人 Key（推荐）：

1. 访问 https://neshama.pw/register
2. 注册账号
3. 在个人中心获取 API Key

2. 调用 API

curl -X POST https://api.neshama.pw/v1/soul/compute \
  -H "Content-Type: application/json" \
  -H "X-API-Key: nsh_public_beta_2026" \
  -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": "【人格提示词】\
你性格外向开朗...",
  "suggested_temperature": 0.8,
  "suggested_tone": "enthusiastic"
}

工作流集成

在 OpenClaw 工作流中使用：

workflow:
  - name: neshama-soul
    inputs:
      personality_config: "{{personality}}"
      user_message: "{{user_input}}"
      api_key: "nsh_public_beta_2026"
    outputs:
      personality_context: "{{output.personality_context}}"
      temperature: "{{output.suggested_temperature}}"

人格配置

OCEAN 五维模型

人格预设

情绪模型

基于 Russell 的 Valence-Arousal 模型：

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

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

API 规格

限流说明

错误处理

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

相关资源

• 🌐 官网: https://neshama.pw
• 🎨 SoulCraft: https://neshama.pw/soulcraft
• 📚 API 文档: https://api.neshama.pw/docs
• 🐙 GitHub: https://github.com/Neshama-AI/neshama-soul

更新日志

v1.0.1 (2026-05-13)

• 增加 API Key 验证
• 增加 /v1/key/public 端点
• 增加 OpenClaw 工作流集成示例

v1.0.0 (2026-05-12)

• 初始版本发布
• 支持 OCEAN 人格模型
• 支持 Valence-Arousal 情绪系统

© 2026 Neshama AI. All rights reserved.