本地 Worker 使用指南

进入 Worker 创建页

1. 登录 AgentTeams 控制台。

2. 进入目标实例。

3. 在左侧导航进入 Worker 管理。

4. 单击 创建 Worker。

5. 在创建方式中选择 本地（模板创建） 或 本地（自定义）。

两种方式的区别如下。

如果从 Team 页面创建 Worker，可以选择绑定到当前 Team。绑定后，Worker 会加入对应 Team，并按 Team 成员身份工作。关于 Team 管理的详细说明，请参见管理 Worker 和 Worker 团队。

填写基本信息

创建本地 Worker 时，需要填写 Worker 名称，并根据创建方式选择模板或填写自定义配置。

本地 Worker 的运行进程在用户本地环境中启动，但 Worker 的配置仍由控制台下发。配置保存后，本地 Worker 通常会在约 1 分钟内感知并生效，具体时间取决于本地网络和进程状态。

选择模型配置

本地 Worker 支持两种模型配置方式。

各运行时对模型配置方式的支持情况如下。

如果选择“使用本地模型”，控制台不会展示模型下拉框，也不会展示 Token 配额配置。请确保本地运行时本身可以正常调用模型。

选择网络访问方式

控制台会展示可用网络档位。

选择网络档位后，本地 Worker 通信和 Trace 数据上报都会使用对应网络路径。根据本地机器与实例之间的网络连通情况选择合适的档位。

选择运行时

启动命令阶段需要选择本地 Worker 使用的运行时。

如果运行时命令不在常规 PATH 内，可以通过连接命令末尾的运行时参数指定命令路径。运行时参数需要放在 -- 后面，例如：

loongsuite-pilot worker connect <id> -- --openclaw-command /path/to/openclaw

首次连接时也可以追加到控制台生成的 worker connect 命令后：

loongsuite-pilot worker connect \
  --runtime openclaw \
  --bootstrap-token '<bootstrap-token>' \
  -- --openclaw-command /path/to/openclaw

执行启动命令

控制台生成的启动命令通常分为两段。

第一段用于安装并配置 LoongSuite Pilot：

curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh -o /tmp/loongsuite-pilot-installer.sh && \
bash /tmp/loongsuite-pilot-installer.sh install \
  --collect-trace "true" \
  --cms-license-key '<license-key>' \
  --cms-endpoint '<cms-endpoint>' \
  --cms-workspace '<cms-workspace>' \
  --service-name-prefix 'agentteams-<instance-id>-worker'

第二段用于连接本地 Worker：

loongsuite-pilot worker connect \
  --runtime claude-code \
  --bootstrap-token '<bootstrap-token>'

通常情况下，直接复制控制台生成的完整命令执行即可。不要手动拆分或修改 token、云监控 2.0 endpoint、license key 等参数。

LoongSuite Pilot 参数说明

控制台生成命令中的主要参数如下。

其中，--cms-license-key、--cms-endpoint、--cms-workspace 和 --service-name-prefix 都由控制台生成，对应 AgentTeams 实例创建时为用户准备的云监控 2.0 工作空间。只有将 Trace 数据上报到该工作空间，AgentTeams 才能统计用户的 Trace 数据和 token 消耗，并在仪表盘中展示。

如果希望指定工作目录，可以执行：

loongsuite-pilot worker connect \
  --runtime claude-code \
  --bootstrap-token '<bootstrap-token>' \
  --work-dir /path/to/workdir

确认 LoongSuite Pilot 运行状态

运行 loongsuite-pilot status 确认 LoongSuite Pilot 正在运行且版本为 1.1.13 或以上。如需查看更多信息，运行 loongsuite-pilot info。如果 LoongSuite Pilot 没有运行，执行以下命令重启：

loongsuite-pilot restart

确认本地 Worker 连接状态

运行 loongsuite-pilot worker list 查看本地 Worker 列表。如果列表为空，说明连接命令可能没有执行成功，回到控制台重新复制启动命令执行。

对于列表中的目标 Worker，运行 loongsuite-pilot worker status <id> 查看详情，重点关注 State、Worker、Team、Heartbeat 和 Log 字段。

查看 Worker 日志

从 worker status <id> 输出中获取 Log 路径，查看日志：

tail -n 200 <Log 路径>

持续观察日志：

tail -f <Log 路径>

查看 Trace 上报情况

如果 Worker 可以回复消息，但云监控 2.0 中看不到 Trace，优先确认以下内容：

1. 是否使用控制台最新生成的启动命令。

2. 启动命令中 --collect-trace 是否为 true。

3. 启动命令中的云监控 2.0 参数是否完整。

4. 本地机器是否能够访问所选网络档位下的 Trace 上报地址。

排查时可以先查看 worker status <id> 输出中的日志路径，再通过日志确认是否存在 Trace 上报失败信息。

暂停连接

如果暂时不需要本地 Worker 工作，执行以下命令：

loongsuite-pilot worker disconnect <id>

执行后，本地 Worker 会停止运行，本地连接配置仍会保留。

重新连接

如果需要恢复同一个本地 Worker：

loongsuite-pilot worker connect <id>

如果控制台重新生成了启动命令，也可以用新 token 更新本地保存的凭证：

loongsuite-pilot worker connect <id> --bootstrap-token '<new-bootstrap-token>'

删除本地数据

不再使用本地 Worker 时，可以删除本地连接数据。

loongsuite-pilot worker disconnect <id>
loongsuite-pilot worker delete <id>

删除前确认不再需要该本地 Worker 的本地状态和运行日志。删除本地数据不会删除控制台上的 Worker；如果也不再需要云端 Worker 资源，在控制台删除 Worker。建议优先使用 loongsuite-pilot worker delete <id> 清理本地数据，不建议手动删除 LoongSuite Pilot 管理的数据。