本文为您介绍如何使用Lark的方式开通空间并使用的全流程，完成本文档后，您将拥有一个已对接Lark SSO的ArkClaw空间，企业员工可通过Lark一键登录使用。

说明

适用场景： 企业已使用 Lark（海外版）进行团队协作，希望复用现有 Lark 账号体系免去单独建账号。

## 步骤一：配置Lark应用和权限信息 ### 步骤一：创建Lark企业应用 1. 登录[Lark开发者平台](https://open.larksuite.com/app?lang=en-US)，单击“Create Custom App”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9b31c06032762bd80dc2425cd0b74290.png) 2. 配置应用名称、描述及图标信息，单击“创建”按钮，完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b7443ee122d65c2ba681e131e50f6158.png) ### 步骤二：配置Lark应用权限 1. （可选）在[Lark开发者平台](https://open.larksuite.com/app?lang=en-US)，单击进入新创建的企业自建应用（本例中名为“ArkClaw”），如果您已在应用开发页面，请跳过此步骤。 2. 在左侧目录树选择“Development Configuration \> Permissions & Scopes”，单击“Batch import/export scopes”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b0705e9a81f152c04d9961cdd6bb90f5.png) 3. 在“Import”页签中，将如下权限替换原有示例，单击“Next，Review New Scopes”按钮。 ```Python { "scopes": { "tenant": [ "contact:user.base:readonly", "contact:user.email:readonly" ], "user": [] } } ``` ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_76d832d98fa95b273dac27c8632ea5d9.png) 4. 确认权限无误后，单击“Add”按钮，完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ec24fddde5a1e281674f6b404bd3c19e.png) 5. 配置权限可访问的数据范围，默认与应用的可用范围一致，配置后保存然后单击“Confirm”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_953b30e4527a4096e0ae75e43de12757.png) 6. 在左侧目录树选择“App Versions \> Version Management & Release”，单击“Create a version”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3d871c7b7754827662954450441a874e.png) 7. 输入应用版本号和更新说明，单击“Availability”处的“Edit”按钮，配置生效可用范围。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_66576c9a5b227d4a5167e67fe9785ba4.png) 8. 设置该企业应用的可用范围，添加需要使用ArkClaw 企业版的企业员工的企业Lark账号，完成后单击“Done”按钮。

说明

可以通过配置应用可见性范围来限定有哪些员工可以使用ArkClaw，如果对企业内使用ArkClaw 企业版的人员不作限制，可配置为“All members”，配置后企业内的所有员工均可使用ArkClaw。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_200a447882bce43f437410d424a09122.png) 9. 单击页面底部的“Save”按钮，创建版本。

说明

如果您不是企业Lark的管理员，在申请企业应用时申请理由需要填写实际的业务场景和功能描述，以帮助企业Lark管理员审批此次企业应用的申请。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_efcc1f186b5accb8149b48dc553cb75b.png) 10. 发布应用。 * 如果您此次申请免审批，单击页面右上角的“Publish”按钮，完成应用发布。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_283080243b0fe5909d54624d49c0000d.png) * 如果您此次申请需要审批，单击页面右上角的“**Submit for Release Review**”按钮，等待企业Lark管理员审核通过后，完成应用发布。 ### 步骤三：获取凭证信息 1. （可选）在[Lark开发者平台](https://open.larksuite.com/app?lang=en-US)，单击进入新创建的企业自建应用（本例中名为“ArkClaw”），如果您已在应用开发页面，请跳过此步骤。 2. 在左侧目录树选择“Basic Info \> Credentials & Basic Info”，复制并保存App ID和App Secret。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d7a150e99b9304c5045ddb054db5d6c4.png) ## 步骤二：服务开通授权

说明

触发条件： 仅首次开通 ArkClaw 服务时执行；后续在同账号下再次开通空间会跳过本步。

授权范围： 一次性向 ArkClaw 授予访问下述云服务的权限：VPC、ECS、私网链接 PrivateLink、对象存储 TOS、机器学习平台（具体清单详见服务条款）。

模型开通： 同时一键开通火山方舟全部非 Coding Plan模型的调用权限，方便后续在 ArkClaw 中直接选择模型。

费用说明： 本步骤本身免费；后续使用已开通的模型、方舟服务、联网搜索时将按量计费并出账单，涉及计费的服务如下：

方舟服务

联网搜索

1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“Claw管理 \> Claw 列表”。 3. 在弹出的对话框中，请您仔细阅读相关服务条款，确认无误后勾选“我已阅读并同意《ArkClaw 服务专用条款》”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_fc1fb29accd8e38e231705f00df5fc44.png) 4. 单击“开通并授权”按钮，完成角色授权和模型开通操作。 ## 步骤三：ArkClaw服务配置 1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“Claw管理 \> Claw 列表”。 3. 在服务开通页面，参考下表配置相关信息。 |配置项 |说明 | |---|---| |**基本信息** || |空间名称 |设置ArkClaw空间名称。平台会自动生成一个名称，管理员可按需修改，空间开通成功后，支持随时修改空间名称，详见[查看空间配置信息](https://www.volcengine.com/docs/87732/2272766?lang=zh#ftsmTKKb)。 | |**员工访问控制** || |认证方式 |配置企业员工访问控制信息，选择**Lark认证，** 配置企业系统权限所在的企业Lark应用信息，用于后续企业其他员工基于他们自己的Lark租户SSO，登录并使用ArkClaw。 | |App ID |输入企业Lark应用的App ID。 | |App Secret |输入企业Lark应用的App Secret。 | |**空间管理类型** || |选择空间管理类型 |选择当前新建空间下 Claw 实例的管理类型，**空间开通后不支持修改**。

