操作场景
纳管已有 Agent，是指将已经在本地或其他环境运行的 AI Agent（如 CodeBuddy、WorkBuddy、Claude Code、Codex 等），无需重新部署或迁移，直接接入 ClawPro 管控平台进行统一管理。
与“在 ClawPro 上新建云端 Agent” 不同，纳管面向的是现有的、已经跑起来的 Agent，让它们在保持原有运行方式的前提下，纳入企业统一的管控、治理与观测体系。将这些 Agent 纳入 ClawPro 后，企业可以统一为其同步企业技能与规范，并按组织或项目下发资产；员工可在我的 Agent 页面查看纳管状态与资源下发情况，管理员可在管控端统一查看和移除企业内的本地 Agent。
前提条件
管理员已开启允许用户纳管已有 Agent。
PC 已安装支持的外部 Agent：CodeBuddy、WorkBuddy、Claude Code 或 Codex。
PC 已安装 Node.js 与 npm，且可访问 ClawPro 接入地址。
支持 macOS、Windows 和 Linux。
操作步骤
纳管已有 Agent
1. 登录 ClawPro 用户端，在顶部导航栏选择 我的 Agent，单击纳管已有 Agent。
2. 在弹出的纳管已有 Agent 弹窗中确认支持环境与支持的外部 Agent，单击复制接入 Prompt。如下图所示：
注意：
首次复制会生成接入凭证，凭证在24小时内有效。请勿将 Prompt 或凭证转发给他人。
3. 打开目标外部 Agent 的对话，粘贴 Prompt 并发送。
外部 Agent 会自动完成 teamai-cli 安装、接入配置、hooks 注入和一次上报；执行过程中会请求执行命令，按提示允许即可。
4. 按提示完成以下操作：
Codex：在 Codex 中信任新增的 hooks，否则不会触发会话上报与资产同步。
项目绑定：脚本检查项目绑定时，按提示选择项目或跳过，规则参见 绑定项目。
5. 回到我的 Agent，列表出现该本地 Agent，表示接入成功。如下图所示：
若列表未出现该 Agent，按外部 Agent 的提示处理 hooks 或上报问题，处理后重新发起一次对话。
绑定项目
将本地 Agent 的工作空间与 ClawPro 项目绑定后，可在该工作空间中使用项目下发的技能、规范等资产。项目绑定为可选操作，不绑定不影响本地 Agent 的基本使用，也不影响组织资产的下发。
首次接入时
接入脚本会检查项目绑定情况。如果当前账号下存在可用项目，可按提示选择需要绑定的 ClawPro 项目，也可以跳过。绑定完成后，新建 Agent 会话即可使用项目资产。
后续绑定或更换项目
如果首次接入时跳过了绑定，或需要为其他工作空间绑定项目，可执行以下操作：。
1. 在需要绑定项目的工作空间中执行
teamai bind-project。2. 按照提示选择 ClawPro 项目，完成绑定。
3. 新建 Agent 会话，使项目绑定生效。
说明：
一个工作空间只能绑定一个项目。同一台电脑上的不同工作空间可分别绑定不同项目，项目资产不会同步到其他工作空间。
如需更换绑定项目，可重新执行
teamai bind-project 并选择其他项目，新建会话后生效。如果当前工作空间不需要使用项目资产，可执行
teamai bind-project --skip，后续不再自动提示绑定。如需重新绑定，仍可手动执行 teamai bind-project。查看本地 Agent 及资源下发情况
1. 在我的 Agent 中查看本地 Agent 卡片，确认连接状态、类型与所属组织。
2. 单击目标 Agent 进入详情，在资源面板中查看技能、规范、MCP 和模型的下发情况。资源按以下类型展示：
用户级资源：对当前用户的所有工作空间生效。
项目级资源：仅下发到已绑定对应项目的工作空间。
说明：
组织资产与项目资产需要在外部 Agent 中新建对话并完成一次交互后才会下发。
Agent 状态异常处理
本地 Agent 超过7天未同步时，将显示为不活跃，此时无法继续下发技能。可在外部 Agent 中发起一次对话并完成上报，待状态恢复后继续使用。如仍未恢复，可重新接入该 Agent。
管理员查看与管理本地 Agent
管理员可在 ClawPro 管控端查看已接入的本地 Agent、管理技能下发，或移除不再需要纳管的 Agent。
1. 登录 ClawPro 管控端，在左侧导航栏选择运维与观测 > Agent 列表。
2. 按 Agent 类型筛选本地 Agent，单击目标 Agent 进入详情，查看其运行状态（已接入、不活跃或销毁中），并在本地客户端信息中查看主机名、系统版本、插件载体、插件版本及信息更新时间。如下图所示：
管理技能下发
在本地 Agent 详情中单击 Skill 管理，进入企业技能库。管理员可在企业技能库中发起技能下发，并选择目标 Agent。
说明：
只有处于已接入状态的本地 Agent 可以作为技能下发目标。如果 Agent 处于不活跃状态，需要先恢复活跃或重新接入。
移除本地 Agent
如不再需要纳管某个本地 Agent，可在其详情中单击移除并确认。
注意：
移除后，平台将解除对该 Agent 的纳管，Agent 不再显示在列表中。原有接入配置无法自动恢复纳管，如需再次接入，必须重新执行接入流程。
本地 Agent 的管理限制
本地 Agent 使用用户电脑的算力，不受 ClawPro Tokens 管控。与云端 Agent 不同，ClawPro 不支持对本地 Agent 执行以下云端实例操作：
实例运维：开机、关机、重启、重置、重装系统、镜像升级、批量更新及续费。
远程管理：远程终端、命令下发及迁移移交。
实例配置：调整实例配置、配置通道与环境变量、安装插件。
本地 Agent 也不参与云端实例的批量操作。当批量任务包含外部接入的 Agent 时，系统会自动跳过，不对其执行操作。
相关操作
需要在用户端查找、安装或共建技能，请参见 获取与共建技能
需要为组织或项目配置资产，请参见 管理企业资产配置
