Docs

ArkClaw Enterprise

FAQ

ArkClaw usage FAQ

Category	Issue
Cost-related questions	Is ArkClaw a free or paid product?
Installation and deployment	What is the difference between local deployment and cloud deployment?
		What is the difference between ArkClaw and ArkClaw in ModelArk Playground?
		What is the difference between the Feishu official plugin and the plugin in the OpenClaw community?
Use ArkClaw	Common ArkClaw error information and solutions
		Why can't I find files or upload or download files to or from my TOS bucket?
		Will my custom configuration and data in ArkClaw be deleted after a restart or auto‑healing?
		What should I do if an error occurs during restoration?
		What should I do to continue using ArkClaw after the complimentary ArkClaw included with Coding Plan Pro expires?

Cost-related questions

Is ArkClaw a free or paid product?

ArkClaw is a paid product that uses a prepaid billing model (pay first, use later). You can subscribe to ArkClaw monthly or daily. For details, see Billing method and description.

tip

If you buy ArkClaw now, you can enjoy the first purchase discount promotion and regular discount package for a more cost-effective service.

Installation and deployment

What is the difference between local deployment and cloud deployment?

ArkClaw fully manages the security, operations, and environment configuration required for local deployment. ArkClaw retains all local deployment capabilities (OpenClaw) while significantly reducing usage barriers and security risks. The detailed differences are as follows:

Dimension	Local deployment (OpenClaw)	Cloud deployment (ArkClaw)
Deployment method	Requires self-procurement of servers, environment configuration, and dependency installation. High technical barrier.	Supports creating out-of-the-box ArkClaw with one click, without O&M required.
Network security	The control port is easily exposed to the internet without authentication protection, making it vulnerable to attacker scanning and exploitation, which may cause unauthorized device takeover.	Deployed within the VolcanoEngine security network. You do not need to open internet ports, which is secure and reliable.
Plugin security	Provides third-party skills not uniformly reviewed. This poses security risks such as malicious plugins stealing keys or implanting trojans.	All preset skills have passed malicious code scanning and security audit, with security ratings included for safer use.
High-risk operation protection	No built-in protection mechanism. Accidental operations, such as executing rm -rf, will cause system crashes.	Automatically intercepts high-risk operations through pre-execution intent recognition. Critical operations require a second confirmation. All code runs safely in a sandbox environment.
Data isolation	Shares the runtime environment with the host machine. Data security must be configured by the user.	Runs on independent ECS instances. User data is isolated and stored, accessible only to the owner.
Maintenance cost	Requires manual monitoring, version updates, and troubleshooting, which consume significant, continuous time and effort.	The platform offers fully automatic O&M, which is stable online 24 hours a day, 7 days a week, and can reduce overall usage costs by over 60%.

What is the difference between ArkClaw and ArkClaw in ModelArk Playground?

ArkClaw and ArkClaw in ModelArk Playground are the same product accessed via different entries.

ArkClaw

Refers to ArkClaw purchased and managed via the ArkClaw console.

You can purchase multiple ArkClaw of different specifications at the same time (including Starter, Standard, and Premium). Learn more.

Supports all features such as multiple sessions, backup/restoration of ArkClaw data, and migration from OpenClaw to ArkClaw. Learn more.

User experience improvements and new features are continuously being updated and released.

ArkClaw in ModelArk Playground

Refers to ArkClaw created via ModelArk Playground.

Only supports activating one ArkClaw (default configuration: Starter), and does not support specification selection.

Only supports some features, such as configuring message channels and skills, and does not support the latest ArkClaw features.

tip

To continue using ArkClaw created in ModelArk Playground after it expires, you can activate VolcanoEngine ModelArk ArkClaw or quickly purchase a new ArkClaw.

What is the difference between the Feishu official plugin and the plugin in the OpenClaw community?

Dimension	Feishu official plugin	OpenClaw community plugin
Source	Developed and maintained by VolcanoEngine or Feishu officially.	Contributed by community developers.
Security	Passed official security review and code audit.	Security varies, and supply chain risks exist.
Permission model	Follows the principle of least privilege. All operations require explicit authorization, making security more controllable.	No unified permission model. This may easily cause excessive permission applications.
Stability	Officially maintained with continuous updates.	Maintained by the community with uncertain update frequency.
Feishu integration	Uses a native deep integration solution, capable of calling all core capabilities.	May only be compatible with some features and cannot use all capabilities.
Target users	Users who need to use Feishu as their core work platform or require deep integration with various Feishu features.	Users who only need to use Feishu as a message entry, and are not concern the compatibility with Feishu features.

Use ArkClaw

Common ArkClaw error information and solutions

