参考手册配置参考

配置参考

需求

本页区分 Agent Core、Java、Bedrock 和 QQ 的真实配置入口,避免使用已经无效的 llm.yaml、settings.yaml 或旧 Java 路径。

架构

Agent Core

模型、智能体、工作区和 QQ 配置通过 Alice 界面及其持久化层管理,不提供手工 YAML 主路径。TCP 服务源码默认监听 0.0.0.0:27541,最大连接 10,心跳间隔 10 秒、超时 30 秒。不要因此推断 Adapter 已支持跨主机配置。

Java Adapter

运行数据位于游戏根目录或存档下的 Alice/。可确认的文件包括 Alice/mcagent_instance.json、Alice/world_identity.json、Alice/agents/*.json、世界数据库与日志目录。命令:

/alice status
/alice config get <key>
/alice config set <key> <value>   # 需 OP
/alice config list
/alice reload                     # 需 OP
/alice help

Bedrock Adapter config.json

键类型/默认说明
hoststring / 127.0.0.1声明的 Agent Core 主机;当前入口限制见已知限制
portnumber / 27541声明端口
debugboolean / false调试输出
survival.eat.max_search_radiusnumber / 0食物搜索半径
survival.sleep.max_bed_search_radiusnumber / 32床搜索半径
survival.sleep.max_wait_msnumber / 60000最大等待毫秒数
block.max_area_operation_blocksnumber / 256区域操作上限
block.tool_durability_thresholdnumber / 5工具耐久阈值
block.allow_alternative_materialsboolean / true是否允许替代材料
gui_test.require_opboolean / trueGUI 测试是否要求 OP

QQ

模式为 desktop、docker 或 external,默认 desktop。external 配置 wsHost、wsPort(1–65535)、wsProtocol、accessToken;默认端口 3001。授权配置包含 owner、admins、whitelist、默认权限和冷却秒数。

执行

优先通过 UI 和游戏命令修改配置;修改前备份。不要公开 auth_token、模型 API Key 或 OneBot access token。Bedrock host/port 即使存在,也不能据此宣称跨主机连接已生效;参见 已知限制。