跳转到主要内容

​
目标

按本页步骤操作后，你会拿到 MineClawd 的一次成功回复。

​
小词汇表

Minecraft Java Edition

官方 Minecraft 启动器里的 PC 版本。

模组加载器

让 Minecraft 运行模组的软件。MineClawd 支持 Fabric、Forge 和 NeoForge。

模组

一个为 Minecraft 增加功能的 .jar 文件。

API 密钥

让 MineClawd 连接在线 AI 服务的私密密钥。

​
选择平台

MineClawd 支持三种加载器与版本组合。请选择与你环境匹配的标签页。

​
第 1 步：安装 NeoForge

  1. 从 neoforged.net 下载 NeoForge Installer。
  2. 选择 Minecraft 版本 1.21.1，然后运行安装器。
  3. 打开 Minecraft Launcher，先运行一次 NeoForge 1.21.1 配置，再关闭游戏。

​
第 2 步：下载必需模组

从 Modrinth 下载下列文件。每个页面都选择匹配 NeoForge 和 1.21.1 的文件。
模组下载链接
MineClawdmodrinth.com/mod/mineclawd
KubeJSmodrinth.com/mod/kubejs
Architectury APImodrinth.com/mod/architectury-api
Rhinomodrinth.com/mod/rhino
YetAnotherConfigLib v3 (YACL)modrinth.com/mod/yacl
Better ModListmodrinth.com/mod/better-modlist

​
第 3 步：把模组文件放进 mods 文件夹

  1. 打开 Minecraft 文件夹。
  2. 打开 mods 文件夹；如果不存在就创建。
  3. 把所有下载的 .jar 文件移动到 mods。
  4. 不要解压 .jar 文件。

​
第 4 步：启动游戏并打开 MineClawd 配置

  1. 使用你的模组加载器配置启动 Minecraft。
  2. 创建或打开一个单人世界。
  3. 将该世界的 Allow Cheats 设为 ON。
  4. 打开 Better ModList -> MineClawd -> Configure（Fabric 请使用 Mod Menu）。
游戏中的 MineClawd 配置界面

​
第 5 步：连接 AI 服务

如果你还没有 AI 账号，建议先用 OpenRouter 并选择免费模型。
  1. 创建账号：openrouter.ai
  2. 创建 API key：openrouter.ai/settings/keys
OpenRouter 设置页面中的 API key 管理区域
  1. 在 MineClawd 配置页设置：
    • Provider: OpenAI
    • Endpoint: https://openrouter.ai/api/v1
    • API Key: 粘贴你的 OpenRouter key
    • Model: 从 openrouter.ai/models 选择一个 model id（免费模型常带 :free）
    • Summarize Model: 先用同一个 model id
  2. 保存配置。
免费模型和限制会变化。如果某个模型失败，请在同一模型页换一个 model id。

​
第 5b 步（可选）：启用网页搜索

MineClawd 可通过 Tavily 在对话中搜索网页。当你需要查询模组文档、合成配方或其他在线资料时，这很有用。
  1. 创建 Tavily 账号：tavily.com
  2. 在 Tavily 控制台复制你的 API key。
Tavily API 平台中的 API key 管理界面
  1. 在 MineClawd 配置页 Search 分组下，将 key 填入 Tavily API Key。你也可以用命令设置：
/mineclawd config tavily-api-key <your-tavily-key>
配置完成后，MineClawd 会获得 search 工具来查询网页并返回精简来源片段。如果未设置 key，search 工具会禁用，MineClawd 会在你请求网页搜索时明确提示。

​
第 6 步：发送你的第一条消息

你可以通过两种方式与 MineClawd 对话：

​
方式 A：使用覆盖层 GUI

在屏幕左侧找到浮动球（Assistive Touch）。点击球体打开覆盖层，在输入栏输入消息后点击 Send。
MineClawd Assistive Touch 浮动球

​
方式 B：使用聊天命令

打开聊天并运行： 
/mclawd hello
两种方式都可用。覆盖层把流式响应和 Session 管理放在同一处。完整用法见 使用 GUI。

​
如果不工作

前往 /resources/troubleshooting 并按对应症状处理。

​
下一步

完成第一条成功请求后，你可以继续阅读这些指南。

使用 GUI

学习覆盖层布局、流式状态和内联提问。

管理 Session

创建、切换并修复用于长任务的 Session。

追踪资产

浏览并管理 MineClawd 在你世界里创建的所有内容。

命令参考

查看所有 /mineclawd 命令及示例。