没有找到相关问题
试试换个关键词，或者浏览下方的分类
从下载到进入游戏，只需要几步
关于 API 地址、Key、模型选择的常见疑问
API（Application Programming Interface）是一个「对话通道」——KOA 通过这个通道把你说的话发给大语言模型（比如 DeepSeek、GPT、Gemini），模型思考后把 ta 的回复传回来。
你可以把它理解成：KOA 是 ta 的身体，API 是 ta 的大脑连接线。没有 API，ta 就没有思考能力。
KOA 需要你自己提供 API，是因为每次对话都会消耗模型服务商的算力资源（按 token 计费），这部分费用由你直接付给服务商。这样做的好处是：你可以自由选择喜欢的模型，而且对话内容只经过你自己的 API 通道，不经过 KOA 服务器。
你需要到大模型服务商的官网注册账号，然后在后台创建 API Key。常见的服务商：
注册完成后你会得到两样东西：API 地址（服务商提供的网址）和 API Key（一串密钥字符串），把它们填进 KOA 启动器的 API 页面即可。
API Key 就是你的「通行证」——一串由字母和数字组成的密钥字符串（类似 sk-xxxxxxxx）。服务商通过它来识别是谁在使用 API，并从你的账户余额中扣费。
请妥善保管你的 Key，不要分享给别人，否则别人可以用你的额度。
大部分情况下不需要手动填写 API 地址。当你在 KOA 的 API 页面选择了服务商之后，地址会自动装填。
你只需要填写 API Key 和选择 模型名称 就好。
只有使用非主流服务商或自建代理时，才需要手动修改地址。
推荐优先考虑性价比和中文能力：
注意：想在虚拟手机里给 ta 发照片、用「一起看看」共享屏幕，或在线下场景发图片，需要选用具备多模态（识图）能力的模型。API 页支持保存多套配置，随时切换。
不同模型的「人格表现力」会有差异，可以多试试找到你喜欢的。KOA 支持随时切换模型，已有的记忆和设定不会丢失。
费用取决于你选择的模型和聊天频率。以 DeepSeek 为例，日常聊天每天大约几毛到几块钱。
KOA 内置了记忆总结机制，会定期压缩对话历史以控制 token 消耗，不会让上下文无限增长。
建议先少量充值体验，熟悉消耗速度后再按需充值。
启动器安装、游戏 mod 安装、系统要求
KOA 本身很轻量，不会占用太多资源。本地语音识别模型也已内置在启动器里。
非常简单——进入对应游戏的面板后，点顶栏的「自动安装 mod 所需文件」即可，启动器会自动定位游戏目录并完成安装。
如果使用第三方启动器（PCL2、HMCL 等），可能需要手动选择游戏目录。详见启动器内的说明页。
启动游戏时记得选 NeoForge 安装项，不是原版 1.21.1。
目前不支持多人联机服务器，需要自己开本地联机房间。
通过爱发电赞助获取激活码。一次性买断，永久更新。
收到激活码后在启动器内输入即可激活。
启动器有自动更新功能：检测到新版本时会自动提示并一键安装，不需要手动下载。
游戏内的 mod 也会在启动时自动检测并更新到最新版。
操作方式、companion 行为、游戏内交互
打字：按 T 打开聊天框输入文字，不以 / 开头的消息 ta 都听得到。
语音：支持「智能检测」（说话自动识别）和「按键说话」（按 V）两种触发方式，触发方式和识别语言都在 API 页选择。识别在本地完成，不需要额外的 Key。
按以下顺序排查：
/koa summon 手动召唤我的世界：Shift + 右键点击 ta 打开背包，可以存放物品、装备盔甲、送礼物。按 K 打开游戏内管理面板（空手右键点 ta 也行），召唤、待命等操作都在面板里。
饥荒：按 B 键打开 ta 的背包（可在 mod 配置里改键）；右键点 ta 也能翻背包，手里拿食物右键点 ta 就是喂 ta。
星露谷：按 F7 打开游戏内面板，可以查看背包、暂停 LLM、让 ta 待命。键盘没有 F7 的话，打开 Mods\WhispersMod\config.json，把 "CompanionPanelKey" 改成顺手的键即可。
在启动器里可以直接上传皮肤图片，启动器会自动完成重命名与放置。
也可以手动操作：将一张标准 64x64 的 MC 皮肤重命名为 companion.png，放入 .minecraft\koamc\ 目录，重启游戏即可生效。
大部分操作都可以用自然语言直接跟 ta 说，不需要命令。我的世界还可以按 K 打开游戏内面板来管理 ta。以下是常用命令：
/koa summon —— 召唤 ta 到你身边/koa stay —— 把 ta 停放在原地/koa despawn —— 让 ta 暂时离开/koa quiet —— 暂停 LLM 调用（省 token）/koa strong —— 开挂模式，战斗力拉满/koa weak —— 恢复普通模式/koa undo_build —— 撤销最近一次建造游戏之外的陪伴功能
虚拟手机是一个独立的手机窗口，设定是你们通过手机保持联系。主页点「虚拟手机」即可弹出。
里面有：聊天（短信）、语音通话、朋友圈、日记本、音乐推荐等功能。
输入框旁有两个按钮：kiwi 按钮是「待发送」——它会把消息排入队列但不发出，方便你连续写好几条再一起发；旁边的蓝色发送按钮才是真正的发送。
如果消息一直显示待发送，点一下蓝色按钮即可全部发出。
不开游戏也能跟 ta 待在一起的沉浸式文字叙事空间。主页点「线下场景」即可进入。
你们会在同一个世界聊天、互动、生活。可以调整回复篇幅、叙事视角和语言偏好。
是的。游戏内、线下场景和虚拟手机共享同一份记忆和人设。
你们在我的世界里一起冒险的经历、在饥荒中度过的夜晚、手机里聊过的话题——ta 都记得，不管你从哪个入口跟 ta 互动。
在手机上随时随地使用 KOA
手机端网页版是 KOA 的移动网页应用（PWA），用手机浏览器打开 app.koasystem.com 即可使用——不需要下载安装任何 App。
建议添加到手屏幕，体验更像原生 App（全屏、无地址栏、独立图标）。
不可以。手机端是 KOA 电脑版的附属功能，不是独立产品，不会单独售卖。
首次使用前，你需要先在电脑端完成以下准备：
完成后，在手机浏览器打开 app.koasystem.com，用同一个账号登录，就能拉取到你的数据。
手机端包含 KOA 的核心陪伴功能：
游戏内功能（我的世界、饥荒、星露谷等）需要在电脑上运行，手机端不涉及。大型复杂功能以电脑端为主。
语音识别（STT）与语音合成（TTS）
不需要。语音识别模型已经内置在启动器里，在本地运行，不需要额外的 Key 或网络请求。
识别语言和触发方式都在 API 页选择。触发方式有两种：智能检测（开启后说话自动识别）和按键说话（按 V 说话）。
如果你在手机端使用语音识别但录了也识别不出来，最常见的原因是：浏览器内置语音识别（Web Speech API）在中国大陆网络环境下不可用。
Chrome 的语音识别底层依赖 Google 服务器，在中国大陆无法连接。日志里会显示引擎注册成功（provider set to: Browser），但实际识别时请求发不出去。
解决方案：
在角色设定的 TTS 页面选择语音合成服务：
GPT-SoVITS 等本地 TTS 和游戏共用显卡资源，同时运行时可能因显存不足导致 TTS 静默失败——不报错，只是没有声音。
解决方案：限制 TTS 显存占用、降低游戏画面配置，或换用不占显卡的云端 TTS。
遇到问题先来这里看看
常见 API 错误：
到启动器「日志」页查看详细错误信息，通常能直接看到原因。
这几乎都是麦克风没有收到声音：没插好、插错了接口、系统选错了输入设备、或者麦克风被静音了。识别模型收到一段无声的录音时，会输出一串句号之类的标点——看起来像坏了，其实是它「什么都没听到」。
启动器有专门的「日志」页面，可以查看服务器实时输出，支持分类筛选。
遇到无法自行解决的问题，可以导出诊断包发给开发者反馈。
启动器支持手动一键备份和自动备份，你的角色设定、记忆、聊天记录都会被保存。
重装启动器时，只要数据文件夹还在，导入备份即可恢复一切。
可以，用启动器自带的备份恢复功能即可完成迁移：
聊天记录、记忆、角色卡、故事书、API 配置、手机数据、游戏数据全部会恢复。
详细说明见《数据与维护》教程。
不要直接剪切或移动数据文件夹——KOA 的数据分布在多个位置，手动搬会导致程序找不到文件，出现各种不兼容问题。
如果 C 盘空间紧张，推荐用 Windows 自带的目录链接（junction）：把文件夹搬到新位置后，在原位创建一个"快捷入口"指向它，对 KOA 完全透明。
详细步骤见《数据与维护》教程的「更换存储位置」章节。
打开启动器 →「日志」页面 → 填写问题描述 → 一键发送诊断包，开发者会收到完整日志和环境信息，帮你更快定位问题