* **席位管理**：按照整体席位数订阅，同一规格的席位到期时间一致，无需单独管理每个 Claw 实例的生命周期。在已购买的席位配额内，可以任意开通/分配 Claw 实例。

* **实例管理**：按照单个 Claw 实例进行管理，即空间下所有 Claw 实例单独创建、分配和管理，不同的 Claw 实例资源的生命周期不同，需要分别管理。

注意

选择空间管理类型为邀测功能，仅开通后可用，如有需要请联系客户经理开通。

| |**网络配置** || |空间网络配置 |ArkClaw 企业版的VPC网段和子网网段。平台将在当前Region下，自动创建用于ArkClaw的私有网络（VPC）、子网、安全组等网络资源，搭建ArkClaw运行的网络环境。

注意

ArkClaw 企业版空间开通成功后，不支持修改VPC网段和子网网段。指定ArkClaw私有网络为邀测功能，仅开通后可用，如有需要请联系客户经理开通。

* **随机网段创建**：

* 无需配置网段，平台会使用随机的私网网段为您创建ArkClaw的VPC和子网。

* 如果后期需要使用其他私有网络（VPC）访问ArkClaw私有网络的资源，请确保访问的私有网络（VPC）地址不属于以下网段，以免网段冲突：`192.18.0.0/15`、`33.0.0.0/8`、`66.0.0.0/8`、`9.0.0.0/8`。

* **指定网段创建**：

* 如果您后期需要通过云企业网（CEN）或中转路由器（TR）连接ArkClaw的私有网络，请基于您的网络规划在此指定ArkClaw的私有网络（VPC）网段。

* 单击卡片右上角“自定义配置”，输入自定义私有网络（VPC）的目标网段，平台会根据输入的网段创建VPC和子网。自定义网段请避免使用以下网段：`100.64.0.0/10`、`224.0.0.0/4`、`127.0.0.0/8`、`0.0.0.0/8`、`240.0.0.0/4`、`192.18.0.0/15`、`33.0.0.0/8 `、`66.0.0.0/8 `、`9.0.0.0/8`、`169.254.0.0/16`。

注意

面向海外用户的提醒： 如果您的 ArkClaw 空间将跨地域与海外 VPC 互联，建议在网段规划时同步参考海外区域的 RFC1918 使用情况，避免与海外侧 VPC 冲突后无法回退。

| 4. 配置完成后单击“立即开通”按钮，完成服务空间配置操作。

说明

ArkClaw支持在不同项目下开通独立的ArkClaw空间，此功能为邀测功能，仅开通后可用，详细操作及说明请参见开通多个空间。

5. 模型广场使用的火山方舟 API Key 拥有全部模型的调用权限，空间开通完成后会弹出对话框进行提示。如需管理模型范围您可单击“[火山方舟管理台](https://console.volcengine.com/ark/region:cn-beijing/apiKey?apikey=%7B%7D&projectName=default)”前往管理，无需管理单击“我知道了”按钮关闭对话框。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7fd212d4613a50b3f31a934022c8df03.png) ## 步骤四：购买ArkClaw企业版席位

注意

如果上一步骤开通 ArkClaw 空间中“操作空间管理类型”选择“实例管理”，请跳过此部分操作。

1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“Claw管理 \> Claw 列表”。 3. 在ArkClaw管理页面，单击“立即购买”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1a55f30af09e49adeb482882b48c5d2c.png) 4. 配置ArkClaw席位规格、数量，并在下方选择购买时长。

注意

ArkClaw 席位购买门槛

ArkClaw 企业版席位单次购买数量不少于 5个（含），不足 5 个无法下单。

不同规格的席位适用的场景不同，您可按需组合购买不同数量的席位规格，更多计费介绍请参见计费说明。

Agent Plan Team 购买

购买 ArkClaw 席位时，可同步搭配购买 Agent Plan Team；也可选择仅购买席位，后续再按需补充。

Agent Plan Team 购买后不支持退订。

ArkClaw 席位和 Agent Plan Team 非一一对应关系，为员工分配后 Agent Plan Team，该员工名下的所有 Claw 实例，共享该员工已分配的 Agent Plan Team 资源。

Coding Plan Team 购买

当前暂不支持开通空间时购买 Coding Plan Team，如有需要请在空间开通后购买或纳管，具体操作请参见管理方舟Plan。

所有拥有 Coding Plan Team 对应席位等级使用权限的 Claw 实例，共享所有该席位等级的 Coding Plan Team 资源。

