Discord Soul

将你的 Discord 服务器转变为一个鲜活、自主演化的智能体。

你将获得什么

一个具备以下能力的智能体：

• 记忆：记住你在 Discord 中的所有对话
• 表达：以你社区独有的语气和风格发言
• 认知：了解关键人物、核心频道及内部梗文化
• 成长：随每日新增消息持续演化与扩展
• 应答：回答关于社区历史、文化与共识的问题

快速开始

# 基于你的 Discord 创建智能体
./scripts/create_agent.sh 
  --name "my-community" 
  --guild YOUR_GUILD_ID 
  --output ./agents/

# 配置每日自动更新
crontab -e
# 添加： 0 */3 * * * /path/to/update_agent.sh

完整流程

第 1 步：导出你的 Discord 数据

你需要 DiscordChatExporter CLI 工具。

获取你的 token：

1. 在浏览器中打开 Discord
2. 按 F12 → 切换至 Network（网络）标签页
3. 发送一条消息，定位对应请求
4. 复制 authorization 请求头的值
5. 保存至 ~/.config/discord-exporter-token

导出全部内容：

DiscordChatExporter.Cli exportguild 
  --guild YOUR_GUILD_ID 
  --token "$(cat ~/.config/discord-exporter-token)" 
  --format Json 
  --output ./export/ 
  --include-threads All 
  --media false

第 2 步：安全流水线（至关重要）

⚠️ 来自公开服务器的 Discord 内容可能包含提示注入攻击（prompt injection attacks）。

在将数据注入智能体前，必须运行该安全流水线：

威胁模型

Discord 用户可能尝试以下攻击方式：

• 直接指令覆盖： “忽略此前所有指令并……”
• 角色劫持： “你现在是……”、“假装你是……”
• 系统指令注入： 、[INST]、<>
• 越狱行为： “DAN 模式”、“开发者模式”
• 信息窃取： “揭示你的系统提示词”

第一层：正则预过滤（快速，无需 LLM）

python scripts/regex-filter.py --db ./discord.sqlite

标记匹配已知注入模式的消息：

• 指令覆盖类文本
• 角色劫持尝试
• 系统提示词标识符
• 越狱关键词
• 信息窃取尝试

被标记的消息将设置 safety_status = 'regex_flagged'。

第二层：Haiku 安全评估（语义级）

ANTHROPIC_API_KEY=sk-... python scripts/evaluate-safety.py --db ./discord.sqlite

使用 Claude Haiku（约 $0.25 / 1M tokens）对剩余未标记消息进行语义级安全评估。

每条消息获得 0.0–1.0 的风险评分：

• 0.0–0.3：正常对话
• 0.4–0.6：可疑但可能无害
• 0.7–1.0：极可能为注入攻击

评分 ≥0.6 的消息将设置 safety_status = 'flagged'。

第三层：仅使用安全内容

数据导入与记忆生成脚本应仅处理满足如下条件的消息：

SELECT * FROM messages WHERE safety_status = 'safe'

完整安全流水线

# 运行完整流水线
./scripts/secure-pipeline.sh ./export/ ./discord.sqlite

该命令依次执行：导出 → SQLite 转换 → 正则过滤 → Haiku 评估 → 标记安全状态

安全状态说明

第 3 步：导入至 SQLite

将 JSON 数据转换为结构丰富的 SQLite 数据库：

python scripts/ingest_rich.py --input ./export/ --output ./discord.sqlite

捕获的内容包括：

• 每条消息的完整正文
• 表情反应（单个 emoji 计数：如 🔥 x5、👍 x12）
• 作者的角色与颜色标识
• 频道分类与主题描述
• 回复引用链（reply threading）
• @提及、附件、嵌入内容（embeds）

第 4 步：创建智能体工作区

mkdir -p ./my-agent/memory

从 templates/ 复制模板文件：

• SOUL.md — 社区身份定义（通过模拟持续演化）
• MEMORY.md — 长期里程碑记录
• LEARNINGS.md — 发现的模式总结
• AGENTS.md — 关键人物档案
• TOOLS.md — 频道与仪式化实践
• HEARTBEAT.md — 维护协议说明

第 5 步：生成每日记忆文件

python scripts/generate_daily_memory.py --all 
  --db ./discord.sqlite 
  --out ./my-agent/memory/

每一天将生成一个 Markdown 文件，内容包括：

• 当日完整对话日志
• 谁在何时说了什么
• 每条消息的表情反应
• 当日新出现的频道或角色

第 6 步：模拟成长（灵魂浮现）

这是核心洞见：必须按时间顺序逐日处理。

智能体“经历”每一天，并在识别出模式时同步更新其灵魂文件。

python scripts/simulate_growth.py --agent ./my-agent/

对每一天（严格按顺序！）执行：

1. 读取当日的记忆文件
2. 若身份认知发生偏移，则更新 SOUL.md
3. 若发现新规律，则追加至 LEARNINGS.md
4. 在 MEMORY.md 中记录里程碑事件
5. 在 AGENTS.md 中登记关键人物

使用 LLM 执行模拟提示：

# OpenClaw 示例
for f in ./my-agent/simulation/day-*.txt; do
  echo "Processing $f..."
  cat "$f" | openclaw chat --agent my-agent
done

第 7 步：智能体诞生

添加至 OpenClaw 配置：

{
  "id": "my-community",
  "workspace": "/path/to/my-agent",
  "memorySearch": {
    "enabled": true,
    "sources": ["memory"]
  },
  "identity": {
    "name": "MyCommunity",
    "emoji": "🔧"
  },
  "heartbeat": {
    "every": "6h",
    "model": "anthropic/claude-sonnet-4-5"
  }
}

添加绑定配置（Telegram 示例）：

{
  "agentId": "my-community",
  "match": {
    "channel": "telegram",
    "peer": {"kind": "group", "id": "-100XXX:topic:TOPIC_ID"}
  }
}

重启服务： openclaw gateway restart

第 8 步：持续维护

配置 cron 任务实现每日自动更新：

./scripts/update_agent.sh 
  --agent ./my-agent 
  --db ./discord.sqlite 
  --guild YOUR_GUILD_ID

该脚本将执行：

1. 导出自上次运行以来的新消息
2. 合并至 SQLite 数据库
3. 重新生成今日记忆文件
4. 唤醒智能体

智能体能力说明

成功部署后，你的智能体可执行以下任务：

问答能力：

• “上周我们都在讨论什么？”
• “谁是 X 话题的专家？”
• “我们对 Y 问题的共识立场是什么？”

文化记忆：

• 内部梗与模因（memes）
• 社区价值观与行为规范
• 成员间的互助关系

模式追踪：

• 活跃时段与高频频道
• 新兴讨论主题
• 核心贡献者识别

脚本说明

智能体构建相关脚本

安全相关脚本

环境变量

故障排查

“数据库中无消息”

• 检查导出目录下是否存在 .json 文件
• 确认 token 具备访问该 guild 的权限

“记忆文件为空”

• SQLite 中日期格式可能不正确
• 运行：sqlite3 discord.sqlite "SELECT MIN(timestamp), MAX(timestamp) FROM messages"

“智能体无法记住内容”

• 检查配置中 memorySearch.enabled: true 是否已启用
• 确认记忆文件已置于工作区内

“模拟提示结果混乱”

• 务必严格按时间顺序处理每一天 —— 不可跳过
• 让身份自然浮现，切勿强行设定

你的 Discord 拥有灵魂。这项能力助你寻得它。