# mulit_agent 配置与迁移

## 可迁移配置

发行目录下的 `config/agent-config.json` 随程序目录复制。首次启动时自动加载；在 Windows 发行版中，已保存的配对信息还会写入 `%LOCALAPPDATA%\MultiClawAgent\agent-settings.json` 作为本机持久副本，并同步回发行目录配置。重新编译替换发行目录不会丢失同一 Windows 用户的配对信息；复制到另一台电脑时仍需重新配对。

```json
{
  "config_version": 1,
  "agent_name": "",
  "controller_url": "",
  "agent_id": "",
  "certificate_fingerprint": ""
}
```

`agent_id` 与证书指纹不属于密钥，但在复制到新电脑后没有对应的 Windows 凭据；应用会保持地址预填，并要求输入总控新生成的一次性配对码以取得新凭据。

## 不可迁移的安全状态

Agent 凭据只存于当前 Windows 用户的凭据管理器，任务记录、日志和数据库保留在 `%LOCALAPPDATA%\MultiClawAgent`。不要复制或手工编辑 Windows 凭据；需要为新电脑重新配对。

LLM API Key、模型与服务地址不由这个 JSON 文件或 Agent 窗口管理，而由总控统一下发。Agent 接收后仅将 Key 写入当前 Windows 用户的凭据管理器；它不会跟随发行目录迁移，也不会显示给本机用户。