购买与变更限制

数量门槛：ArkClaw 席位与 Agent Plan Team 绑定购买时，需确保 ArkClaw 中的 Agent Plan Team 总数量不少于 5 个（包括从 ArkClaw 购买的 Agent Plan Team 和纳管火山方舟的 Agent Plan Team ），单次下单最多购买 1000 个（含）。

专用限制：在 ArkClaw 中下单购买的方舟 Plan，仅建议在 ArkClaw 范围内使用。

ArkClaw 企业版会周期性轮转纳管的方舟 Plan API Key，轮转时旧 API Key 立即失效。若您将该 Key 复用于 ArkClaw 之外的服务，会随轮转一并中断。

如果在多场景共享方舟 Plan，建议在火山方舟直接购买独立的方舟 Plan、获取独立 API Key，并以“自定义模型来源”的方式配置模型，具体操作请参见配置自定义模型池。

自动续费

系统默认勾选“自动续费”，以避免到期欠费导致 ArkClaw 不可用。您也可手动取消该选项，但需注意在席位到期前自行完成手动续费。

“自动续费开关”打开后，后续在空间下的所有新购、变更的订单均会开启自动续费。

|规格 |适用场景 | |---|---| |轻量版 Starter |入门体验与轻量任务专属，支持简单对话，少量工具调用。 | |标准版 Standard |日常生产主力版本，支持中等复杂度的工作流和多轮对话。 | |高级版 Premium |复杂任务支撑，可承载多工具并行调用、中型项目工作流。 | |旗舰版 Ultimate |大型项目与高负载场景专属，支持全链路复杂流程编排。 | ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_21209e07f5cb64e10ce8f5d65b2afd4f.png) 5. 配置完成后单击“购买”按钮，根据页面指引支付相关费用，支付成功后单击“去控制台”按钮完成服务开通操作。服务开通大约 3～5 分钟，请您耐心等待。

注意

服务开通失败的常见原因“未完成企业实名认证”、“VPC 网段冲突”或“资源不足”，如均已确认无问题后仍开通失败，请复制页面上的错误信息，单击发起工单按钮处理。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_07c1b742f0c65faeddb25f75c7563f29.png) ## 步骤五：配置回调信息 1. 在[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)左侧导航树中，选择“空间概览”。 2. 在“空间概览”页面，单击Lark免登录授权码跳转链接后的“复制”图标，然后单击“去配置”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2d777814965ae6a32724ede36505b3d5.png) 3. 将自动跳转至Lark开发者平台配置了企业系统权限Lark应用的“Security Settings”页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_17ec1bd92e5c5e70290dc83f29027b94.png) 4. 把从ArkClaw空间中复制的Lark免登授权码跳转地址粘贴至**重定向URL**（Redirect URL）中，单击“Add”按钮，添加后立即生效。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d3ed325782eff27f9e88ac7046408911.png) ## 步骤六：导入用户信息 1. 在[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)左侧导航树中，选择“组织管理 \> 用户管理”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_dc8e9cc8c7b59944263b52de7a8ecfd1.png) 2. 在用户管理页面，导入用户信息。

说明

导入用户信息支持全量同步和批量上传两种方式，此处仅介绍全量同步，如需批量上传请参见导入用户信息。

1. 单击“全量同步”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9cf935831e909278d80258a84faba0d2.png) 2. 在弹出的对话框中，单击“![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_63c193a480ce090a432f5bbb65b83c5e.png) ”复制权限信息后，单击“前往Lark开通权限”，开通操作可参见[步骤一：配置Lark应用和权限信息](https://www.volcengine.com/docs/87732/2488136#A2hYWSp5)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_caa4e4e34104b6c7b10055571b7f5a91.png) 3. Lark权限开通成功后，返回页面对话框单击“刷新“按钮，当所需权限为“已授权”后，单击对话框中的“完成”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c6da9194804032fefbf443eb5a955a58.png) 4. 确认Lark员工数据同步结果无误后，单击对话框中的“确认导入”，完成操作。 5. （**可选**）增量同步员工信息。 1. 单击“新增员工”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6d8bd74fb9a417367022a1af4eead270.png) 2. 单击弹出框中的“全量同步”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_60093c7942b1bbf49ab0e75b0a40ba6e.png) 3. 系统将自动同步Lark员工数据，待同步完成后，确认本次同步结果无误即可单击对话框中的“确认导入”，完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_60195bab8b8f646cab0d095e6fae0173.png)

说明

如导入的员工信息存在邮箱、手机号等字段缺失的情况，需要手动补充缺失的员工信息，或同步更新Lark中已有员工信息，请参见更新用户信息。

3. 在左侧导航栏选择“空间概览”，获取员工登录链接信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9cf174270c396a5b58f2576d25764d88.png) ## 步骤七：发放员工登录地址通过企业任意一种消息传递方式（Lark、邮件等），把员工登录链接发放给需要使用ArkClaw的员工，企业员工可通过Lark的SSO认证，登录并使用ArkClaw。