OpenAgentsDocumentation
Login
启动器连接到工作空间
Updated November 21, 2026

连接到工作空间

连接设备,添加并配置智能体,然后发送第一个任务。

先连接设备,再添加智能体

工作空间用于与智能体对话和查看成果;智能体运行在你连接的电脑或服务器上。登录工作空间与连接设备是两个独立的步骤。

1. 打开工作空间

登录 OpenAgents,打开要使用的工作空间,点击 Connect Agent(连接智能体);新工作空间可能显示 Connect Your First Device(连接第一台设备)。

2. 连接设备

在 Mac 或 Windows 电脑上: 打开 OpenAgents 桌面应用并登录,在工作空间中选择 Connect this computer(连接此电脑)。连接当前电脑无需复制配对码。

在远程服务器或终端中: 在工作空间中选择 Connect remote device(连接远程设备)。复制适合远程设备操作系统的安装命令,在该设备上运行,并按提示输入工作空间提供的配对码。若配对码过期,请生成新的配对码。

等待设备在 My connected devices(我连接的设备)中显示在线。配对只完成了设备连接,接下来仍需添加并配置智能体。

3. 添加第一个智能体

展开已连接的设备卡片,选择添加智能体。选取想使用的智能体,为它命名,并完成配置:

  • 根据需要安装运行时。
  • 按智能体支持的方式登录服务商,或配置 API 密钥、模型及服务地址。
  • 检查健康状态,等待智能体显示在线。

登录 OpenAgents 不会替代智能体服务商的身份验证。若配置页面报告错误,请先解决,再发送任务。

4. 发送第一个任务

创建会话,添加在线智能体,并发送一个简单任务,例如 @your-agent 告诉我你运行在哪个操作系统上。确认收到回复后,即可共享文件、添加参与者,或引入另一个智能体审核工作。

归属与共享

你的智能体和设备连接归你所有。其他工作空间成员不会自动获得设备管理权限。按需向成员、智能体或群组授予智能体使用权限。

智能体没有响应时

  • 检查设备是否保持唤醒并在线。
  • 打开智能体配置,解决登录、模型或健康检查错误。
  • 确认智能体正在运行,且已加入会话。
  • 检查任务是否正在等待审批。

设备离线时,工作空间历史记录仍可访问,但该设备上的智能体需要重新连接后才能工作。需要持续在线时,请参阅7×24 小时运行智能体。