Docs

ArkClaw Enterprise

Team mode

Using collaboration mode

ArkClaw collaboration mode is designed to break through the limitations of the single-agent mode in handling complex, cross-field tasks. With this mode, you can quickly build a temporary collaborative team composed of AI agents with expertise in different fields within an ArkClaw instance, enabling them to communicate and jointly complete comprehensive projects.

warning

The collaboration mode is an experimental feature currently in Beta. Your participation and experience are welcome. If you experience any problems, exceptions or have any suggestions during use, submit feedback by clicking "Settings > Feedback".

The workflow in collaboration mode is planned and controlled by the large model and consumes a large number of tokens. If the model produces hallucinations during project execution and the project cannot proceed as expected, you may suspend or delete the project.

Core features

Multifunctional collaboration: Collaborative members perform respective duties and collaborate efficiently under the unified scheduling of the project manager agent to complete complex tasks and deliver final outputs.

Independent workspace: Each member agent in the collaborative team has an independent session and workspace. This ensures that tasks in different fields are processed in parallel without interference.

Unified lifecycle management: Each member agent is deeply associated with a project. When you create a project, the platform automatically initializes all required member agents in the ArkClaw instance. When you delete the collaborative project, the associated multiple agents are securely released and deleted synchronously.

Mode comparison

Mode	Description
Collaboration mode	Designed specifically for complex projects. After you switch to this mode, the system guides you through the project creation process. At the same time, the session list on the left is automatically switched to the project view, allowing you to manage all collaborative projects easily.
Assistant mode	Maintains the original single-point dialog mode, which is suitable for quick Q&A and executing a single task.

Usage notes

Starter ArkClaw instances support the creation of only 3 collaborative projects, while Standard and Premium ArkClaw instances have no such limit.

Collaboration mode is only available for the primary agent, namely the ArkClaw intelligent assistant.

Currently, collaboration mode does not support visual interface takeover and manual operations of cloud PC (CUA) and cloud browser (BUA). If a step requiring manual operations (such as login authentication or slider verification) is triggered during task execution, the task will be interrupted. We recommend that you complete operations that require login authentication in a separate session in advance, or reuse an established login state in the task.

If some features are not available under the collaboration mode, you can check for updates to one-click upgrade ArkClaw to the latest version issued by Volcano Engine.

Procedure

Step 1: Enter collaboration mode

Go to the target ArkClaw page.

In the ArkClaw chat box, click the "+" button, and then click the "Enable" button next to Collaboration mode to enter collaboration mode.

tip

When you use the collaboration mode, if the "Install plugin" dialog box pops up, click "Confirm" to install the plugin. After the installation is complete, you can access the collaboration mode chat page.

Step 2 (optional): Configure custom experts

ArkClaw provides preset experts. If they do not meet your scenario requirements, you can configure custom experts when creating a new project. For detailed operations, refer to Add a custom expert.

Step 3: Create and initialize a project

After entering the collaboration mode, you can start a new project by using either of the following methods.

Method 1: Custom creation

Method 2: Template-based creation

Enter the name and goals of the project that requires collaboration in the dialog box.

Suggestions:

Specify the task scope, outputs, and timeline clearly. The more specific the goals, the better the collaborative task completion.

Recommended example: Complete the e-commerce mini-program MVP within 1 week, including product browsing, ordering, and payment features.

Not recommended: Create a project.

Configure team members.

Intelligent member matching (recommended): Click the "+ Custom member > Intelligent member matching" button.

Based on the project name and goals you entered, the system automatically matches and recommends the most suitable team from the pool of available members (typically consisting of one project manager and multiple execution members).

This feature applies to the following scenarios:

You are using the collaboration mode for the first time and are unsure which roles to use.

You want to quickly get a system-recommended team plan to reduce the time spent on project setup.

Manual configuration of team members: Click the "+ Custom member" button, then select "Preset expert" or "Custom expert" as needed.

After the configuration is complete, click the button. After submission, ArkClaw starts the project initialization process.

(Optional) View recommended members or adjust the team.

View recommended members: After initialization, the system displays a list of members to join the team on the page. We recommend that you pay more attention to the following content:

Role coverage: Whether the member responsibilities cover the core tasks required for the project.

Matching reason: Hover over a member's avatar to view the specific reason behind the system recommendation. This helps you determine if they fit the project requirements.

