IronClaw：注重隐私的本地 AI 助手

项目简介

IronClaw 是一个用 Rust 编写的「Agent OS」，定位是安全、私密、可扩展的个人 AI 助手。它的设计原则是：AI 助手应当为你服务，而不是反过来。所有信息都存放在本地并加密，没有遥测和数据采集，代码开源可审计。

项目提供命令行入口与浏览器 WebUI，可以接入不同的 LLM 提供商，并通过 WASM 插件不断扩展自己的能力。

主要功能

安全优先

• WASM 沙箱：不受信任的工具运行在隔离的 WebAssembly 容器中，采用基于能力的权限模型
• 凭据保护：密钥不会暴露给工具，只在宿主边界注入，并带泄漏检测
• 提示注入防御：模式检测、内容净化与策略执行
• 端点白名单：HTTP 请求只允许发往显式批准的 host 与路径

持续可用

• 多渠道：REPL、HTTP webhook、WASM 通道（Telegram、Slack）以及 Web Gateway
• Docker 沙箱：隔离容器执行，按任务发放 token，采用 orchestrator/worker 模式
• Web Gateway：浏览器界面，支持 SSE / WebSocket 实时流式输出
• Routines：cron 定时、事件触发、webhook 处理等后台自动化
• 心跳系统：主动执行后台监控与维护任务
• 并行任务：多个请求并发处理，上下文相互隔离
• 自修复：自动检测并恢复卡住的操作

自我扩展

• 动态构建工具：描述需求后，IronClaw 会把它构建成一个 WASM 工具
• MCP 协议：可连接 Model Context Protocol 服务器扩展能力
• 插件架构：无需重启即可加入新的 WASM 工具与通道

持久记忆

• 混合检索：全文检索 + 向量检索，使用 Reciprocal Rank Fusion 融合
• 工作区文件系统：用路径灵活存放笔记、日志与上下文
• 身份文件：跨会话保持统一的人格与偏好

安装与使用

在 Releases 页面 选择 ironclaw-v* 标签，将 X.Y.Z 替换为对应版本（含预发布后缀），在 macOS、Linux 或 Windows/WSL 上执行：

IRONCLAW_RELEASE_TAG=ironclaw-vX.Y.Z
curl --proto '=https' --tlsv1.2 -LsSf \
  "https://github.com/nearai/ironclaw/releases/download/${IRONCLAW_RELEASE_TAG}/ironclaw-installer.sh" | sh

然后运行引导式安装：

ironclaw onboard

在引导流程中选择 LLM 提供商、输入的 API key 会被隐藏，随后接受默认模型或填写其他模型。IronClaw 会生成本地配置、加密凭据库和 WebUI 登录 token；在 macOS 与 Linux 上还会安装并启动后台服务，最后打印打开 WebUI 的链接。

ironclaw status

用于检查服务状态并再次打印登录链接。Windows 用户可以用 ironclaw serve 在前台启动 WebUI。

Windows 另外提供 MSI 安装包（ironclaw-x86_64-pc-windows-msvc.msi）与 PowerShell 脚本安装：

$IronClawReleaseTag = "ironclaw-vX.Y.Z"
irm "https://github.com/nearai/ironclaw/releases/download/$IronClawReleaseTag/ironclaw-installer.ps1" | iex

从源码构建需要 Rust 1.96+ 与 Node.js 22+（含 Corepack/pnpm）：

git clone https://github.com/nearai/ironclaw.git
cd ironclaw
corepack enable pnpm
cargo install --locked --path crates/app/ironclaw_cli

配置

ironclaw onboard 是主要配置入口，默认把状态写入 $HOME/.ironclaw/reborn，并将所选 LLM 凭据存入加密的本地密钥库，重复运行时会保留已有配置。

ironclaw status
ironclaw models status
ironclaw config list

切换提供商并存下对应 API key：

ironclaw models set-provider openai --model gpt-5-mini
ironclaw config set openai.api_key

其他设置使用同样的命令，例如：

ironclaw config set google.client_id YOUR_CLIENT_ID
ironclaw config set google.client_secret
ironclaw config set google.redirect_uri YOUR_REDIRECT_URI
ironclaw config set webui.token --rotate

注意事项

• 秘密值不接受位置参数，IronClaw 会以不回显的方式提示输入。
• Slack、Telegram 等通道没有配置文件设置项，也没有 CLI 启用开关：需安装扩展并在 WebUI 的 Extensions 页面完成配置，通道才会提供服务。
• 配置写入不会自动重启服务，影响运行中服务的改动需要执行 ironclaw service restart。
• 完整支持的配置键见 ironclaw config set --help。

数据保护

所有数据存储在 IronClaw 的本地应用状态中，密钥使用 AES-256-GCM 加密，没有遥测、分析或数据分享，并保留所有工具执行的完整审计日志。

---

本作品整理自 GitHub 开源项目 nearai/ironclaw，原作者 @nearai，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。