OpenGame API配置详解如何为4大AI模态设置Provider与密钥【免费下载链接】OpenGameOpenGame: Open Agentic Coding for Games项目地址: https://gitcode.com/gh_mirrors/op/OpenGameOpenGame 是一个开源的游戏 Agent 框架靠调用多种生成式 AI 接口来自动写代码、生成美术、动画和音效。本文带你用 10 分钟吃透 OpenGame 的 API 配置为 reasoning推理、image图像、video视频、audio音频这4 大 AI 模态分别设置 Provider 与密钥的方法、优先级规则和常见坑。一、先搞懂4 大 AI 模态各管什么OpenGame 把生成 AI拆成了 4 个相互独立的模态每个模态都可以单独指定不同的 Provider互不干扰模态用途是否必须reasoning游戏设计推理GDD 文档生成、游戏类型分类、ABC 乐谱生成做像样的游戏必需image背景、精灵图、动画底帧、tileset任何素材生成都需要video图生视频动画帧、文生视频音频素材源可选缺失时动画回退到图生图audioLLM 写 ABC 乐谱本地渲染成 WAV可选缺失时用程序化占位音 注意驱动对话循环的主 Agent 大模型不属于这套体系它走OPENAI_API_KEY/OPENAI_BASE_URL/OPENAI_MODEL或交互式/auth命令配置详见 认证文档。二、3 大 Provider 家族tongyi、doubao、openai-compatOpenGame 内置 3 个 Provider 家族源码见 providerConfig.tsProvider说明支持的模态tongyi阿里云 DashScope通义 Wan/Qwen 系列reasoning、image、video、audiodoubao火山引擎 ARK豆包 Seedream/Seedance 系列reasoning、image、video、audioopenai-compat任何兼容 OpenAI REST 形状的接口OpenAI、OpenRouter、fal 等reasoning、image、audio⚠️ 一个小坑openai-compat不支持 video——目前 Sora/Veo 并不属于公开的 OpenAI 形状接口。如果你给OPENGAME_VIDEO_PROVIDER选它会得到一个清晰的报错提示而不是静默失败。选tongyi或doubao时baseUrl 和 model 都有内置默认值只需填 API Key选openai-compat则必须提供BASE_URL和MODEL。三、方式一环境变量配置官方推荐每个模态读取 4 个环境变量格式统一为OPENGAME_模态大写_字段变量含义是否必填OPENGAME_MOD_PROVIDER选 Provider 家族必填OPENGAME_MOD_API_KEY发给 Provider 的 Bearer 令牌必填OPENGAME_MOD_BASE_URL接口地址openai-compat 必填其余可选OPENGAME_MOD_MODEL模型名openai-compat 必填其余可选MOD为REASONING、IMAGE、VIDEO、AUDIO之一。仓库根目录提供了一份可直接复制的模板.env.example复制为.env后填入自己的 Key 即可。示例全部使用阿里云 DashScope最省事export OPENGAME_REASONING_PROVIDERtongyi export OPENGAME_REASONING_API_KEYsk-aliyun-key export OPENGAME_REASONING_MODELdeepseek-v3.2 export OPENGAME_IMAGE_PROVIDERtongyi export OPENGAME_IMAGE_API_KEYsk-aliyun-key export OPENGAME_IMAGE_MODELwan2.5-t2i-preview export OPENGAME_VIDEO_PROVIDERtongyi export OPENGAME_VIDEO_API_KEYsk-aliyun-key export OPENGAME_VIDEO_MODELwan2.5-i2v-preview export OPENGAME_AUDIO_PROVIDERtongyi export OPENGAME_AUDIO_API_KEYsk-aliyun-key export OPENGAME_AUDIO_MODELqwen-plus示例混搭使用OpenAI 负责推理doubao 负责图视频export OPENGAME_REASONING_PROVIDERopenai-compat export OPENGAME_REASONING_API_KEYsk-openai-key export OPENGAME_REASONING_BASE_URLhttps://api.openai.com/v1 export OPENGAME_REASONING_MODELgpt-4o-mini export OPENGAME_IMAGE_PROVIDERdoubao export OPENGAME_IMAGE_API_KEYvolc-key export OPENGAME_IMAGE_MODELdoubao-seedream-4-0-250828 export OPENGAME_VIDEO_PROVIDERdoubao export OPENGAME_VIDEO_API_KEYvolc-key export OPENGAME_VIDEO_MODELdoubao-seedance-1-0-pro-250528四、方式二settings.json 持久化配置不想每次 export把配置写进~/.qwen/settings.json环境变量优先级更高因此 settings.json 适合放默认值临时会话再用环境变量覆盖{ openGame: { providers: { reasoning: { provider: openai-compat, apiKey: sk-openai-key, baseUrl: https://api.openai.com/v1, model: gpt-4o-mini }, image: { provider: tongyi, apiKey: sk-aliyun-key, model: wan2.5-t2i-preview }, video: { provider: doubao, apiKey: volc-key, model: doubao-seedance-1-0-pro-250528 }, audio: { provider: openai-compat, apiKey: sk-openai-key, baseUrl: https://api.openai.com/v1, model: gpt-4o-mini } } } }settings.json 中还可以用$VAR_NAME语法引用环境变量避免把 Key 明文写死。完整配置层级说明见 settings.md。五、配置优先级到底谁先生效对每个模态OpenGame 按顺序查找用第一个非空值_PROVIDER、_API_KEY、_BASE_URL、_MODEL各自独立走同一套链OPENGAME_MOD_*环境变量最高优先级~/.qwen/settings.json中的openGame.providers.mod字段旧版 DashScope 风格变量如DASHSCOPE_API_KEY——自动推断为tongyi保证存量配置不炸都没有 → 抛出MissingProviderConfigError错误信息会明确告诉你该设哪个变量六、用 /setup 一键体检检查 Provider 配置状态配置完成后在 CLI 里输入/setup别名/providers、/config即可看到 4 个模态的配置体检报告已配置的显示 provider 与 model未配置的会直接附上该模态的环境变量模板复制粘贴就能修好。命令实现见 setupCommand.ts。OpenGame generative-AI providers [ok] reasoning providertongyi modeldeepseek-v3.2 [ok] image providertongyi modelwan2.5-t2i-preview [--] video not configured purpose: animation frames audio source (image-to-video) quick setup (env vars): export OPENGAME_VIDEO_PROVIDERtongyi export OPENGAME_VIDEO_API_KEYsk-...全部就绪时会提示 All four modalities are configured. You are good to go. 七、常见疑问速答Q什么都不配置能启动吗能。CLI 正常启动、对话正常只有当 Agent 真正调用素材生成 / GDD / 分类工具时才报错且报错信息会精确指出缺哪个变量。Q旧变量DASHSCOPE_API_KEY还能用吗能。作为 fallback 链保留如IMAGE_MODEL_API_KEY→DASHSCOPE_API_KEY但官方建议迁移到OPENGAME_*命名旧变量未来大版本可能移除。Q密钥安全怎么保证OpenGame 不内置任何默认凭证状态检查接口ProviderStatusBanner永远不会读取或打印 API Key 本身。建议把项目级密钥放.qwen/.env并排除在 git 之外切勿把 Key 提交进版本库。写在最后一句话总结 OpenGame 的 API 配置逻辑4 个模态 × 4 个变量环境变量优先settings.json 兜底。完整变量清单参考 api-keys.md配置好后跑一次/setup四个模态全绿就可以开始让 AI 帮你做游戏了 【免费下载链接】OpenGameOpenGame: Open Agentic Coding for Games项目地址: https://gitcode.com/gh_mirrors/op/OpenGame创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考