跳转到主要内容

​
部署模型

  • 在服务器端安装 MineClawd，以启用 /mineclawd 与 /mclawd。
  • 客户端安装仅对核心命令不是必需的。
  • 客户端必须安装才能使用：
    • /mineclawd config 的 GUI 数据包
    • /mineclawd history 历史书 UI
    • ask-user-question 的弹窗选项
    • 覆盖层 GUI（AssistiveTouch 球体、流式视图、会话/资产管理）
若玩家未安装客户端模组，MineClawd 仍能在聊天中使用备用流程（如 /mineclawd choose ...）。所有命令都可通过聊天执行。

​
权限模型与管理员控制

  • MineClawd 的命令根由原版权限等级 2 (source.hasPermissionLevel(2)) 限制。
  • 各子命令没有额外的自定义权限节点。
  • 实际效果：只授予值得信任的操作者 OP 权限。
若你的服务器栈支持命令级别权限映射，只让 AI 操作员角色访问 /mineclawd 与 /mclawd。

​
忙碌服务器的可见性控制

MineClawd 提供按玩家的可见性设置： 
/mineclawd config broadcast-requests-to <self|all|ops>
  • self：仅请求者看到提示回显与任务状态。
  • all：所有人都能看到。
  • ops：只有运营者可见。
该设置保存在 mineclawd/player-settings.json 中，按玩家 UUID 作用。 也可以在配置界面的 “Misc” 区段更改，名称为 “Broadcast requests to”。

​
多人环境下的会话归属

  • 会话数据按拥有者密钥隔离。
  • 玩家命令操作其个人会话集。
  • 控制台命令使用独立的 owner 命名空间。
对于团队操作，提前决定每位运营者是保持个人会话还是共用一个账户。

​
专用服务器上的动态注册表

默认 dynamic-registry-mode 为 AUTO，此模式在专用服务器上禁用动态占位符。 要强制启用： 
/mineclawd config dynamic-registry-mode enabled
然后重启服务器。

​
启用后的变化

  • 运行时可使用物品/方块/流体槽的动态占位符。
  • 同步状态会发送给客户端。
  • 世界持久化状态记录动态槽数据。
  • 客户端也必须安装 MineClawd 才能加入该专服。
只有在分阶段测试后再在生产服务器上启用动态注册表。该设置会强制所有玩家必须安装客户端。

​
推荐的运营基线

目标建议设置
降低聊天噪音broadcast-requests-to ops
避免无限工具循环limit-tool-calls true
保持循环次数tool-call-limit 设置为 8 到 12
仅调试事件暂时设置 debug-mode true

​
服务器上线检查表

  1. 先确定运营者角色与 OP 策略。
  2. 设置提供商与模型凭据。
  3. 设定广播策略（self、ops 或 all）。
  4. 决定 dynamic-registry-mode 维持 auto 还是切换为 enabled。
  5. 在两个真实账户（运营者与非运营者）上测试后再公开上线。

​
相关页面