配置参考
配置分为 OriginRouter 全局配置、智能体原生配置、模型服务与路由、本地 API，以及会话级启动参数。先确定配置属于哪一层，再修改。
使用 OriginRouter Cloud 时，按快速开始完成登录和初始化。接入自有模型、跨设备连接、自动更新或脚本化部署时，再按本页对应章节配置。
需要交互式管理模型服务、模型和设备状态时，可从 App 的模型服务控制开始。
当前参考适用于 OriginRouter CLI 0.2.2。CLI 会把自己的状态写入 ORIGINROUTER_HOME；未设置时使用用户目录下的 .originrouter。
配置文件
| 文件 | 作用 | 是否敏感 |
|---|---|---|
$ORIGINROUTER_HOME/config.json | 模型服务、路由、更新策略与智能体默认值 | 是，权限为当前用户可读写 |
$ORIGINROUTER_HOME/local-api.json | Local API 端口、绑定地址、局域网与中继模式 | 是，权限为当前用户可读写 |
$ORIGINROUTER_HOME/local-api.token | Local API Bearer Token | 是，不得复制到日志或仓库 |
$ORIGINROUTER_HOME/device.json | 随机生成的安装设备身份 | 是，不是硬件指纹 |
$ORIGINROUTER_HOME/daemon.state.json | 当前后台进程运行状态 | 运行状态，不应手工编辑 |
不应直接编辑 Token、设备身份或运行状态文件。可写配置应优先通过 CLI 修改，以保留校验、私密文件权限与迁移逻辑。
可写配置键
| Key / 参数 | 类型 | 默认值 | 修改方式 | 说明 |
|---|---|---|---|---|
updates.mode | prompt | auto | off | prompt | config set / config unset | 控制 CLI 更新策略 |
agent.detailProfile | concise | standard | detailed | concise | agent detail set | 控制结构化智能体活动的显示详细度，不改变权限 |
claude.baseUrl | URL | 未设置 | config set claude.baseUrl | 旧版 Claude 直连配置，优先迁移到模型服务与路由 |
claude.apiKey | string | 未设置 | config set claude.apiKey | 旧版敏感字段，不建议直接写入终端历史 |
claude.model | string | 未设置 | config set claude.model | 旧版主模型配置 |
claude.smallFastModel | string | 未设置 | config set claude.smallFastModel | 旧版快速模型配置 |
local-api.port / --port | integer | 7437 | local config set | Local API 监听端口，修改后需重启服务 |
local-api.bindAddress / --bind | IP / host | 127.0.0.1 | local config set | 非回环地址必须同时明确允许 LAN |
local-api.allowLan / --allow-lan | on | off | off | local config set | 开放局域网访问，需要有效 Token |
local-api.relayMode / --relay-mode | auto | cloud | local | custom | auto | local config set | 控制账户中继与本地连接策略 |
local-api.relayUrl / --relay-url | URL | 官方中继服务 | local config set | 仅自定义中继模式通常需要修改 |
模型服务字段与模型路由不是任意 JSON 键。使用 provider add/update 与 route set/clear，CLI 会根据模型服务目录校验字段并掩码秘密。
生效优先级
同一维度存在多个值时，按以下顺序确定当前会话的最终值：
- 本次启动附加的参数（Wrapper 参数），例如
--originrouter-autonomy、--originrouter-detail与--native-config；它们只影响这一次启动。 - 智能体模型位置路由，例如
claude.main、claude.small或codex.main。 - 模型服务、Cloud 或 Remote 路由来源保存的模型和认证配置。
- OriginRouter 全局默认值与内置默认值。
使用 originrouter env print --agent claude|codex 查看合并后的脱敏环境。它展示结果，不暴露原始秘密。
查看配置
originrouter config show
originrouter local config show
originrouter route list
originrouter provider list
originrouter env print --agent claude
按顺序执行：查看全局配置、Local API 配置、路由、模型服务，最后检查 Claude 的脱敏运行环境。
env print 输出脱敏后的最终智能体环境，用于检查配置合并结果，不用于读取原始秘密。
更新策略
提示更新：
originrouter config set updates.mode prompt
自动更新：
originrouter config set updates.mode auto
关闭自动更新：
originrouter config set updates.mode off
查看当前更新状态：
originrouter update status
自动更新只在安装方式受支持、全局目录可写且没有活动会话时执行。更新程序不会自动调用 sudo。
Local API 与中继服务
originrouter local config set --port 7437 --bind 127.0.0.1
originrouter local config set --relay-mode auto
originrouter service restart
按顺序执行：设置端口和绑定地址、设置中继模式，最后重启服务使配置生效。
auto 在已登录时使用账户连接，未登录时保持本地模式。仅在明确要求不访问账户中继时使用 local。
开放 LAN 前确认网络可信：
originrouter local config set --bind 0.0.0.0 --allow-lan on
originrouter service restart
按顺序执行：开启 LAN 访问，再重启服务使设置生效。
智能体启动参数
使用原生 Claude 配置：
originrouter claude --native-config
以 guarded 审批模式启动 Codex：
originrouter codex --originrouter-autonomy guarded
以 detailed 展示级别启动 Claude：
originrouter claude --originrouter-detail detailed
模型来源、展示详细度和审批模式是独立维度。展示设置不构成权限设置。
敏感字段
模型服务的秘密字段优先使用 os.environ/NAME 引用。CLI 与 Local API 会掩码秘密字段，但终端历史、调试输出和第三方工具仍可能记录直接输入的字面量。