您可以通过导入用户信息功能，灵活地将对应用户信息（含自定义字段）同步至系统中，用于后续的身份识别、权限管控及资源访问控制。

说明

本章节介绍如何将员工数据导入 ArkClaw。如需手动补充缺失的员工信息，或同步更新钉钉中已有员工信息，请参见更新用户信息。

## 背景说明用户管理中的用户信息主要来自两个途径：（1）管理员在用户管理中统一批量导入用户信息。（2）员工首次登录并创建 Claw 实例后，系统会自动将该用户信息记录到用户管理中。 ## 前提条件导入用户时，支持同步导入自定义属性。导入前，请先在 ArkClaw 控制台完成自定义属性配置，并确保表格中的属性名称与控制台保持一致，否则对应属性将无法导入。配置自定义属性的具体操作，请参见[管理用户属性](https://www.volcengine.com/docs/87732/2315847#ReGX3H0s)。 ## 操作步骤

注意

您需要先在钉钉应用中为员工添加权限，员工才可以创建并使用 ArkClaw。否则即使您导入了员工信息，员工也无法使用 ArkClaw。

您可参考配置钉钉应用权限的步骤7 ～ 步骤8，为指定员工/组织添加钉钉应用的权限并发布应用版本。

1. 登录 [ArkClaw 企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 左侧导航树中，选择“组织管理 \> 用户管理”。 3. 在用户管理页面，导入用户信息。 * **全量同步**：从钉钉组织架构自动同步全部员工数据（含自定义属性），快速初始化用户列表，降低人工维护成本。 * **批量上传**：通过 CSV/XLSX 文件手动上传员工数据（含自定义属性），适合暂未接入钉钉或仅需一次性导入历史员工数据的场景。全量同步员工数据

说明

通过钉钉一键全量或存量同步更新用户信息时，支持通过手机号或邮箱作为唯一标识去重。唯一标识来源于 IdP （Identity Provider，身份提供商）认证中的唯一标识符策略。

1. 单击“全量同步”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_eda2c990036a8571021b2aba1b9a302b.png) 2. 在弹出的对话框中，单击“钉钉应用后台”前往钉钉应用开启权限，开通操作可参见[步骤一：配置钉钉应用和权限信息](https://www.volcengine.com/docs/87732/2356402#3mdm2LMH)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cf77b90bb1d166dc5f2cd16263bf0fdf.png) 3. 权限开通成功后，返回页面对话框单击“已开通权限，继续同步”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6094c965f7a79de08bb9111124a71205.png) 4. 确认员工数据同步结果无误后，单击对话框中的“确认导入”按钮，完成操作。 5. （**可选**）增量同步员工信息：全量同步完成后，若钉钉组织架构有新增或变更的员工信息，您可再次执行同步，将变更内容更新到 ArkClaw。 1. 单击“新增员工”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cf8be93d857340c560f6a97504228517.png) 2. 单击弹出框中的“全量同步”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_80b87da3c1f9488f290928833aef513d.png) 3. 系统将自动同步钉钉员工数据，待同步完成后，确认本次同步结果无误即可单击对话框中的“确认导入”按钮，完成操作。批量上传员工数据

说明

批量导入用户信息前，请预先准备好用户信息文件。

1. 单击“批量上传”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5f7c0102f0a1ac48fff6286f480e0190.png) 2. 在“批量新增员工信息”界面中，新增员工信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c7adef3ff02268c71a9f36e1c8d89485.png) 1. 导入数据并配置映射规则。 1. 选择“唯一标识符策略”。

说明

根据企业主要使用的身份信息选择，导入员工信息时，系统将自动合并手机号或邮箱相同的账号，避免重复创建。选定后如需变更，请参见配置认证方式。

邮箱/手机号不可用于登录 Claw 实例。

2. 上传员工数据文件。 1. 单击“CSV 模板/XLSX 模板”，获取标准文件。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_00223e05876daaa4defb65a2924dba47.png) 2. 按照模板要求填写员工信息，然后将文件上传至窗口。

注意

如果您使用 CSV 模板，D 列“手机号” 需符合 E.164 标准格式，您可修改为“文本”格式后再填写手机号信息。

3. 单击“下一步”按钮。 2. 预览数据并处理异常。数据正常确认导入文件中的用户信息与系统中已有的用户信息不存在冲突后，单击“开始导入”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f345b91d526404cea58347e902ce024a.png) 数据异常如果导入文件中的用户信息与系统中已有的用户信息存在冲突，请更新用户信息。

注意

如果导入时未处理冲突数据，系统将保留已有的用户信息，不会使用本次导入的冲突内容。

1. 单击“编辑”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e766f46d20524835e580234476e29064.png) 2. 选择目标数据，并单击“保存”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1fb770539d37f0b2505775ce398d7db2.png) 3. 确认导入文件中的用户信息与系统中已有的用户信息不存在冲突后，单击“开始导入”按钮。 3. 查看导入结果，单击“完成”按钮，完成员工信息上传操作。

说明

若存在导入失败的用户信息，请根据界面提示排查问题后重新导入。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_95707dc91c644d8f8367d7f38ec00d58.png)