## ArkClaw 异常问题当您的 ArkClaw 出现配置文件损坏、依赖缺失、服务异常等问题时，可参考本文档进行快速恢复，尽可能减少对业务使用的影响。 > ArkClaw 拥有文件系统读写权限，运行过程中会修改自身配置文件，可能导致配置文件损坏、依赖缺失、服务异常等问题，进而影响正常使用。 ### 一、若ArkClaw出现无法对话、服务无响应、新增 skill 或配置修改不生效、系统资源耗尽等非配置损坏？您可以尝试通过 [重启 arkclaw](https://www.volcengine.com/docs/87732/2266924) 解决。 ### 二、若插件异常、配置异常导致的 ArkClaw 服务启动失败、无法连接？可能原因： * **插件异常**：插件格式不规范、依赖包缺失、版本不兼容导致服务启动失败。 * **配置异常**：核心配置文件损坏、格式错误、权限配置错误导致服务无法启动/联通。您可以尝试通过 [自动修复 ArkClaw](https://www.volcengine.com/docs/87732/2270355) 解决。 :::tip 自动修复功能默认会自动备份数据至以下路径，您无需担心数据丢失。若有需要可通过 [终端](https://www.volcengine.com/docs/87732/2270411) 查看。 * 插件修复：备份路径`/home/invalid-plugins/your-plugin`。 * 配置异常：备份路径`~/.openclaw/openclaw.json.fix-bak.fixtime`。 ::: ### 三、服务彻底损坏，通过 [重启 Arkclaw](https://www.volcengine.com/docs/87732/2266924) 和 [自动修复 ArkClaw](https://www.volcengine.com/docs/87732/2270355) 均无法解决？您可以通过恢复出厂设置进行修复，操作如下： 1. 请先备份原 ArkClaw 中的全部用户数据，包含自定义技能、聊天记录、个性化配置、上传的文件等。 1. 配置要挂载的 TOS 桶作为网盘，存放备份数据，详情请参见 [配置网盘](https://www.volcengine.com/docs/6396/2227963#j8phYkJ4) 。 2. [进入终端](https://www.volcengine.com/docs/87732/2270411) ，执行如下命令，完成TOS 桶目录定义与指定层级工作目录创建，为程序运行配置专属存储路径。 ```Bash export YOURTOSDIR={{your-tos-dir}} #TOS备份目录名称 mkdir ~/.openclaw/workspace/$YOURTOSDIR/.openclaw #主目录名称 mkdir ~/.openclaw/workspace/$YOURTOSDIR/.openclaw/workspace #子目录名称 ``` :::tip 请将`{{your-tos-dir}}`替换为您实际使用的 TOS 备份目录名称。 ::: 3. 按需执行如下命令，备份对应数据。 * 自定义技能（Skills） ```Bash cp -r ~/.openclaw/workspace/skills ~/.openclaw/workspace/$YOURTOSDIR/.openclaw/workspace ``` * 配置信息 ```Bash cp -r ~/.openclaw/openclaw.json* ~/.openclaw/workspace/$YOURTOSDIR/.openclaw ``` * 记忆（Memory ） ```Bash cp -r ~/.openclaw/memory ~/.openclaw/workspace/$YOURTOSDIR/.openclaw ``` * 聊天记录 ```Bash cp -r ~/.openclaw/agents ~/.openclaw/workspace/$YOURTOSDIR/.openclaw ``` * 备份 SOUL、IDENTITY 等配置 ```Bash cp -r ~/.openclaw/workspace/*.md ``` 2. 重新初始化ArkClaw服务，将其重置为最初的可用状态，详情请参见 [恢复出厂设置](https://www.volcengine.com/docs/87732/2270307) 。 3. （可选）恢复数据 :::tip 备份数据本身存在异常，**不建议进行恢复操作**，以免再次引发服务问题。 ::: 1. 将 [对象存储（TOS）](https://www.volcengine.com/docs/6349)挂载至新的 ArkClaw ，详情请参见 [配置网盘](https://www.volcengine.com/docs/6396/2227963#j8phYkJ4)。 2. [进入终端](https://www.volcengine.com/docs/87732/2270411) ，并执行如下命令，进入备份目录。 ```Bash export YOURTOSDIR={{your-tos-dir}} #TOS备份目录名称 ``` 3. 按需执行如下命令，恢复对应数据。 * 自定义技能（Skills） ```Bash cp -r ~/.openclaw/workspace/$YOURTOSDIR/.openclaw/workspace/skills ~/.openclaw/workspace ``` * 配置信息 ```Bash cp -r ~/.openclaw/workspace/$YOURTOSDIR/.openclaw/openclaw.json* ~/.openclaw/ ``` * 记忆（memory ） ```Bash cp -r ~/.openclaw/workspace/$YOURTOSDIR/.openclaw/memory ~/.openclaw/ ``` * 聊天记录 ```Bash cp -r ~/.openclaw/workspace/$YOURTOSDIR/.openclaw/agents/main/sessions ~/.openclaw/agents/main/ ``` * 备份 SOUL、IDENTITY 等配置 ```Bash cp -r ~/.openclaw/workspace/$YOURTOSDIR/.openclaw/workspace/*.md ~/.openclaw/workspace ``` ## 其他问题 ### 一、重启/自动修复会丢失我自定义配置和数据吗？不会。重启仅重启服务进程，自动修复仅修改损坏的配置项，所有合法的用户自定义配置、聊天记录、Skill 文件都会完整保留，修复前会自动生成备份。 ### 二、恢复过程中遇到报错怎么办？请保存好报错日志，选择“设置 ** \>** 问题反馈”联系获取帮助。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d6d0a055afb61c4f6f965ae6bb547a31.png =222x)