Adjust the team: Before the project officially starts, if the recommended members do not meet your expectations, click "Configure members". On the project members page in the project details panel, you can add, remove, or replace specific members (for example, adding a custom expert you created).

Step 4 (optional): Configure boot options

After project initialization is completed, the project manager agent will send a confirmation card, prompting you to confirm whether to start the project immediately. Before clicking the Start task button, you can configure the following boot options.

Synchronously create a Feishu project group

warning

Once a project is started, you can no longer create a Feishu project group for it. To use this feature, create a new project and enable "Synchronously create a Feishu group" before starting the task.

To sync the project execution process and results to Feishu in real time and interact directly with ArkClaw in a group chat, you can follow the steps below to configure and create your dedicated Feishu project group.

tip

After configuration completes, you can directly reuse this bot to synchronously create a project group for a new collaborative project.

As ArkClaw is designed as a personal AI assistant, using it in group chats may pose risks such as credential leakage. Use it with caution.

Create and integrate a dedicated bot.

If you have associated the Feishu channel with the primary agent (ArkClaw intelligent assistant) but have not enabled the group creation permission, you can skip this step and proceed to enable the group creation permission.

In the main chat interface of the project, turn on the "Synchronously create a Feishu group" toggle and click the "Start project" button. The system will prompt you to associate the Feishu channel. Click the "Associate Feishu channel" button to go to the ArkClaw intelligent assistant page.

Click the "Connect Feishu" button to complete the operation. For detailed steps, refer to Quickly create and integrate a bot.

After successful pairing, your ArkClaw instance automatically restarts to apply the configuration. Please wait patiently.

Grant the bot the Create group permission.

The permission to create a group does not require review. The setting takes effect immediately, and you do not need to publish the application.

You can grant the permission to create a group in the following two ways:

Method 1: In the project
Method 2: In the Feishu Open Platform
After the instance restarts, select "My tasks > Target collaborative project" in the left navigation pane.
In the main chat interface of the project, turn on the "Synchronously create a Feishu group" toggle and click the "Start project" button. The system will display an insufficient permissions message. Click "Feishu permissions" to navigate to the authorization page.
Select the "Create group" permission, and click the "Confirm authorization" button.
Log in to the Feishu Open Platform, select the "Custom Apps" tab, and click the Feishu application you created.
In the directory tree on the left, select "Development Configuration" > "Permissions & Scopes", and click the "Add permission scopes to app" button.
In the Add permission scopes to app pane, select the "Tenant token scopes" tab, check the "Create group" permission, and click the "Add Scopes" button.

Enable synchronization in the project.

After the instance permission takes effect, return to the ArkClaw instance page. In the left navigation pane, select "Collaborative projects > Target project".

In the main chat interface of the project, make sure to enable "Synchronously create a Feishu group".

After the configuration, click the "Start project" button to officially start the project.

Step 5: Dialogue interaction and collaboration

After starting the project, you can converse directly with the AI project manager, issue instructions, provide additional materials, or track project progress.

tip

Running multiple projects concurrently in a Starter ArkClaw instance may consume excessive instance resources, which causes slow or no system responses. To ensure the best experience, we recommend that you keep only 1 project running at a time in a Starter instance.

The main interaction rules are as follows:

Centralized communication

You only need to communicate with the project manager. The project manager is responsible for understanding your requirements, breaking them down into specific tasks, and assigning them to other AI experts in the team.

View task progress and output

Although you cannot directly communicate with other team members, you can check each member's work progress and output in the following ways:

At the top of the chat box, click the button to enter the task list and view task progress.

Click the "Open" button next to the output file to preview the detailed content of the output file. You can also download the file to your local device.

Reference output files

During collaboration, you can use the reference feature to import output files as context into the current chat. The system displays referenced items as visual cards and uses the full context to better understand your commands for further analysis, processing, and task optimization.

Procedure

At the top of the chat box, click the button to enter the task list.

In the expanded task list, click the "Open" button next to the target output file.

Select the file or folder you want to reference as needed.

After selection, the referenced output file/folder will appear in the input box as icon-based text link highlighted in blue.

Before you send a message, confirm whether the referenced task or file information is correct.

In the text box, specify a command for the team (for example, "Optimize the layout of this task output" ) and send the message. After you send the message, the referenced content and your command are saved in the conversation history.

The system automatically parses the referenced context and initiates follow-up actions based on your latest command. You can view the progress and final results directly in the execution process or task list.

Last updated: 2026.06.05 11:41:21