discord-soul

🧠 Discord 社区灵魂化与记忆引擎

🥥40总安装量 12评分人数 13
100% 的用户推荐

OpenClaw 官方技能,通过多层安全过滤将 Discord 历史转化为具记忆的社区 AI Agent,让服务器拥有可对话的灵魂与文化传承。

S

安全性较高,可在多数场景中优先使用

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ <br/>**多层安全防御体系**:采用 Regex 预过滤(25+ 种攻击模式)+ Claude Haiku 语义评估(风险评分 0.0-1.0)的双重防护,有效防范提示注入、角色劫持和越狱攻击
  • ✅ <br/>**代码安全规范**:无 eval/exec/system 等危险函数,SQLite 使用参数化查询防注入,Shell 脚本变量正确引用,通过静态代码安全审计
  • ✅ <br/>**数据主权保障**:纯本地处理流程(除 Haiku 安全评估外),用户完全控制数据,无静默上传或第三方数据收集
  • ⚠️ <br/>**凭证管理责任**:需用户自行提供并保管 Discord Token 和 Anthropic API Key,泄露可能导致账户风险
  • ⚠️ <br/>**API 调用成本**:安全过滤需消耗 Haiku API(约 $0.25/1M tokens),大规模数据处理需考虑成本预算

使用说明

核心用法

discord-soul 通过一套完整的管道将 Discord 服务器历史转化为具有持续记忆能力的 AI Agent。首先使用 DiscordChatExporter CLI 导出服务器数据,然后通过多层安全管道处理(Regex 预过滤识别 25+ 种提示注入模式,Claude Haiku 进行语义风险评估),将清洗后的数据存入 SQLite。接着生成按日划分的记忆文件,并按时间顺序模拟 Agent 的"成长"过程——逐日处理消息,动态更新 SOUL.md(社区身份)、LEARNINGS.md(模式发现)、AGENTS.md(关键人物)等核心文件,最终在 OpenClaw 框架中部署为可对话的社区灵魂。

显著优点

1. 真正的长期记忆架构:不同于简单的 RAG 检索,该 Skill 通过每日记忆文件和身份演化机制,让 Agent 真正"经历"社区历史,记住内部笑话、文化变迁和关键决策时刻。

2. 业界领先的安全设计:针对 Discord 场景特化的多层防御(Regex 快速过滤 + Haiku 语义评估),能有效拦截提示注入、角色劫持和越狱攻击,确保不可信的用户生成内容不会污染 Agent 提示词。

3. 丰富的社交信号捕获:不仅保存消息文本,还捕获反应表情(🔥 x5)、角色颜色、频道主题、回复线程等元数据,使 Agent 能准确理解社区氛围和人际关系。

4. 持续演化能力:通过 Cron 定时任务支持每日增量更新,Agent 会随社区成长持续学习,保持记忆的新鲜度。

潜在缺点与局限性

1. 技术门槛较高:需要用户熟悉 CLI 工具、配置 Discord Token、Anthropic API Key,并设置 Cron 定时任务,对非技术用户不够友好。

2. 使用成本:虽然本体免费,但 Haiku 安全评估需要消耗 API 调用(约 $0.25/1M tokens),大型社区的历史数据处理可能产生一定费用。

3. 外部依赖强:必须配合 DiscordChatExporter 工具使用,且该工具需要用户自行获取 Discord Token,流程较为繁琐。

4. 只读局限:当前版本主要支持问答和记忆检索,无法执行实际的 Discord 操作(如发送消息、管理频道等)。

适合的目标群体

  • 大型 Discord 社区管理员:需要沉淀社区知识、回答重复性问题("上周我们讨论了什么?"、"谁是某领域专家?")。
  • 社区运营团队:希望分析社区文化演变、识别关键贡献者、保存内部梗和历史决策。
  • 在线社区研究者:需要分析社交网络演变、语言模式变化的研究者。
  • 数字档案馆员:希望为活跃的 Discord 社区建立可查询的历史记忆库。

使用风险

1. 凭证泄露风险:Discord Token 和 Anthropic API Key 需妥善保管,建议使用 600 权限存储 Token 文件。

2. 历史数据敏感:尽管有安全过滤,导出的历史消息可能包含个人隐私信息,需在合规前提下使用。

3. 提示注入残余风险:多层过滤可大幅降低风险,但面对精心构造的对抗性样本仍可能存在漏网之鱼,不建议直接用于处理来自完全不可信来源的 Discord 导出数据。

4. 存储与性能:大型服务器(数十万条消息)的 SQLite 数据库和每日记忆文件可能占用较大磁盘空间,模拟成长过程也需要较长的处理时间。

discord-soul 内容

文件夹图标references文件夹
文件夹图标scripts文件夹
文件夹图标templates文件夹
手动下载zip · 33.7 kB
lancedb.mdtext/markdown
请选择文件