OpenClaw怎么读?怎么养?怎么更新?新手常见问题一次解答

刚接触 OpenClaw 的朋友,总会遇到一堆基础问题找不到地方问。这篇帖子把最高频的问题汇总一遍,按类别整理好,收藏备用。


一、怎么读?

OpenClaw 的官方读法是 Open-Claw,直译「开放之爪」,有时候社区里也叫它「龙虾」(因为爪子的意象)。中文圈有人念 open-爪、有人念 open-克劳,都行,意思到了就行。


二、怎么装?

系统要求:

  • Windows 10/11(64位)
  • macOS 12 及以上
  • Linux:主流发行版均支持,推荐 Ubuntu 22.04+

安装步骤:

  1. 前往官网或 GitHub Releases 下载对应平台安装包
  2. Windows 双击 .exe 按提示安装;macOS 拖入 Applications;Linux 解压后 ./install.sh
  3. 首次启动会提示配置 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 的过程中遇到过哪些「原来这么简单」的坑? :point_down:

4 个赞

安装那步我卡了好久,macOS 的「无法验证开发者」弹窗真的劝退了一批人。帖子里说的那个操作路径我之前找不到,以为是系统版本问题,折腾了半个小时,原来就在隐私设置里。现在 Ventura 和 Sonoma 的路径稍微不一样,Sonoma 是「隐私与安全性」里直接有个「仍然打开」的按钮,点一下就行,不用每次都去设置。下次遇到人问这个可以直接甩这条评论给他们。

3 个赞

卸载清理那块建议补充一下:Windows 上 AppDataRoaming 目录默认是隐藏的,新手不知道怎么显示隐藏文件夹的话找不到。可以在文件资源管理器地址栏直接输入 %AppData% 回车,会直接跳到那个目录,然后找 OpenClaw 文件夹删掉就行。还有注册表这块,HKEY_CURRENT_USERSoftwareOpenClaw,洁癖用户可以清一下,普通用户不管也没关系。

2 个赞

更新那里有个细节,如果你用的是便携版(portable),自动更新是不生效的,只能手动下新版本覆盖。这个官方文档里写了但很不显眼,好几个人踩过这个坑,更新弹窗一直没有但版本一直是旧的。

1 个赞

FAQ格式写得很清晰:+1: 建议楼主把「API Key 在哪里申请」也加进去,这个问题估计比「怎么读」问的人还多。新手往往知道要填 Key,但不知道去哪个网站注册,各个模型平台的入口也不一样,单独列一下能省不少人来回问。

1 个赞

本地知识库那块其实坑挺多的,楼主说「接入本地文件夹,做 RAG 检索」这个流程我跑了两遍,索引速度和检索精度都高度依赖你文件的格式规范程度。PDF 扫描版直接炸,必须先跑 OCR。中文文档的分块策略默认也不太理想,建议进阶篇专门写一篇这个方向的详细操作。这一块如果能配上截图就更好了,纯文字描述对真正的新手来说还是有点抽象。我在公司内部整理过一版操作手册,有需要的可以评论区喊一声。

2 个赞