跳到主要内容
项目档案应用项目

IronClaw 安全个人 AI 助手:Rust 开发、本地加密存储、WASM 沙箱,支持多通道与动态工具构建——完整安装使用指南

IronClaw 是基于 Rust 的安全优先个人 AI 助手,专注于隐私保护与能力自扩展。它提供本地加密存储、WASM 沙箱执行、多通道通信(Telegram/Slack 等)和动态工具构建功能。本页面详细介绍其项目定位、安装配置步骤、使用方式及技术架构,帮助用户在保护数据隐私的前提下充分利用 AI 助手。

12,621RustStar 于 2026年3月7日2026年9月19日 更新

AI 总结

IronClaw 是一个用 Rust 编写的安全优先的个人 AI 助手,通过本地加密存储、WASM 沙箱执行和动态工具构建,确保用户数据隐私的同时实现能力自我扩展。

中文项目介绍

IronClaw 定位于成为用户可信赖的 AI 助手,其核心哲学是“你的 AI 助手应该为你工作,而不是对抗你”。它解决传统 AI 助手的数据隐私泄露、功能僵化、缺乏透明控制等问题:所有信息本地存储加密,永不离用户控制;采用开源设计,无隐藏遥测;通过 WASM 沙箱、凭证保护、提示注入防御等多层安全机制加固;并支持动态工具构建与插件扩展,让能力随需增长。 在功能上,IronClaw 提供安全优先的特性,包括 WASM 沙箱执行、凭证泄露检测、提示注入防御和端点允许列表;同时保证 always available,支持多通道(REPL、HTTP webhooks、Telegram、Slack 等)、Docker 沙箱、Web 网关、例程调度、心跳系统和并行作业;并具备自扩展能力,如动态工具生成、MCP 协议集成和插件架构;持久记忆则通过混合搜索、工作空间文件系统和身份文件实现。 技术架构采用模块化 Rust workspace,核心拆分为 common、safety、skills、engine、tui 等独立 crate,抽象支持多种 LLM 后端(NearAI、OpenAI、Anthropic、GitHub Copilot)和数据库(PostgreSQL、libSQL),基于作业的并行执行模型结合自修复机制保障稳定性。适用场景涵盖个人日常 AI 交互、敏感数据自动化、多通道远程控制、自定义工具开发以及需要长期记忆的复杂任务。

详细信息与使用说明

1. 项目定位与用途

IronClaw 是一个安全优先的个人 AI 助手,旨在让 AI 真正为用户服务而非对抗用户。它通过本地加密存储所有数据,确保用户对信息的完全控制;采用开源透明设计,无隐藏遥测或数据收集;支持动态构建新工具,无需等待供应商更新;并实施多层安全防护,防御提示注入和数据外泄。适用于需要高度隐私保护的 AI 交互场景,如个人助理、敏感信息处理和自动化工作流。

2. 解决的问题

传统 AI 助手常面临数据隐私泄露、功能僵化、不透明等风险。IronClaw 针对这些问题提供解决方案:数据始终本地存储加密,防止云端泄露;通过 WASM 沙箱和能力权限隔离不受信任工具;凭证保护机制确保密钥不暴露给工具;提示注入防御和端点允许列表进一步加固安全;同时,动态工具构建和插件架构让能力可随需扩展,打破供应商锁定,实现真正的用户自主。

3. 适用场景

IronClaw 适用于多种场景:作为个人 AI 助手处理日常对话与任务;在敏感数据环境下(如个人笔记、工作机密)进行隐私保护自动化;通过 Telegram、Slack、Discord 等渠道远程交互;开发自定义工具集成,利用 WASM 插件扩展功能;以及需要持久记忆的长期项目,通过混合搜索和文件系统维护上下文。其多通道设计和并行作业能力也适合团队协作或复杂自动化流程。

4. 安装方式

IronClaw 的安装方式在仓库中明确给出:访问 [Releases 页面](https://github.com/nearai/ironclaw/releases/) 下载最新版本。Windows 用户可使用安装器(.msi 文件)或运行 PowerShell 脚本:`irm https://github.com/nearai/ironclaw/releases/latest/download/ironclaw-installer.ps1 | iex`。其他平台(Linux/macOS)的安装步骤未在 README 中明确给出,需参考文档或从源码构建。前置条件包括 Rust 1.85+、PostgreSQL 15+(含 pgvector 扩展)以及 NEAR AI 账户(通过设置向导认证)。

5. 使用方式

使用 IronClaw 需先配置环境变量,模板见 `.env.example`,包括数据库连接、LLM 后端选择(如 nearai、openai、anthropic 等)及认证密钥。启动后,可通过 REPL、HTTP webhooks、WASM 通道(Telegram、Slack)或 Web 网关(浏览器 UI)进行交互。系统支持作业调度,提供工具如 `create_job`、`list_jobs`、`job_status`、`cancel_job` 来管理并行任务;可调整自修复参数优化稳定性。具体命令和高级用法需参考项目文档,README 中未详述。

6. 实现特点

IronClaw 采用模块化 Rust workspace 架构,核心功能拆分为独立 crate:`ironclaw_common` 共享类型与工具,`ironclaw_safety` 专注安全防护,`ironclaw_skills` 管理动态工具与技能,`ironclaw_engine` 负责 LLM 交互与作业调度,`ironclaw_tui` 提供终端界面。它抽象了多种 LLM 后端和数据库(PostgreSQL、libSQL),支持插件化扩展通信渠道(channels-src)和工具(tools-src)。安全设计贯穿始终,包括 WASM 沙箱、凭证注入与泄露检测、提示注入防御等,确保在扩展能力的同时不牺牲隐私。

思维导图

IronClaw
核心引擎
ironclaw_engine
作业调度
沙箱执行
安全模块
ironclaw_safety
凭证保护
提示注入防御
技能系统
ironclaw_skills
动态工具构建
MCP 协议
通信渠道
Telegram
Slack
Discord
Feishu
WhatsApp
用户界面
ironclaw_tui
Web Gateway
公共库
ironclaw_common

常见问题

IronClaw 如何确保我的数据隐私?

所有数据本地存储并加密,永不离用户控制;采用 WASM 沙箱隔离工具、凭证保护防止密钥泄露、提示注入防御等多层安全机制,确保隐私不被侵犯。

支持哪些 LLM 服务商?

支持 NearAI、OpenAI、Anthropic、GitHub Copilot 等多种后端,通过环境变量配置 API 密钥或 OAuth 令牌,并可选择不同模型,满足多样化需求。

如何安装 IronClaw?

Windows 用户可从 releases 页面下载安装器或运行 PowerShell 脚本;Linux/macOS 用户需参考文档从源码构建(步骤未在 README 中明确)。前置条件包括 Rust、PostgreSQL 和 NEAR AI 账户。

如何扩展 IronClaw 的功能?

通过描述需求动态构建 WASM 工具,或连接 MCP 服务器;插件架构支持 drop-in 新工具和通信通道,无需重启,实现能力即时扩展。

IronClaw 是否支持多任务并行?

支持,基于作业(Job)的并行执行模型,每个作业隔离上下文,提供工具管理任务生命周期,并具备自修复机制处理卡住的操作,确保系统稳定。