/install neshama-soul
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(推荐):
- 访问 https://neshama.pw/register
- 注册账号
- 在个人中心获取 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 五维模型
| 维度 | 说明 | 高分特征 | 低分特征 |
|---|---|---|---|
| Openness | 开放性 | 创意、好奇 | 保守、传统 |
| Conscientiousness | 尽责性 | 可靠、有条理 | 随意、松散 |
| Extraversion | 外向性 | 外向、活跃 | 内向、安静 |
| Agreeableness | 宜人性 | 合作、信任 | 竞争、怀疑 |
| Neuroticism | 神经质 | 情绪化、敏感 | 稳定、冷静 |
人格预设
| 预设 | 描述 | 适用场景 |
|---|---|---|
balanced |
均衡型 | 通用开发 |
creative |
创意型 | 前端设计、创新项目 |
precise |
精确型 | 后端开发、代码审查 |
mentor |
导师型 | 代码讲解、教学 |
efficient |
高效型 | 快速迭代、敏捷开发 |
情绪模型
基于 Russell 的 Valence-Arousal 模型:
- Valence (效价): -1.0 (负面) ~ +1.0 (正面)
- Arousal (唤醒度): 0.0 (平静) ~ 1.0 (兴奋)
支持的情绪状态:
happy | excited | calm | sad | angry | fearful | surprised | neutral
API 规格
| 项目 | 值 |
|---|---|
| 端点 | POST https://api.neshama.pw/v1/soul/compute |
| 认证 | X-API-Key Header |
| 超时 | 5 秒 |
限流说明
| Key 类型 | 每日限制 | 说明 |
|---|---|---|
| 公共 Key | 1000 次/天 | 公测期间,正式版会更严格 |
| 个人 Key | 根据套餐 | 注册后可见具体限制 |
错误处理
当 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.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install neshama-soul - 安装完成后,直接呼叫该 Skill 的名称或使用
/neshama-soul触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Neshama Soul Skill 是什么?
基于 OCEAN 和 Valence-Arousal 模型,注入独特人格与情绪,生成个性化 AI 行为和对话上下文提示词。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 59 次。
如何安装 Neshama Soul Skill?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install neshama-soul」即可一键安装,无需额外配置。
Neshama Soul Skill 是免费的吗?
是的,Neshama Soul Skill 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Neshama Soul Skill 支持哪些平台?
Neshama Soul Skill 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Neshama Soul Skill?
由 Neshama(@neshama-ai)开发并维护,当前版本 v1.0.1。