OpenClaw常见问题汇总
- 本文档整理了OpenClaw使用过程中的常见问题，并且会持续更新。
- 如果遇到报错，可以先行查阅本文档。
- 如果仍未解决，欢迎发送邮件至hpc@sjtu.edu.cn询问。
目录
报错初步自检排查
终端报错
- 报错信息
command not found- 对Openclaw的所有操作都需要在云主机上完成，请确认是否已经远程登录到云主机。登录方式参考登录云主机。
- 报错信息：
ssh: connect to host xxx port 22: Connection timed out
机器人对话不响应
可以尝试以下步骤进行检查和恢复：
- 在机器人聊天界面输入
/stop停止当前对话，然后再输入/new开启新对话。 - 在命令行软件中，输入
openclaw gateway status查看Openclaw服务状态，输入openclaw channels list查看飞书机器人状态。 - 如果存在问题，可以在命令行软件中，输入
openclaw doctor进行配置检查和自动修复。
机器人无法被修复
如果对机器人造成了无法修复的破坏，且云主机上没有必须要保留的内容，可以尝试重置机器人，或者重建云主机。
- 重置机器人：在命令行软件中，登录云主机并重新运行一次
./claw_install.sh。 - 重建云主机：
- 在弹性云服务器列表页面，点击云主机最右侧的更多，点击删除。
- 在弹出的窗口中，勾选下方的两个复选框，点击确定。
- 等待片刻后，云主机完成删除，即可按照部署教程重新创建云主机。
- 在弹性云服务器列表页面，点击云主机最右侧的更多，点击删除。
大模型API报错
如果遇到大模型API相关报错，请检查：
- Base URL填写是否正确？应填写：
https://models.sjtu.edu.cn/api/v1 - API Key是否过期失效？修复请参阅此文档：API Key失效，如何替换？
- 其他申请和使用相关问题，请参阅此文档：本地大模型API使用文档
“致远一号”云主机安装部署
登录致远一号平台提示审核中
当前，只有拥有“致远一号”平台的OpenClaw内测资格的用户才能登录平台创建云主机。内测资格将逐步发放，请关注后续推送。
ssh超时无法登录
- 问题描述
- 使用终端远程登录”致远一号“云主机时，显示报错：
ssh: connect to host xxx port 22: Connection timed out
- 使用终端远程登录”致远一号“云主机时，显示报错：
- 解决方案
- 在弹性云服务器列表，点击左侧导航栏的安全组。
- 在弹出的安全组页面中，选择default的配置规则。
- 在配置规则页面，选择快速添加规则。
- 在常见协议端口中，勾选SSH；在源地址中，选择0.0.0.0/0；然后点击确定，即可完成配置。
- 在弹性云服务器列表，点击左侧导航栏的安全组。
安装脚本不存在
- 问题描述
- 使用快速部署脚本时，显示
-bash: ./claw-install.sh: No such file or directory
- 使用快速部署脚本时，显示
- 解决方案：可能是使用了过早版本的镜像，可以删除云主机重建，步骤可参考重建云主机。
忘记云主机密码
- 问题描述
- 忘记云主机密码导致无法远程登录云主机.
- 解决方案：重设密码。
- 在弹性云服务器列表页面，点击云主机最右侧的更多，点击重置密码。
- 在弹出的窗口中，输入新密码，并勾选重启云服务器复选框，点击确定。
- 等待云主机重启后，即可使用新密码登录。
- 在弹性云服务器列表页面，点击云主机最右侧的更多，点击重置密码。
飞书、微信等插件安装使用
Powershell二维码显示不正常
- 问题描述
- 关联飞书、微信等机器人时需要扫描二维码，在Powershell中的二维码显示不正常。
- 解决方案
- 在窗口的下拉框里选择设置。
- 在左侧导航栏选择默认值。然后，点击其他设置中的外观。
- 找到字体一栏，选择Cascadia Mono。显示即可恢复正常。
在飞书中找不到创建的机器人
- 手机端：可以在更多->工作台->全部应用里找到。
- 电脑端：可以在搜索框中搜索机器人的名字。
飞书、微信插件安装报错
- 问题描述
- 安装或更新微信、飞书插件时，可能出现以下报错：
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
- 安装或更新微信、飞书插件时，可能出现以下报错：
- 解决方案
- 执行以下命令：
NODE_OPTIONS="--max-old-space-size=2048" - 然后，重新执行插件安装命令，即可成功安装：
- 执行以下命令：
Openclaw使用
上下文过长
- 如果希望保留上下文内容，可以在聊天框中输入
/compact，来压缩上下文的体积。 - 如果希望开启新对话，可以在聊天框中输入
/new，开始一个全新的对话。
无法搜索网络内容
- 使用快速脚本部署的OpenClaw已经安装浏览器功能，但OpenClaw不一定会自己调用，只需要在提示词里明示使用浏览器搜索xxx即可实现网络搜索。
更新升级后报错
OpenClaw版本更新比较频繁，可能会出现不稳定或者与插件不兼容的情况。如果出现共性问题，我们将在此处更新修复教程。
2026.3.28
- 问题描述：更新OpenClaw后，飞书机器人无响应。
- 问题来源：OpenClaw的3.28版本更新与飞书插件不兼容，需要将⻜书插件更新到3.29或更新版本。
- 修复操作步骤请参阅此文档：OpenClaw3.28故障修复手册