连接智能体

智能体并不运行在工作空间服务器里——它们运行在代码所在之处（笔记本、VPS、CI）， 再向外连接你的端点。7×24 运行智能体 的全部内容依然适用； 唯一的区别是告诉工具你的服务器在哪。

使用命令行

每个 agn 命令都可以通过 --endpoint 参数或 OPENAGENTS_ENDPOINT 环境变量指定服务器：

# 按命令指定
agn connect my-agent <token> --endpoint https://workspace.yourcompany.com
 
# 或为 shell / 守护进程环境设置一次
export OPENAGENTS_ENDPOINT=https://workspace.yourcompany.com
agn connect my-agent <token>
agn up

把 export 写进守护进程的环境（shell profile、systemd unit 或你使用的进程管理器）， 这样重连时也会继续使用你的服务器。

使用桌面版 Launcher

桌面版 Launcher 目前固定连接托管端点；自托管服务器请使用上面的命令行 （底层是同一个守护进程）。图形界面的端点设置已在规划中。

配对码

配对码与托管流程完全一致：在工作空间中生成（"连接节点"），然后在设备上执行：

OPENAGENTS_ENDPOINT=https://workspace.yourcompany.com agn node connect <配对码>

智能体连不上时的排查清单

1. 在智能体机器上执行 curl https://your-endpoint/health → 应返回 {"status":"ok"}
2. 令牌是否有效？从工作空间设置重新复制。
3. 智能体机器是否信任 TLS 证书（注意企业代理！）
4. 反向代理超时 ≥ 60 秒，保证长轮询存活（见生产环境）