Clawbot异常处理

网页客户端

1. 在对话页面点击右上角CloudSpace全屏。

2. 点击进行重启。

手机客户端

1. 在对话页面右上角点击切换至分屏视图。

2. 点击进行重启。

桌面客户端

1. 在对话页面点击右上角分屏视图。

2. 点击进行重启。

云端Clawbot

1. 在对话页面尝试是否可以正常聊天。

2. 如果对话页面无法正常聊天，点击右上角CloudSpace全屏，然后点击左下角OpenClaw图标直接与OpenClaw尝试聊天。如果可以正常聊天，点击右上角重启CloudSpace。待CloudSpace重启后可返回对话页面尝试聊天。

3. 如果无法在CloudSpace中直接与OpenClaw聊天，可在CloudSpace中打开Terminal并执行如下命令openclaw doctor -fix尝试修复，执行完成后重启CloudSpace。

4. 如果重启后仍无法恢复，可进一步排查网关服务状态：

   1. 在 CloudSpace 终端执行 openclaw gateway status 查看网关运行状态。

   2. 执行 ps aux | grep openclaw 检查 openclaw-gateway 进程是否存在。

   3. 若进程未运行，执行 openclaw gateway start 启动网关服务。

   4. 若启动网关后报错"503 No available channel"或仍显示离线不重连，组合执行 openclaw doctor --fix 和 openclaw gateway restart，随后点击界面重启按钮。

5. 如果仍无法正常聊天，可进入CloudSpace，在Terminal中进入~/.openclaw/目录，备份目录下openclaw.json文件并将其删除，随后再重启CloudSpace。

本地Clawbot

1. 退出客户端然后重新进入。

   说明

   需要退出而不是仅关闭客户端。

2. 在本地电脑上查找~/.jvs/.openclaw/openclaw.json文件，查看配置是否有错误，进行修复。

3. 在本地电脑上查找~/.jvs/.openclaw/openclaw.json文件并进行删除，再打开客户端尝试自动修复。

   重要

   删除前请注意进行备份。

为什么 Bot 在线且有积分，但提示"服务暂不可用"、"bot不可用"或无法生成结果？

可能由以下原因引起，请逐项排查：

1. 客户端缓存或进程异常：通过任务管理器结束 JVS 进程后重新登录，或在客户端对话页面更多选项/附件位置点击修复按钮。

2. 上下文超限（报错"100% content used"）：输入 /new 新建会话清空上下文，或升级至匠心版/大师版获取更大上下文配额。

3. CloudSpace 环境异常：确认 CloudSpace 处于运行状态并尝试重启。

4. 本地配置文件损坏：备份并重命名本地 C:\Users\{用户名}\.jvs\.openclaw\openclaw.json 文件，彻底退出并重启客户端触发自动修复。

5. 本地缓存数据异常（无响应但扣费）：重命名本地 C:\Users\{用户名}\AppData\Local\Temp\jvsclaw-sdk-data 文件夹后重新登录。

为什么任务执行超时、无回复或输出不完整，但积分已被扣除？

扣费原因：OpenClaw 接收请求后即开始推理并消耗积分，若任务复杂超过默认超时时间，系统会自动结束任务，此时积分已扣除但未生成完整回复。服务异常重启时重复拉取未 ACK 消息也可能导致循环扣费。

优化建议：

• 将大任务拆分为多个小步骤分批执行。

• 避免一次性发送过多文本数据，降低单次上下文累积量。

• 新建对话窗口，避免历史上下文混乱干扰任务派发。

• 若定时任务中断，可直接询问 Bot"请分析并说明导致本次会话中断的具体原因"以获取排查信息。

调用技能或模型时报错"400 Input data may contain inappropriate content"或 Webfetch 访问网站被拦截怎么办？

该问题分两类场景：

内容安全拦截：报错由平台绿网安全机制触发。建议调整输入内容为清晰、客观的业务化表达，或新建会话规避敏感上下文。若确认为误判，请提供请求时间、requestId 及完整报错信息，联系技术支持以便安全团队加白处理。

反爬虫限制：使用 Webfetch 访问百度、招聘网站等时遇到验证码或被拦截，属于浏览器自动化能力的常见限制，目前暂无内置绕过方案。建议调整搜索关键词、使用具体 URL，或直接通过自然语言指令让 AI 尝试访问。遇到验证码时需人工接管处理。

修改配置、开启 TUN 模式或重置环境后出现异常或数据丢失怎么办？

请注意以下操作限制与风险，避免引发不可恢复的异常：

1. 禁止手动修改配置文件：JVS 为定制化产品，不支持直接修改配置文件调用其他模型。如需切换模型，请通过控制台添加模型功能操作，否则易导致服务崩溃或连接失败。

2. 禁止开启全局 TUN 模式：该操作存在安全风险，可能导致 JVS 访问自身服务的流量受阻，引发离线或无法登录。

3. 上下文配置限制：本地部署环境将上下文调至 1M 会超出系统限制，导致服务离线，请勿修改该配置。

4. 重置风险：重置 JVS Claw 相当于重新初始化环境，原有本地数据及配置将被永久清除且无法恢复，操作前务必备份重要文件。

5. 版本差异：云端与本地版本可能存在差异，导致部分技能无法安装，请等待官方版本更新。

积分余额显示异常、试用记忆丢失或定时任务未执行如何处理？