刚接触 OpenClaw 的朋友,总会遇到一堆基础问题找不到地方问。这篇帖子把最高频的问题汇总一遍,按类别整理好,收藏备用。
一、怎么读?
OpenClaw 的官方读法是 Open-Claw,直译「开放之爪」,有时候社区里也叫它「龙虾」(因为爪子的意象)。中文圈有人念 open-爪、有人念 open-克劳,都行,意思到了就行。
二、怎么装?
系统要求:
- Windows 10/11(64位)
- macOS 12 及以上
- Linux:主流发行版均支持,推荐 Ubuntu 22.04+
安装步骤:
- 前往官网或 GitHub Releases 下载对应平台安装包
- Windows 双击
.exe按提示安装;macOS 拖入 Applications;Linux 解压后./install.sh - 首次启动会提示配置 API Key,填写后即可使用
常见安装问题:
- Windows 提示「Windows 已保护你的电脑」:点「更多信息」→「仍要运行」
- macOS 提示「无法验证开发者」:系统设置 → 隐私与安全 → 仍要打开
- Linux 报权限错误:
chmod +x install.sh后重试
三、怎么配置(养)?
装完之后需要做几个基础配置才能正常用:
API Key 配置:
在设置 → API 页面填入你的 Key。支持 OpenAI、Anthropic、国内各大模型。填完记得点「测试连接」确认是否正常。
模型选择建议:
- 日常对话/写作:GPT-4o mini 或 Claude Haiku,省钱
- 复杂任务/代码:GPT-4o 或 Claude Sonnet
- 本地运行:Ollama 接入后选 Llama 系列
工作目录设置:
建议在设置里指定一个固定的工作目录,后续生成的文件、日志都会放在这里,方便管理。
四、怎么用(常见场景)?
- 写作助手:支持长文档输入,可以续写、润色、摘要
- 代码辅助:粘贴代码片段,提问调试
- 文件处理:拖入 PDF/Word,提取内容或问答
- 自动化流水线:配合工作流插件,批量处理任务
- 本地知识库:接入本地文件夹,做 RAG 检索
五、怎么更新?
自动更新:
OpenClaw 默认开启自动检查更新,启动时如果有新版本会弹窗提示,点「立即更新」即可,整个过程大约 1-3 分钟。
手动更新:
帮助菜单 → 检查更新,或者直接去官网下载最新安装包覆盖安装(Windows/Linux 推荐这种方式,更干净)。
更新前建议:
- 备份一下
config.json(在安装目录或~/.openclaw/下) - 如果用了插件,更新后检查一遍兼容性
六、怎么卸载(清理干净)?
Windows:
控制面板 → 程序 → 卸载,然后手动删除 C:Users你的用户名AppDataRoamingOpenClaw 目录(存放配置和缓存)。
macOS:
把 Applications 里的 OpenClaw.app 拖进废纸篓,再删除 ~/Library/Application Support/OpenClaw。
Linux:
运行 ./uninstall.sh,或手动删除安装目录和 ~/.openclaw。
卸载后如果想彻底清除痕迹,注意检查 ~/.config/openclaw(Linux)或注册表(Windows)里是否还有残留。
小结
新手阶段最容易卡在安装和 API Key 配置这两步,只要这两步走通,后面基本就顺了。有其他没提到的问题,评论区说,我或者其他朋友会补充。
你在用 OpenClaw 的过程中遇到过哪些「原来这么简单」的坑? ![]()