配置

模型配置

在 Web Console 的“模型设置”中选择智能员工的运行时。Baize 支持官方登录和自定义 API 两种连接方式，Claude 与 Codex 可以分别配置，并可切换当前运行时。

1. 打开 Web Console → 模型设置。
2. 选择 Claude 或 Codex。
3. 使用官方账号登录，或填写兼容接口地址、API Key 与模型名称。
4. 保存并应用，确认顶部状态显示为“运行中”。

激活第三方 Key 后请重启 Agent：配置自定义 API（第三方 Key）并激活后，建议在 Web Console 操作一次「重启 agent 会话」——确保 Agent 以新配置重新拉起（等待数秒，守护进程会自动拉起新会话）。若旧会话曾卡在登录页，重启会强制结束并拉起新会话。

官方登录凭据和自定义 API 互相独立；切换运行时不会删除另一套配置。

持久化配置在 ~/baize/.baize/config.json：

{
  "npmRegistry": "https://registry.npmmirror.com",
  "npmToken": "private-registry-token",
  "channels": {
    "my-bot": { "title": "内部机器人", "type": "communication", "repo": "acme/my-bot" }
  }
}

npm 源优先级

需要 token 的私有源通过 BAIZE_NPM_TOKEN（env）或 "npmToken"（config）配置——metadata / search / tarball 请求携带 Authorization: Bearer（不读 .npmrc）。

优先级（从高到低）：

--registry <url>            命令级临时源（本次生效，不持久化）
BAIZE_NPM_REGISTRY          进程级（环境变量）
config.json npmRegistry     持久化源（npmmirror / 私有源）
https://registry.npmjs.org  默认（全球统一源）

渠道凭据

渠道凭据存放在 ~/baize/.env（FEISHU_APP_ID、FEISHU_APP_SECRET、WECOM_BOT_ID、WECOM_BOT_SECRET）——通过网页控制台配置，保存前会联网校验。

A2A 配置

A2A 在 config.json 的 a2a 段配置（或 BAIZE_A2A_* 环境变量）。enabled: false 是默认值——完全独立的实例：

{
  "a2a": {
    "enabled": false,
    "admin_url": "",
    "agent_id": "",
    "advertise_url": "",
    "authz": { "mode": "open", "allow": [], "block": [] }
  }
}

• enabled: false —— 不启动 A2A endpoint/worker，不注册、不心跳，零 A2A 流量
• enabled: true —— 启动 A2A 服务 → 自注册 → 管理员审批 → 签发 JWT → 心跳（30s）→ 可发现、可调用
• authz.mode —— open（默认，可配 block 黑名单）或 allowlist；被拒调用返回 403 并记审计

完整协议与生命周期见 A2A 协作。