TIP
**推荐做法：**首次使用先运行 lovrabet config init，按 Prompt 选择官方国家/地区；连接配置完成后，再运行 lovrabet auth login 登录。企业独立部署时才修改 .lovrabet.json 中的 Domain。
本文只讲 Lovrabet Runtime CLI 的连接配置：如何通过交互式 config init 选择中国大陆或印度尼西亚节点，以及如何手工修改 .lovrabet.json 支持企业独立部署。
INFO
关联文档
- Lovrabet Runtime CLI .lovrabet.json 配置项参考：查看全部配置字段、作用域、合并规则和常用命令。
- 企业独立部署： .lovrabet.json 配置指南：查看企业独立部署的完整接入、验证和回退方案。
首次初始化：跟随 Prompt 选择节点
在任意目录执行：
lovrabet config initCLI 会显示 Select Lovrabet region，使用方向键选择：
Mainland China (cn)：中国大陆节点，也是默认选项。Indonesia (id)：印度尼西亚节点。
确认后，CLI 将连接配置写入全局文件 ~/.lovrabet.json。它只更新 region 和 Domain 路由，不会清除 AccessKey、输出格式或应用选择。
| 选择 | 配置文件结果 | 说明 |
|---|---|---|
中国大陆 cn | 通常不保存 region | cn 是默认值。省略字段可以保持旧配置兼容，也减少不必要配置。 |
印度尼西亚 id | "region": "id" | CLI 根据 id 选择整套 *.lovrabet.id 官方地址。 |
连接配置和身份登录是两步：
lovrabet config init
lovrabet auth loginconfig init 决定请求发到哪里，auth login 获取并保存用户身份；两者职责不混在一起。
自动化或脚本调用
不需要 Prompt 时直接传入参数：
lovrabet config init --region cn
lovrabet config init --region id目前新初始化只允许 cn 和 id。历史值 global 仅保留读取兼容，不会出现在 Prompt 中。
配置文件在哪里
| 作用域 | 文件 | 用途 |
|---|---|---|
| 全局配置 | ~/.lovrabet.json | 本机默认的国家/地区、Domain、认证和输出偏好。config init 写这里。 |
| 项目配置 | 当前目录/.lovrabet.json | 当前目录的用户意图配置；同名字段覆盖全局配置。 |
Lovrabet Runtime CLI 只读取 .lovrabet.json，不会读取 Rabetbase CLI 的 .rabetbase.json。手工修改时必须使用合法 JSON：字段名和字符串使用双引号，不能写注释或尾随逗号。
直接修改 JSON 选择官方节点
中国大陆是默认值，最简配置可以只保存认证等其他字段：
{
"accessKey": "<redacted>"
}印度尼西亚节点：
{
"region": "id",
"accessKey": "<redacted>"
}region 会一次解析五个官方地址：userDomain、apiDomain、runtimeDomain、skillDomain 和 kbDomain。用户只需要选择国家/地区，不需要理解内部地址映射。
企业独立部署：配置 Domain
企业部署可以只覆盖实际独立部署的服务，也可以配置完整的五个 Domain。正式字段如下：
| 字段 | 负责的请求 |
|---|---|
userDomain | 设备登录、AccessKey 自助入口等用户认证服务 |
apiDomain | 少量平台工具和 node-toolbox 类接口，不是运行态业务请求的主入口 |
runtimeDomain | 主要运行态入口：/client/*、数据、SQL、BFF、文件和任务等 |
skillDomain | Skill / SkillHub 的查询、安装、发布和管理接口 |
kbDomain | 个人和企业知识库接口；未单独配置时跟随显式 runtimeDomain |
完整独立部署示例
{
"userDomain": "https://user.example.com",
"apiDomain": "https://api.example.com",
"runtimeDomain": "https://runtime.example.com",
"skillDomain": "https://skills.example.com",
"kbDomain": "https://kb.example.com"
}只独立部署 Runtime
{
"runtimeDomain": "https://runtime.example.com"
}此时运行态主请求会走企业 Runtime，kbDomain 也会跟随这个显式 runtimeDomain。userDomain、apiDomain 和 skillDomain 继续使用当前 region 的官方地址。
TIP
如果企业 Runtime 没有部署知识库服务，不能只省略 kbDomain；应把它显式设置为希望继续使用的官方 Runtime 地址，例如中国大陆节点的 https://runtime.lovrabet.com。
保留官方节点，只覆盖一个服务
手工编辑 JSON 时，可以同时保留 region 并覆盖某个 Domain：
{
"region": "id",
"skillDomain": "https://skills.customer.example.com"
}这表示只有 SkillHub 使用客户地址，其他服务仍按印度尼西亚节点解析。
通过 Domain JSON 导入
部署程序也可以生成独立文件，再一次导入：
lovrabet config init --domain-config ./lovrabet-domains.json使用 --domain-config 时，CLI 切换为独立部署模式：清除原来的 region 和旧 Domain 字段，再写入文件中的正式 Domain。不要同时传 --region，两种模式互斥。
INFO
自定义 Domain 必须是可信的 HTTPS origin，例如 https://runtime.example.com。不能包含路径、查询参数、账号密码或业务路由。CLI 会把 AccessKey 等认证信息发送到对应服务。
修改后的验证方法
- 保存
.lovrabet.json。 - 运行
lovrabet doctor。 - 核对输出中的国家/地区和五个最终 Domain。
- 运行
lovrabet auth status检查身份状态。 - 再执行一个只读命令验证目标服务；不要直接用写命令试连接。
常见问题
为什么执行 config init --region cn 后看不到 region？
因为 cn 是默认值，CLI 会删除冗余字段，这是向前兼容设计。
运行 config init 后为什么还不能调用 API？
它只配置服务地址，不负责登录。继续运行 lovrabet auth login。
为什么当前目录修改 Domain 后全局配置没有变化？
项目级 .lovrabet.json 只覆盖当前目录。要修改本机默认值，请编辑 ~/.lovrabet.json，或使用带 --global 的配置写命令。
旧的 agentDomain、platformDomain、skillHubDomain 或 host 还能写吗？
它们只用于历史读取兼容。新配置只使用本文列出的五个正式字段，不要新旧字段混写。
适用版本：按 2026-08-22 Lovrabet Runtime CLI main 分支核对。