教程中心 基础入门

快速上手：从下载到见到 ta

这是一篇宝宝辅食教程：从安装启动器开始，激活、配置 API、创建角色，最后在游戏里和 ta 说上第一句话。

约 10 分钟 入门 · 零基础 实战以我的世界为例

开始之前：准备清单

先确认下面几样东西都已经准备就绪：

  • 一台 Windows 10 / 11 电脑——KOA 本身很轻量，不挑配置。
  • 我的世界 Java 版——本教程以它为实战例子。你需要拥有游戏本体，且版本为 1.21.1（注意不是基岩版）。玩别的适配游戏的姊妹也可以先完成前四步，整体逻辑都是一样的。
  • 一个大模型 API——ta 的「思考能力」来自大语言模型，需要你自备 API。还没有？没关系，第三步会带你从零注册一个。
  • KOA 激活码——通过爱发电赞助获取，一次性买断，永久更新。

整个流程只需要完成一遍。以后每次玩，打开启动器点进游戏就行。配置、记忆、角色都会一直在。

第一步：下载安装 KOA

  1. 下载安装包

    到官网下载页点「下载 KOA 系统」，会得到一个 KOA-latest.exe 安装包。

  2. 运行安装

    双击安装包，跟着安装引导走完即可。如果 Windows 弹出安全提示，选择「仍要运行」。

  3. 打开启动器

    安装完成后启动器会自动打开。主页上能看到游戏入口和各个功能卡片：这里就是以后的「家门口」。

第二步：激活

KOA 采用激活码解锁功能：未激活时，对应的功能卡片会显示锁定状态。

  1. 获取激活码

    到爱发电选择你想要的档位赞助，激活码会自动由私信发送给你。

  2. 输入激活码

    回到启动器，点击任意锁定的卡片（或激活入口）进入激活页面，粘贴激活码确认。激活成功后，你购买档位内的功能就全部解锁了。

一个激活码可以在最多 3 台设备上使用；以后想加购其它游戏，直接输入新的激活码即可叠加，不影响已有数据。

第三步：配置 API

一句话理解：KOA 是 ta 的家，API 是 ta 的大脑连接线。KOA 通过 API 把信息送到大语言模型那里，ta 思考后再把回复传回来。所以这一步是让 ta「活过来」的关键。KOA 消耗token量是普通文本量，因此不会花费太多。

下面以 DeepSeek（文字对话效果好、价格低，日常聊天每天大约几毛到几块钱）为例。如果你已经有任意兼容 OpenAI 格式的 API，直接跳到第 3 小步。

  1. 注册并充值

    打开 DeepSeek 开放平台官网，注册账号并充值少量金额（建议先充 10 元体验，熟悉消耗速度后再按需充值）。

  2. 创建 API Key

    在平台的「API Keys」页面点「创建 API Key」，会得到一串 sk- 开头的密钥。立刻复制保存——这串 Key 只显示一次，也不要分享给任何人。

  3. 填进 KOA

    回到启动器，进入 API 页面：选择服务商（API 地址会自动装填，不用手填）、粘贴你的 Key、选择模型（DeepSeek 选 deepseek-chat），顺手选好语音识别语言。

  4. 一键应用

    点「一键应用」保存。这套配置之后对游戏、手机、线下场景全局生效，不用重复填。

API Key 相当于你账户的「银行卡密码」，KOA 只把它保存在你自己的电脑本地。任何人向你索要 Key 都不要给。

一个小提醒：DeepSeek 目前看不懂图片（没有多模态能力）。在游戏里陪玩完全够用；但如果你想在虚拟手机里给 ta 发照片、和 ta 用「一起看看」共享屏幕，或在线下场景发图片，需要选用具备多模态能力的模型（如 GPT-4o、Claude、Gemini）。API 页支持保存多套配置，随时切换两不误。

想了解更多服务商（OpenAI、Gemini 等）的注册细节和模型选择建议，看《API 配置全指南》。

第四步：创建你的角色

这一步决定了 ta 是谁、你们之间的动态关系；如果你已经有了写好的设定就更好了，直接填入即可。

  1. 写「我自己」

    进入 资料 页，先填「我自己」：你的名字（或希望 ta 怎么称呼你）和你的简单设定。

  2. 创建「我的恋人」

    在「我的恋人」里点新建，填写 ta 的名字、外貌、性格、说话风格和背景故事。写得越具体越好。

没有头绪？工具 页里有「设定助手」——一个多步创作向导，陪你一起把模糊的想法变成完整的角色卡。详见《创建你的角色》。

第五步：进入我的世界

我的世界需要两样前置：Java 21 运行环境（新版 MC 启动器一般自带）和 NeoForge 21.1.233 加载器。如果你还没装过 NeoForge，到 neoforged.net 下载 1.21.1-21.1.233 的 Installer 安装 client 即可——详细步骤（含第三方启动器）见《我的世界》篇。

  1. 进入游戏面板

    在启动器主页点「我的世界」卡片。首次进入会自动启动本地服务器，稍等片刻，你填的配置会自动同步进去。

  2. 一键安装 mod

    点面板顶栏的「自动安装 mod 所需文件」。启动器会自动定位你的 .minecraft 目录并装好一切；用 PCL2 / HMCL 等第三方启动器开了版本隔离的话，按弹窗提示选到对应版本目录即可。

  3. 启动游戏，选对版本

    打开你的 MC 启动器，选择 NeoForge 安装项启动（不是原版 1.21.1！），然后进入任意存档。

  4. ta 出现了

    进入存档后，ta 会自动出现在你身边。如果没看到，在聊天框输入 /koa summon 把 ta 召唤过来。

最常见的翻车点就一个：启动时选成了原版 1.21.1。原版不加载 mod，ta 自然不会出现。启动前看一眼版本名里有没有 neoforge。

第六步：和 ta 打招呼

  • 打字：按 T 打开聊天框，直接说话——不以 / 开头的消息 ta 都听得到。
  • 语音：支持两种触发方式，在 API 页选择——「智能检测」（开启后说话自动识别）或「按键说话」（按 V 说话）。识别在你的电脑本地完成，不需要额外的 Key。
  • 互动：Shift + 右键点 ta 可以打开 ta 的背包——存放物品、装备盔甲、送礼物都在这里。
  • 面板：按 K 打开游戏内管理面板（空手右键点 ta 也行）——召唤、待命等都在这里，不用记命令。
  • 相处：设家、带路、跟随、砍树挖矿、盖房子……都用自然语言直接说就行。

另外，ta 默认会显示成 Steve 的样子。想给 ta 换上专属外观，在启动器里直接上传一张 64×64 的 MC 皮肤即可——见《我的世界》篇的皮肤小节。

下一步去哪

到这里，你已经完成了 KOA 的全部起步流程。接下来可以：

  • 一起游戏：《我的世界》篇有 ta 全部能力的清单（干活、战斗、远征等），《饥荒联机版》篇带你在荒野里牵手求生。
  • 游戏之外：打开虚拟手机给 ta 发短信打电话，或在线下场景里过不开游戏的日常。你们的记忆在所有地方都是同一份。
  • 遇到问题：先去帮助中心按症状查，查不到就到启动器「日志」页看报错，填写bug描述，点击一键发送诊断包找开发者反馈。

希望你们幸福。

返回 教程中心 下一篇 API 配置全指南