常见问题
这里收集了新手最常遇到的问题和解决方案。
安装问题
Mac 提示「无法打开，因为它来自身份不明的开发者」
解决方案：
- 打开「系统偏好设置」→「安全性与隐私」
- 点击「仍要打开」
- 或在终端运行：
xattr -cr /Applications/OpenClaw.app
Windows 安装失败
可能原因：
- 杀毒软件拦截
- 权限不足
解决方案：
- 临时关闭杀毒软件
- 右键「以管理员身份运行」
配置问题
API Key 无效
检查项：
- 确认 API Key 是否正确复制（无多余空格）
- 确认 API Key 是否过期
- 确认账户是否有余额
连接超时
可能原因：
- 网络问题
- 代理配置
解决方案：
- 检查网络连接
- 在设置中配置代理
使用问题
AI 回复中断
可能原因：
- 网络不稳定
- 回复过长被截断
解决方案：
- 输入「请继续」让 AI 继续回复
- 检查网络连接
知识库文件无法读取
检查项：
- 文件格式是否支持
- 文件是否损坏
- 文件大小是否超限
技能无法使用
解决方案：
- 检查技能是否正确安装
- 重启 OpenClaw
- 查看技能文档确认使用方法
其他问题
如何备份数据？
OpenClaw 数据存储在本地：
- Mac:
~/.openclaw/ - Windows:
%USERPROFILE%\.openclaw\ - Linux:
~/.openclaw/
复制此目录即可备份。
如何更新 OpenClaw？
- 应用会自动检测更新
- 或在「设置」→「关于」中检查更新
- 也可重新下载最新版本覆盖安装
数据安全吗？
- 所有对话数据存储在本地
- API Key 本地加密存储
- 不会上传到第三方服务器