IronClaw怎么下载安装？

IronClaw 是什么？先回答能不能装、怎么装

IronClaw 目前没有公开的独立安装包或官网下载页，它不是一个像“某某输入法”那样双击 exe 就能装的软件。 如果你在搜索引擎里看到“IronClaw 下载”的链接，九成是钓鱼站或捆绑广告。真正获取它的方式是：通过其所属团队（一个专注隐私计算的极客小组）的私有仓库或内测邀请制获取源码自行编译，或者在部分开源镜像站找到社区打包的 AppImage/Flatpak 测试版。 下面我会把三种可行路径、前置依赖和避坑点一次讲透。

一、IronClaw 到底是个什么来头？

IronClaw 是一款面向本地优先（Local-first）场景的开源 AI 个人助手，核心卖点是“断网可用 + 隐私隔离”。它不像 ChatGPT 那样把对话记录传到云端，而是所有模型推理、知识索引、敏感操作都在你本机完成。它由一个小型独立团队 ClawWorks（非上市公司，无融资背景）维护，目前处于 0.9.x 的 Beta 阶段，完全免费，但代码托管在自建的 Git 实例上（不是 GitHub），这也是它“难下载”的根本原因。

核心功能包括：

• 本地 RAG 知识库：支持把 PDF、Markdown、网页剪藏导入，用本地向量库检索，不调用任何外部 API。
• 多模型管理：可接入 Ollama、llama.cpp 等本地推理引擎，也支持通过代理连接 OpenAI 兼容接口，但默认强制关闭云端上传。
• 隐私沙箱：所有对话记录、缓存文件用 SQLCipher 加密，密钥存储在系统 TPM/钥匙串里。
• 命令行 + 轻量 GUI：主力是终端 TUI（终端界面），同时提供基于 Tauri 的桌面壳（Windows/macOS/Linux）。

需要特别提醒：IronClaw 没有官网，官方唯一入口是 ClawWorks 的文档站（https://clawworks.dev），但该站只提供文档和签名公钥，不放安装包。这也是很多用户卡住的地方。

二、三种靠谱的安装路径（按推荐度排序）

路径一：通过 Git 克隆源码自行编译（最推荐，适合有基础的用户）

这是官方唯一支持的方式。你需要先确保系统里有 Git、Go 1.22+、Node.js 20+、Rust 工具链（因为 GUI 部分用 Rust 写的）。具体步骤：

1. 打开终端，执行 git clone https://git.clawworks.dev/ironclaw/ironclaw.git（注意域名不是 .com，是 .dev）。
2. 进入目录 cd ironclaw，执行 make deps 安装依赖，这一步会下载约 1.2GB 的模型依赖（如果你已有本地模型，可以跳过）。
3. 编译核心引擎：make build-core，生成 ironclaw 二进制文件。
4. 编译 GUI 壳：make build-desktop，产物在 dist/ 目录下。

避坑提示： 如果你在国内网络环境，克隆时大概率超时。建议先设置 Git 代理，或者使用镜像站（比如 https://hub.fastgit.org 的镜像，但注意镜像可能滞后一天）。另外，编译过程中如果报 cgo 错误，多半是缺少 gcc 和 libsqlcipher-dev，用系统包管理器装一下即可。

路径二：使用社区维护的 Flatpak 测试版（适合 Linux 桌面用户）

有第三方开发者打包了 Flatpak 包，但不在 Flathub 官方仓库，需要手动添加远程源。执行：

flatpak remote-add --user clawworks https://flatpak.clawworks.dev/repo.flatpakrepo
flatpak install --user clawworks dev.clawworks.IronClaw

装好后在应用菜单里能找到 IronClaw。这个版本滞后主线约两个版本，且不支持自定义模型路径，适合想快速体验的人。

路径三：macOS/Windows 用户：用 Docker 跑核心引擎（最省事）

官方提供 clawworks/ironclaw-core 镜像，但只包含命令行核心，没有 GUI。适合你只是想调用它的 API 或命令行接口。命令：

docker pull clawworks/ironclaw-core:beta
docker run -v /your/local/data:/data -p 7860:7860 clawworks/ironclaw-core:beta

启动后，本地浏览器访问 http://localhost:7860 可以打开一个简易的 Web 聊天界面（注意：这个界面也是本地渲染的，不会上传数据）。

三、下载安装常见问题与解决方案

四、同类工具对比：IronClaw 值不值得折腾？

如果你只是为了“本地 AI 助手”这个需求，其实有更省心的选择。这里给个客观对比：

我的建议是：如果你不是隐私偏执狂，直接用 Ollama + Open WebUI 的组合，半小时就能跑起来，功能还更丰富。IronClaw 目前更适合那些喜欢折腾、且对“代码级可控”有执念的极客。

五、最后说点大实话

IronClaw 的“难下载”本质上是团队刻意为之——他们不想在 Beta 阶段吸引太多小白用户，导致 issue 爆炸。如果你实在搞不定编译，也可以去它的 Matrix 社区频道（在文档站首页有链接）求一个别人编译好的二进制，但注意核对 SHA256 校验和（官方在文档站公布）。千万别从任何第三方博客或网盘下载所谓的“绿色版”，那里面大概率被塞了挖矿脚本。

关于收费：目前完全免费，但文档里提到未来可能会对“高级加密备份”功能收费（类似同步盘），核心功能会一直开源免费。

相关问题

1. IronClaw 支持接入 OpenAI 的 API 吗？
支持，但需要你在配置里显式开启 allow_external_api = true，并且所有请求会经过本地代理，日志会脱敏。不过这与它的隐私定位相悖，不推荐。

2. 本地跑 IronClaw 需要什么显卡配置？
纯 CPU 也能跑，但 7B 模型生成速度约 5 token/s，体验较差。建议至少 8GB 显存（NVIDIA 卡）跑 13B 量化模型，或者用 Apple Silicon 的 Mac 统一内存跑。

3. IronClaw 和 LangChain 这类框架是什么关系？
没关系。IronClaw 是一个完整的应用，LangChain 是开发库。IronClaw 内部自己实现了 RAG 管道，不依赖 LangChain。

4. 如果我只想用命令行，不装 GUI 行不行？
完全可以。核心二进制 ironclaw 本身就支持交互式问答、文档导入等命令，GUI 只是壳。

5. 这个项目会跑路吗？毕竟团队太小了。
有风险，但代码是 AGPL 协议的，即使团队解散，任何人可以 fork 继续维护。目前仓库 commit 活跃度还行（每周 20+ 次提交）。