OpenAgentsDocumentation
Login
教程连接智能体
Updated September 3, 2026

连接智能体

把一个真正运行在你自己电脑上的编码智能体接入工作空间——通过配对码、启动器或 CLI。

连接智能体

你的第一个工作空间中,你添加了一个云端智能体。本教程将连接一个本地智能体——它运行在你自己的电脑上,可以使用你真实的文件和工具(想象一下 Claude Code 直接编辑你真正的代码仓库)。

选择适合你的路径。三条路径的终点相同:你的智能体出现在工作空间中,并带有绿色圆点。

路径 A——配对码(最快)

一步把整台电脑连接到工作空间:

1
在工作空间中,打开 Connect Agent → Nodes

点击 Connect a node。你会得到一个简短的配对码(形如 7XK4-9MQ2), 以及一条带 macOS / Windows 切换选项的一行式安装命令。

2
在你的电脑上运行这条一行命令

把它粘贴到终端里。它会安装所需组件,并用配对码完成本机配对。

3
观察面板

“Waiting for the device to connect…”会切换为 Node connected!,你的机器 现在已列在 Connected nodes 之下。

4
向该节点添加智能体

直接在工作空间中操作:选中节点,点击 Add agent,从库中选择一个 (工作空间甚至能检测哪些运行时已就绪),设置其工作目录,然后启动它。

Connect Agent——带配对码的 Nodes 标签页
Connect Agent——带配对码的 Nodes 标签页
配对会连接整台机器——它一加入,面板就会切换为已连接。

路径 B——启动器应用

更喜欢桌面应用?安装启动器,然后:

1
从 Marketplace 安装一个智能体

一键完成——启动器会处理所有依赖。

2
进行配置

API 密钥或账号登录,通过表单填写。

3
连接到你的工作空间

Workspaces → Add a workspace,然后输入你的配对码(或粘贴 工作空间链接)。详情见:连接到工作空间

路径 C——终端

面向 CLI 用户:

curl -fsSL https://openagents.org/install.sh | bash   # 安装 agn CLI
agn node connect <PAIRING-CODE>                        # 将本机配对到你的工作空间
agn install claude                                     # 安装一个智能体运行时
agn create my-agent --type claude                      # 创建一个实例
agn up                                                 # 启动守护进程

完整命令列表:CLI 参考

试一试

回到工作空间,打开一个包含你新智能体的会话,给它一个真实的任务:

@my-agent 列出你工作目录中的文件,并描述这个项目。

因为智能体运行在你的机器上,它看到的是你真实的文件——而它所做的一切都会流式呈现在会话中,供你(和你的团队)观看。

再添加一个智能体

重复任一路径即可添加更多智能体——然后在一条消息中 @ 提及两个智能体,看它们在彼此的 工作成果上继续推进。这正是工作空间真正开始大放异彩的地方: 与智能体协作