必须将腾讯混元API Key以QCLOUD_API_KEY=ak-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx格式写入项目根目录.env文件，全大写、下划线连接、不加引号；复制时避免空格或换行，否则导致401错误且无明确日志提示。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要把腾讯混元API Key安全写入项目根目录的.env文件，必须确保变量名完全匹配服务端读取逻辑，否则程序启动时会因环境变量缺失直接报错退出。

确认API Key来源与格式

登录腾讯云混元控制台 → 模型广场 → 系统管理 → 接入管理 → 创建API KEY；复制生成的密钥字符串（形如 ak-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），注意不要带空格或换行符。

这一步操作起来很简单，直接把文件拖进去就行。但若复制时多选了前后空格或回车，会导致后续调用返回401 Unauthorized错误，且日志中不会提示具体原因。

编辑 .env 文件写入变量

打开项目根目录下的.env文件（若不存在则新建），在空白行中输入：

QCLOUD_API_KEY=ak-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

腾讯混元

腾讯混元是由腾讯公司推出的通用大语言模型与AI助手产品，基于自研的混元大模型体系打造，提供智能问答、内容生成、代码辅助、办公写作、知识检索等能力。用户可以通过网页端、移动端等方式使用，用于学习、工作和内容创作等多种场景。

下载

【QCLOUD_API_KEY必须全大写、下划线连接、不能加引号】。部分框架（如clawdbot原子能力模式）硬编码读取该变量名，写成qcloud_api_key或QCLOUD_APIKEY均无效；加单/双引号会使值被当作文本字面量，密钥无法解码认证。

验证写入是否生效

方法一：终端执行cat .env | grep QCLOUD_API_KEY，确认输出仅含一行且无多余字符；

方法二：在Python中临时运行import os; print(os.getenv("QCLOUD_API_KEY"))，输出应为完整密钥字符串；

方法三：启动服务前执行source .env && env | grep QCLOUD，检查是否进入当前shell环境变量表。