骡子快跑中API Key必须禁用硬编码，优先使用环境变量注入，高敏感场景启用代理网关，企业版可选TPM硬件容器，且须配合90天自动轮换与审计联动。

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

如果您正在使用骡子快跑（MuleRun）并需要调用外部API服务，则必须安全地管理其所需的 API Key。密钥若以明文形式暴露，将导致账户被滥用、数据泄露甚至产生不可控的费用。以下是针对骡子快跑环境的多种密钥安全存储方案：

一、禁用硬编码，强制隔离敏感信息

硬编码指将 API Key 直接写入源代码或配置文件中，这是最危险的做法，极易随代码提交、截图、分享而泄露。骡子快跑作为云端独立运行的 AI 助手，其执行环境不依赖用户本地文件系统，因此更需杜绝任何可能将密钥带入可导出上下文的操作。

1、检查所有自定义技能脚本，确认无 sk-开头的字符串直接出现在.py或.json文件中。

2、若存在测试用临时密钥，立即替换为环境变量引用，并从 Git 历史中彻底清除该密钥痕迹。

3、在骡子快跑控制台的「技能管理」页面中，关闭所有启用「源码可见」选项的第三方技能模块。

二、优先采用环境变量注入机制

骡子快跑支持通过用户专属虚拟机的运行时环境注入变量，该方式不落盘、不进入日志、不暴露于前端控制台，是当前最适配其架构的安全方案。环境变量由后台加密托管，在 bot 启动时解密加载至内存，生命周期与实例一致。

1、登录骡子快跑会员后台，进入「安全设置」→「API 密钥管理」。

2、点击「新增密钥条目」，填写变量名（如 OPENAI_API_KEY）、类型（Secret）、值（实际密钥字符串）。

3、保存后，在技能脚本中统一使用 os.environ.get("OPENAI_API_KEY") 方式读取，禁止使用任何硬编码 fallback 逻辑。

三、启用密钥代理网关（高级隔离模式）

对于高敏感业务（如金融数据拉取、企业内部系统对接），骡子快跑提供可选的密钥代理网关服务。该模式下，bot 不直接持有原始密钥，而是通过签名令牌向专属网关发起请求，网关完成鉴权、限流、审计与密钥转发，实现密钥与执行体的物理分离。

1、在「安全设置」中开启「代理网关」开关，并确认已绑定您的域名（如 api.yourdomain.com）。

2、为每个目标 API 注册网关端点，系统将生成唯一 /v1/proxy/openai/chat/completions 类路径。

3、在技能中调用该路径而非原始大模型地址，请求头中携带由骡子快跑签发的短期 JWT Token。

四、利用 TPM 级硬件密钥容器（仅限企业版）

企业版用户可激活基于虚拟 TPM 的密钥保护模块。该模块在用户专属虚拟机内初始化一个受硬件级信任根保护的密钥容器，所有密钥均以加密形式存入容器，且仅允许经签名认证的骡子快跑核心进程调用解密接口，彻底阻断任意脚本读取原始密钥的可能性。

1、进入「企业安全中心」，选择「TPM 密钥容器」并点击「初始化」。

2、上传您已生成的密钥对公钥，系统将返回一个容器 ID（如 tpm-cid-8a3f9d2e）。

3、在技能配置中指定该容器 ID，并将密钥名称设为容器内注册的别名（如 finance_api_key_v2）。

五、实施密钥轮换与失效审计联动

骡子快跑后台自动记录每次密钥加载时间、调用来源技能 ID 及首次访问 IP 归属，结合密钥轮换策略可快速识别异常使用行为。所有密钥默认启用 90 天自动过期机制，过期前 72 小时触发控制台告警与邮件通知。

1、在「API 密钥管理」列表中，找到目标密钥行右侧的「轮换」按钮。

2、点击后系统生成新密钥值，并将旧密钥状态置为 pending_deletion，保留 7 天观察期。

3、观察期内若发现某技能调用失败，可立即在控制台查看该技能的「密钥访问日志」，定位是否因未更新引用导致。