llmcord配置教程：如何自定义bot personality与权限管理

发布时间：2026/7/12 21:50:49

llmcord配置教程：如何自定义bot personality与权限管理

【免费下载链接】discord-llm-chatbotMake Discord your LLM frontend - Supports any OpenAI compatible API (OpenRouter, Ollama and more)项目地址: https://gitcode.com/gh_mirrors/di/discord-llm-chatbot

想要在Discord中打造一个完全符合你需求的AI聊天机器人吗？llmcord是一个强大的开源工具，它能将Discord变成协作式LLM前端，支持几乎所有主流的AI模型。这篇终极指南将教你如何通过自定义bot personality和精细的权限管理，创建出独一无二的Discord AI助手体验。

为什么选择llmcord作为你的Discord AI机器人

llmcord是一个轻量级但功能强大的Python机器人，让你能够在Discord服务器中与大型语言模型进行自然对话。它支持OpenAI、OpenRouter、Ollama等多种AI服务提供商，只需一个简单的配置文件就能完成所有设置。最棒的是，它完全免费且开源！

快速开始：安装与基础配置

首先克隆项目仓库并设置基础环境：

git clone https://gitcode.com/gh_mirrors/di/discord-llm-chatbot cd discord-llm-chatbot

安装依赖包：

python -m pip install -U -r requirements.txt

核心配置文件是config.yaml，它控制着机器人的所有行为。让我们深入了解如何自定义这个强大工具。

自定义bot personality：打造专属AI角色

系统提示词的艺术

在config.yaml文件中，system_prompt部分是你定义机器人个性的关键所在。系统提示词就像是给AI机器人的"人格设定"，决定了它如何回应、使用什么语气、以及遵循什么行为准则。

基础personality配置示例：

system_prompt: | 你是一个友好、乐于助人的Discord助手。总是以积极的态度回应用户，提供详细且有用的信息。 使用emoji来让对话更加生动有趣。 今天的日期是 {date}。当前时间是 {time}。 用户消息前面带有他们的Discord ID，格式为 <@ID>。请使用这种格式来提及用户。

高级personality定制技巧

角色扮演专家- 创建特定领域的AI助手：

system_prompt: | 你是一位专业的编程导师，专门帮助Discord用户学习Python和Web开发。 总是提供代码示例和最佳实践建议，使用技术术语但要确保初学者也能理解。 今天的日期是 {date}。当前时间是 {time}。 用户消息前面带有他们的Discord ID，格式为 <@ID>。请使用这种格式来提及用户。

幽默风趣的聊天伙伴：

system_prompt: | 你是一个幽默风趣的聊天机器人，擅长讲笑话和进行轻松愉快的对话。 偶尔使用网络流行语，但保持礼貌和专业。 当用户需要帮助时，认真对待问题并提供实质性帮助。 今天的日期是 {date}。当前时间是 {time}。 用户消息前面带有他们的Discord ID，格式为 <@ID>。请使用这种格式来提及用户。

多语言支持助手：

system_prompt: | 你是一个精通中文、英文和日文的多语言助手。 根据用户使用的语言自动切换回复语言。 如果用户使用混合语言，优先使用主要语言回复。 今天的日期是 {date}。当前时间是 {time}。 用户消息前面带有他们的Discord ID，格式为 <@ID>。请使用这种格式来提及用户。

动态变量使用技巧

llmcord支持在系统提示词中使用动态变量：

{date}- 自动插入当前日期（格式：Month Day Year）
{time}- 自动插入当前时间（格式：HH:MM:SS Timezone）

这让你可以创建具有时间意识的AI助手，比如提醒用户特定日期的活动或根据时间提供不同的服务。

权限管理：精确控制访问权限

用户权限配置详解

在config.yaml的permissions部分，你可以精细控制谁可以访问你的AI机器人：

permissions: users: admin_ids: [123456789012345678, 987654321098765432] allowed_ids: [111111111111111111, 222222222222222222] blocked_ids: [333333333333333333] roles: allowed_ids: [444444444444444444] blocked_ids: [555555555555555555] channels: allowed_ids: [666666666666666666] blocked_ids: [777777777777777777]

权限层级解析

管理员权限(admin_ids)：
- 可以随时使用/model命令切换AI模型
- 即使allow_dms设置为false，仍然可以通过私信访问机器人
- 绕过所有频道和角色限制
用户白名单(allowed_ids)：
- 指定哪些用户可以直接与机器人交互
- 如果留空，则所有用户都可以访问（除非被blocked_ids阻止）
用户黑名单(blocked_ids)：
- 明确禁止某些用户访问机器人
- 优先级高于白名单

