核心功能与用法
discord-context 是一款面向 OpenClaw 生态的 Discord 集成技能,核心目标是在 AI 代理与 Discord 论坛线程对话时,自动注入相关的 QMD(Markdown 知识文件)上下文,实现"线程级记忆"。
主要能力:
- 定时轮询(每2小时):自动扫描论坛频道新活动,匹配并预加载对应的 QMD 内容
- 上下文绑定:通过
/discord-context link <thread_id> <qmd_name>手动建立线程与知识文件的映射 - 缓存管理:将 QMD 内容转储到
memory/discord-cache/目录,按需注入线程对话 - 状态查询:随时查看各线程的上下文缓存状态
命名映射规则:线程名称自动转换为 QMD 文件名(空格转短横线,如 "Mission Control" → mission-control.md),支持自定义映射。
显著优点
1. 零侵入集成:作为 Discord bot 后台运行,不改变用户对话体验
2. 知识可复用:同一 QMD 可关联多个线程,避免重复维护
3. 延迟加载机制:轮询+缓存设计,避免高频 API 调用
4. CLI 友好:提供完整的命令行接口,便于脚本化与自动化
潜在局限与风险
- Token 安全:依赖 Discord bot token,需妥善配置于 OpenClaw 环境
- 缓存延迟:轮询间隔2小时,知识更新非实时同步
- 命名敏感:自动映射依赖严格的命名约定,大小写/空格处理不当可能导致匹配失败
- 单点依赖:
curl和 Node.js 环境为硬性依赖
适合人群
- 运营 Discord 社区论坛的 AI 代理团队
- 需要将结构化知识库与对话场景绑定的开发者
- 使用 OpenClaw 框架构建上下文感知型机器人的用户
常规风险提示
- 确保 bot 权限仅限于必要的论坛频道读取/写入
- 定期检查
discord-cache目录的存储增长 - 敏感 QMD 内容注入公共线程前需评估隐私边界