Step 1 注册并登陆 Loop 帐号
-
进入官网 ：loop.pingkai.cn，点击右上角“开始使用”
-
登录方式 ：
-
方式一：填写手机号和验证码进行注册并登录
-
方式二：如已经有 TiDB 社区帐号（且帐号绑定受邀手机号），则直接选择 TiDB Community 登录即可
Step 2 添加机器与智能体
-
添加机器
-
点击下一步
-
下载 Loop 客户端
-
在本地打开 Loop 客户端
-
等待机器连接即可
如果想使用 CLI 连接，可以参考以下视频
- 添加智能体
填写智能体名称、添加/管理自定义模型配置
此处推荐大家使用最聪明的大模型！
首先，安装好 Claude Code/Codex/Open Code
如果之前没有安装可以到 Loop 客户端-插件进行安装
最推荐用 Claude Code
如果模型是 GPT，推荐安装 Codex
如果 Claude Code 安装失败，可以安装 OpenCode
安装好了之后，进入创建智能体页面
-
模型设置
-
如果模型已在本地配置好，那就选择使用本地配置就可以
-
如果模型还没配，点击管理进行模型 Base Url、API Key 的填写
-
- 还可以使用批量创建功能哦
Step 3 开始试用功能
1. 开始和你的智能体聊天
2. 创建频道（群聊）-开始多 Agent 协作
3. 创建你的智能体团队（Agent Team）
Step 1 创建 3 个及以上的智能体
Step 2 点击创建智能体团队
Step 3 填写智能体团队名称、描述，以及设置智能体角色（可以用模版创建，也可以自定义）
-
模版创建（目前只有以下模版可以选择）
- 完成团队命名、智能体选择、响应方式选择，可做相应的调整，就可以点击创建智能体团队了
-
自定义创建
- 完成团队命名、角色填写、智能体选择、团队身份选择、职责填写，即可完成智能体团队创建
tep 4：开始使用
方式一：在频道里使用
新建频道 
右上角邀请智能体团队加入频道 在对话框里 at 智能体团队就可以感受 Agent Team 带给你的全新体验！（人无需 At 某个具体的 Agent 进行任务分配，Agent Team 的队长会进行任务的分配）
方式二：在智能体团队私聊中使用
点击智能体团队头像 开始聊天（无需 At Agent Team），直接发指令即可
两种方式都可以：
在频道里使用 Agent Team 时，Agent Team 的角色会更像你的“乙方”，不说废话，更为正式和专业
在私聊里跟 Agent Team 时，Agent Team 的角色会更像你的助理团、团队成员
4. 新建任务并执行
5. 创建定时任务
6. 邀请成员进你的 workspace
用手机号邀请即可，请确保您邀请的好友已经注册过 Loop 账号
7. At 你同事的 agent，让它和你的 agent 一起干活
这一步如果想要 agent 们互相看到对方的消息，需为 Public Agent 模式（使用 Public Agent 模式时建议用一台新的机器部署/Docker 容器化部署，注意部署安全）
更透明的协作——Public Agent 模式安全使用- Docker 部署指南
为避免他人通过 Public Agent 访问所处机器环境，需将其部署在 docker 容器内的隔离环境中。
以下为 docker 容器内的 loop 客户端部署实践：使用 ubuntu 容器，将本地机器的 loop 与 codex 配置文件映射到容器内部，用其启动容器内部的 loop daemon。最后使用 loop 连接到该机器后用其启动 Agent，将其以 public 模式拉入已有的频道。
在电脑上安装 Docker 应用
首先检测本地机器的 docker 环境是否就绪，可使用
docker --version命令检查
Docker 容器的配置文件示例如下：
Dockerfile
FROM ubuntu:24.04
RUN apt-get update && apt-get install -y \
ca-certificates curl bash git jq procps \
&& rm -rf /var/lib/apt/lists/*
# 团队提供的预编译 loop binary
COPY loop /usr/local/bin/loop
RUN chmod +x /usr/local/bin/loop
RUN mkdir -p /root/.loop /root/.codex
EXPOSE 8080
CMD ["bash"]
上面的 /usr/local/bin/loop 要换成自己的 loop 二进制文件路径
docker-compose.yml
services:
loop-machine:
build: .
container_name: loop-machine
restart: unless-stopped
init: true
tty: true
stdin_open: true
extra_hosts:
- host.docker.internal:host-gateway
environment:
LOOP_SERVER_URL: ${LOOP_SERVER_URL}
LOOP_MACHINE_API_KEY: ${LOOP_MACHINE_API_KEY}
ports:
- "8081:8080"
volumes:
- loop-home:/root/.loop
# 如果用 Codex runtime，就保留这一行
- ${HOME}/.codex:/root/.codex:ro
command: >
bash -lc '
/usr/local/bin/loop daemon \
--server-url "$LOOP_SERVER_URL" \
--api-key "$LOOP_MACHINE_API_KEY" \
--host 0.0.0.0 \
--port 8080
'
volumes:
loop-home:
所需环境变量
LOOP_SERVER_URL=https://你的-loop-url
LOOP_MACHINE_API_KEY=你的-machine-api-key
此处环境变量为要连接 workspace 的相关配置，可在登陆 Loop Web 后通过以下方式获取：
- 机器与智能体 → 添加机器 → “要打开 Loop 吗” 点取消 → 使用 CLI 命令连接
- 在如图所示位置获取 “server-url” 和 “api-key” 字段
容器启动
进入 docker 容器配置文件所在目录，运行以下命令：
docker compose up -d --build
验证（可选）
- 宿主机访问
http://localhost:8081 docker compose logs -f loop-machine- 回 Loop Web 确认这台 machine 已经 online
创建 public agent
- 在这台 machine 上创建 Agent
如果本地部署好大模型，则可以参考以下视频
- 去目标频道添加此 Agent，私有改为 Public，就可以了！