Error message	Error cause	Solution
API rate limit reached Your ArkClaw has been temporarily rate-limited. Please wait.	The Coding Plan has a usage quota limit, and your current ArkClaw has reached the limit.	Go to Coding Plan console to view quota-related details and the quota refresh time. You can continue using it after the quota is refreshed. If you are using Coding Plan Lite, you can go to Coding Plan console to upgrade to Coding Plan Pro and increase model call quota. Adjust the inference model. You can use models from ModelArk "Foundation models" to provide inference services for ArkClaw. This has no quota limit but incurs additional charges.
Range of input length should be [1, 30720]	The input length for a single request exceeds the maximum context length of ArkClaw.	We recommend reducing the length of each input or sending input in batches to ArkClaw.
No API key found for provider "xxxx"	ArkClaw cannot call the inference model because no model API Key has been configured.	You can tell ArkClaw the model API Key in the conversation.
401 The API key format is incorrect	The configured API Key format is invalid, or a relay key was used.	Reconfigure the API Key or use an official API Key. ArkClaw does not support third-party Keys.
400 Total tokens of image and text exceed max message tokens. Request id:	The content of a single session is too long and exceeds the inference model context limit.	We recommend using quick commands /new to compress sessions or create a new session.

Why can't I find files or upload or download files to or from my TOS bucket?

Possible causes are as follows:

Configuration and association-related reasons

Cloud disk not configured

Since the basic configuration of the iDrive has not been completed for ArkClaw, the system has no available storage target. Configure the cloud disk.

Cloud disk configuration exception

The configuration information is incorrect or has not taken effect. Reconfigure the cloud disk. For details, see Configuring cloud disks.

ArkClaw has not been associated with TOS

TOS configuration has been completed, but ArkClaw has not been associated with the corresponding storage bucket. Files will be stored in the local path by default. Reconfigure the cloud disk to complete the association. For details, see Configuring cloud disks.

Storage, synchronization, and permission-related reasons

TOS storage package has not been purchased

The TOS storage package may not have been activated. Activate the TOS service first.

tip

Using a TOS bucket incurs additional fees. For specific billing standards and service rules, see Storage capacity fees.

Why do I have overdue payments after purchasing a resource package?

Files are stored locally only and not synchronized to TOS

ArkClaw by default stores generated files in the local path /root/.openclaw/workspace. Without explicit synchronization instructions, files will not be automatically uploaded to TOS. You need to upload files via the TOS cloud disk.

TOS billing delay

TOS calculates usage for all billing items on an hourly basis, generates bills based on usage, and applies resource package deductions. Newly purchased resource packages or recently uploaded files may not be reflected immediately. We recommend checking the remaining resource package balance again after receiving the bill before use.

Unsupported storage type

ArkClaw only supports TOS buckets as cloud disk storage media. Uploading or reading files via GitHub, group files, email, or other methods will fail, and the corresponding files cannot be found. Please upload/download files via iDrive.

Will my custom configuration and data in ArkClaw be deleted after a restart or auto‑healing?

No.

The restart process only involves restarting the ArkClaw service and does not affect configuration or data.

During restarting or auto-healing, only the corrupted configuration items are fixed. All custom configuration, chat history, skill files, and other items that do not cause ArkClaw service failures are fully preserved.

What should I do if an error occurs during restoration?

Save the error information and obtain support via feedback.

What should I do to continue using ArkClaw after the complimentary ArkClaw included with Coding Plan Pro expires?

After your subscribed Coding Plan Pro expires, you can continue to use ArkClaw using any of the following methods:

Method 1: Renew Coding Plan Pro (recommended)

If you want to continue using ModelArk Coding Plan Pro, please go to the ModelArk console to . After successful renewal, the system will automatically align the validity period of ArkClaw with that of Coding Plan, allowing you to continue using ArkClaw free of charge.

Method 2: Switch to Coding Plan Lite

To switch to Coding Plan Lite and retain ArkClaw for use, follow these steps:

Activate ArkClaw: Go to the ArkClaw console to activate. After the activation succeeds, the system will retain the historical data of your ArkClaw.

Switch model package: 24 hours after the original Coding Plan Pro expires, go to the VolcanoEngine console and subscribe to Coding Plan Lite.

tip

Click the target ArkClaw card to view its expiration time.

Method 3: Activate ArkClaw separately

To retain historical data without subscribing to any Coding Plan, and to continue using ArkClaw with third-party large models, you can follow these steps:

ArkClaw activated separately no longer includes the exclusive large model usage benefits covered by the original Coding Plan.

Activate instance: Go to ArkClaw console to activate. After the activation succeeds, the system will retain the historical data of your ArkClaw.

Configure model: After the activation succeeds, you need to reconfigure inference models. You can configure third-party models for continued use.

Community

We recommend using the Feishu application to scan the QR code and join the community group chat. This enables you to get online help for usage questions and exceptions.

Last updated: 2026.04.28 19:37:32