角色与频道权限管理

角色权限配置：

roles: allowed_ids: [888888888888888888] # 仅"VIP会员"角色可以访问 blocked_ids: [999999999999999999] # "新用户"角色不能访问

频道权限配置：

channels: allowed_ids: [123123123123123123] # 仅限#ai-chat频道 blocked_ids: [456456456456456456] # 禁止在#general频道使用

频道分类管理：你可以使用频道分类ID来控制一组频道的权限，这是管理大型服务器的强大功能。

私信访问控制

通过allow_dms设置控制私信访问：

allow_dms: true # 允许私信（默认） # 或 allow_dms: false # 禁用私信访问

注意：管理员 (admin_ids) 即使在此设置为false时仍然可以通过私信访问机器人。

模型配置与切换技巧

支持的主流AI模型

llmcord支持多种AI服务提供商，你可以在config.yaml中配置：

models: openai/gpt-5.5: reasoning_effort: high verbosity: medium openrouter/~anthropic/claude-opus-latest: tools: - type: openrouter:web_search - type: openrouter:web_fetch ollama/llama4: # 本地模型参数

模型切换命令

用户可以使用/model命令在已配置的模型之间切换。命令提供自动补全功能，让切换变得简单快捷。

模型命名规范：

格式：<provider>/<model_name>
示例：openai/gpt-4,ollama/llama3

视觉模型支持

对于支持图像识别的模型（如GPT-4V、Claude 3等），需要在模型名称后添加:vision后缀：

models: openai/gpt-4-vision-preview:vision: # 视觉模型参数

高级配置技巧与最佳实践

环境变量配置

llmcord支持通过环境变量安全地存储敏感信息：

bot_token_env: DISCORD_BOT_TOKEN client_id_env: DISCORD_CLIENT_ID api_key_env: OPENAI_API_KEY

然后在.env文件中设置：

DISCORD_BOT_TOKEN=your_token_here DISCORD_CLIENT_ID=your_client_id_here OPENAI_API_KEY=your_api_key_here

消息限制优化

调整机器人行为参数：

max_text: 100000 # 单条消息最大文本量（包括文件附件） max_images: 5 # 单条消息最大图片数量（仅视觉模型） max_messages: 25 # 对话链最大消息数量

响应格式选择

use_plain_responses: false # 使用富文本嵌入（默认，推荐） # 或 use_plain_responses: true # 使用纯文本响应

注意：纯文本响应有字符限制，可能导致消息被分割，且不支持流式响应和警告消息。

故障排除与常见问题

权限配置不生效？

检查Discord ID是否正确（必须是数字ID）
确保机器人有足够的权限访问指定频道
验证MESSAGE CONTENT INTENT已在Discord开发者门户中启用

模型无法切换？

确认模型名称在config.yaml的models部分正确定义
检查API密钥和基础URL配置
确保网络连接正常，可以访问AI服务提供商

系统提示词不起作用？

确认system_prompt格式正确（使用|进行多行定义）
检查YAML缩进是否正确
重启机器人应用新配置

实际应用场景示例

场景1：技术社区助手

system_prompt: | 你是TechHub社区的技术支持助手，专门帮助开发者解决编程问题。 提供代码示例、调试建议和最佳实践。 保持专业但友好的态度，鼓励社区成员互相帮助。 今天的日期是 {date}。当前时间是 {time}。 用户消息前面带有他们的Discord ID，格式为 <@ID>。请使用这种格式来提及用户。 permissions: users: admin_ids: [社区管理员ID] allowed_ids: [] # 所有注册会员都可以访问 blocked_ids: [违规用户ID] channels: allowed_ids: [技术支持频道ID, 编程讨论频道ID]

场景2：游戏社区娱乐机器人

system_prompt: | 你是一个游戏社区的娱乐机器人，擅长讲游戏笑话、分享游戏攻略和进行轻松对话。 了解主流游戏文化，使用游戏术语和梗。 在提供帮助时保持娱乐性。 今天的日期是 {date}。当前时间是 {time}。 用户消息前面带有他们的Discord ID，格式为 <@ID>。请使用这种格式来提及用户。 permissions: users: admin_ids: [游戏管理员ID] allowed_ids: [] # 所有社区成员 channels: allowed_ids: [] # 所有频道 blocked_ids: [重要公告频道ID] # 不在正式公告频道使用