Add agent configuration guide

2026-08-16 11:07:33 +08:00
parent 992a0e8488
commit 914579a94c
4 changed files with 394 additions and 42 deletions
@@ -115,6 +115,24 @@ export GORI_AGENT_HOME=/home/ubuntu/.gori-agent
 chmod 600 config.json
 ```

+## 多机器与多 QQ Bot
+
+仓库只维护一个无密钥模板：`config.example.json`。在每台机器、每个 Bot 实例中复制后单独修改：
+
+```bash
+cp config.example.json config.json
+chmod 600 config.json
+```
+
+每个进程只能登录一个 QQ Bot。为每个实例配置唯一的 QQ `appId`、`clientSecret`、`botNames` 和 `server.port`，并使用不同的 `GORI_AGENT_HOME`，避免日志、PID 和 ACP session 状态相互覆盖：
+
+```bash
+GORI_AGENT_HOME=/home/USER/.gori-agent-ROLE_ID \
+  ./gori-agent.sh start-daemon --config ./config.json
+```
+
+建议每个 Bot 的 `roles[]` 只保留它自己的一个 role，同时修改 `ROLE_ID`、`workspace`、`persona` 和 `policy`。需要 skill 时，再向顶层 `skills[]` 添加对应 SKILL.md，并在 role 的 `skills` 中引用。各机器的 `config.json` 不要提交到仓库。
+
 ## 配置角色

 角色定义在 `config.json` 的 `roles[]` 中：