从源码跑通 Minecraft 机器人：env 配置逐项解释
这一页把官方 Minecraft 集成文档的部署流程拆成「准备 → 配置 → 启动」三段，字段说明按官方表格整理。
准备
- 按官方贡献文档在仓库根目录建立开发环境并安装依赖（包管理器为 pnpm）。
- 一个可访问的本地或可信 Minecraft 服务器（默认端口 25565）。
- AIRI 桌面版已在运行，并配好可用的模型服务。
- 一个 OpenAI 兼容 API（给机器人用；与 AIRI 本体的配置不互通，建议独立 Key）。
配置文件
复制模板：把仓库里 minecraft 集成目录下的 env 模板复制为 .env.local（本地凭据文件，不要提交、不要外发），然后逐项填写：
| 字段 | 含义 | 填写建议 |
|---|---|---|
| AIRI_WS_BASEURL | AIRI 通道地址 | 本机默认 ws 加本地 6121 端口的 ws 路径 |
| AIRI_CLIENT_NAME | 客户端名 | 用 minecraft-bot 即可 |
| AIRI_WS_TOKEN | 通道令牌 | 桌面版「设置 → 连接」里显示并复制的 Auth Token |
| OPENAI_API_BASEURL | 模型服务根地址 | 如官方示例的 deepseek 根地址，不加 chat/completions 后缀 |
| OPENAI_API_KEY | 模型服务密钥 | 引号间粘贴完整密钥 |
| OPENAI_MODEL | 默认模型 | 通用对话模型 ID |
| OPENAI_REASONING_MODEL | 思考模型 | 更强、支持思考的模型 ID |
| BOT_USERNAME | 机器人的游戏名 | 建议只用字母数字下划线 |
| BOT_HOSTNAME / BOT_PORT | 服务器地址 / 端口 | 本机填 localhost，端口默认 25565 |
| BOT_VERSION | 服务器版本 | 照服务器实际版本填，如 1.21.1 |
启动与验证
按官方文档从仓库根目录运行 minecraft 机器人的 dev 命令，终端日志确认两条连接（AIRI 通道、游戏服务器）都建立后，进游戏发文字即可交互。
排错提示
- 连不上 AIRI：检查桌面版是否在跑、Token 是否复制完整、端口对不对。
- 连不上服务器：地址、端口、版本号三项逐字核对。
- 模型不响应：单独验证那个 OpenAI 兼容 Key 是否有效，方法同验证失败排查。
接下来
- 不折腾游戏，先让她进社群：Discord 与 Telegram。
- 回顾要不要上手：游戏智能体全景。