文档中心

ArkClaw 企业版

请输入

导入用户信息

飞书-用户信息导入

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

说明

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

背景说明

用户管理中的用户信息主要来自两个途径：（1）管理员在用户管理中统一批量导入用户信息。（2）员工首次登录并创建 Claw 实例后，系统会自动将该用户信息记录到用户管理中。

前提条件

导入用户时，支持同步导入自定义属性。导入前，请先在 ArkClaw 控制台完成自定义属性配置，并确保表格中的属性名称与控制台保持一致，否则对应属性将无法导入。配置自定义属性的具体操作，请参见管理用户属性。

操作步骤

注意

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

您可参考配置飞书应用权限的步骤 7 ～步骤 10，为指定员工/组织添加飞书应用的权限并发布应用版本（不推荐直接调用飞书开放平台 API 更新应用可用范围，会影响 ArkClaw 侧的数据同步）。

左侧导航树中，选择“组织管理 > 用户管理”。

在用户管理页面，导入用户信息。

全量同步：从飞书组织架构自动同步全部员工数据（含自定义属性），快速初始化用户列表，降低人工维护成本。

批量上传：通过 CSV/XLSX 文件手动上传员工数据（含自定义属性），适合暂未接入飞书或仅需一次性导入历史员工数据的场景。

全量同步员工数据
批量上传员工数据
说明
通过飞书一键全量或存量同步更新用户信息时，支持通过手机号或邮箱作为唯一标识去重。唯一标识来源于 IdP （Identity Provider，身份提供商）认证中的唯一标识符策略。
单击“全量同步”按钮。

在弹出的对话框中，单击图标复制权限信息后，前往应用开通权限。单击“前往飞书开通权限”按钮，开通操作可参见步骤一：配置飞书应用和权限信息。

权限开通成功后，返回页面对话框单击“刷新“按钮，当所需权限均为“已授权”后，单击对话框中的“同步数据”按钮。

确认员工数据同步结果无误后，单击对话框中的“确认导入”按钮，完成操作。
（可选）增量同步员工信息：全量同步完成后，若飞书组织架构有新增或变更的员工信息，您可再次执行同步，将变更内容更新到 ArkClaw。
单击“新增员工”按钮。

单击弹出框中的“全量同步”按钮。

系统将自动同步飞书员工数据，待同步完成后，确认本次同步结果无误即可单击对话框中的“确认导入”按钮，完成操作。
说明
批量导入用户信息前，请预先准备好用户信息文件。
单击“批量上传”按钮。

在“批量新增员工信息”界面中，新增员工信息。

导入数据并配置映射规则。
选择“唯一标识符策略”。
说明
根据企业主要使用的身份信息选择，导入员工信息时，系统将自动合并手机号或邮箱相同的账号，避免重复创建。选定后如需变更，请参见配置认证方式。
邮箱/手机号不可用于登录 Claw 实例。
上传员工数据文件。
单击“CSV 模板/XLSX 模板”，获取标准文件。

按照模板要求填写员工信息，然后将文件上传至窗口。
注意
如果您使用 CSV 模板，D 列“手机号” 需符合 E.164 标准格式，您可修改为“文本”格式后再填写手机号信息。

单击“下一步”按钮。
预览数据并处理异常。

数据正常
数据异常

确认导入文件中的用户信息与系统中已有的用户信息不存在冲突后，单击“开始导入”按钮。

查看导入结果，单击“完成”按钮，完成员工信息上传操作。
说明
若存在导入失败的用户信息，请根据界面提示排查问题后重新导入。

最近更新时间：2026.08.25 18:54:42

这个页面对您有帮助吗？

有用

无用