IronClaw (v0.22.0) 安装（没图很干）

没问题，我已经帮你把这篇安装记录重新整理并排版成了清晰、结构化的 Markdown 格式。这个排版逻辑分明，非常适合直接复制发布到各大技术论坛。

IronClaw 最新版 (v0.22.0) 纯净安装与详细配置教程

因为我之前安装过，最干净的做法是直接清空 IronClaw 的二进制和配置目录，再重新装最新版本。虽然没查到官方单独提供“一键卸载”脚本，但我看之前的安装日志，它主要装在 /root/.cargo/bin，运行数据在 ~/.ironclaw，所以直接删这两处最彻底。当前官方最新 release 是 0.22.0。

1. 彻底卸载旧版本

先执行以下命令清理残留进程和文件：

pkill -f '^ironclaw run$' 2>/dev/null; rm -f ~/.cargo/bin/ironclaw ~/.cargo/bin/ironclaw-update; rm -rf ~/.ironclaw

2. 安装最新版本 (v0.22.0)

使用官方 0.22.0 release 页面给出的 Linux 安装脚本：

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/nearai/ironclaw/releases/download/ironclaw-v0.22.0/ironclaw-installer.sh | sh

3. 初始化与配置向导

安装完成后会进入交互式配置流程，按以下步骤选择即可：
开局按回车进入

◉ 数据库连接 (Database Connection)

系统会提示选择数据库后端：

• [1] PostgreSQL - 生产级，需要运行服务器
• [2] libSQL - 内置 SQLite，零依赖
  操作：输入 2 (选择 libSQL)。
• Database file path: 直接按 Enter (回车) 保持默认路径 /root/.ironclaw/ironclaw.db。
• Enable Turso cloud sync?: 输入 n 或直接 Enter (回车)。

◉ 密钥存储 (Keychain)

选择 Master Key 的存储方式：
操作：输入 2 (Environment variable)，适合服务器环境。

◉ AI 模型接口 (Inference Provider)

选择大模型 API 供应商：
操作：由于我使用的是第三方提供的自定义 baseurl，这里选择 [7] OpenAI-compatible。

• API Key: 复制并粘贴你的 API 密钥。
• Base URL: 输入第三方提供的接口地址。
• Model Name: 手动输入 gpt-4o（或你实际使用的模型名称）。

◉ 向量检索 (Embeddings / Semantic Search)

提示：Enable semantic search? [Y/n]
操作：直接按 Enter (回车) 或输入 y，开启工作区的记忆检索功能。

◉ 隧道配置 (Channel Configuration - Tunnel)

提示：Configure a tunnel? [y/N]
操作：直接输入 n 或按 Enter (回车)。选 y 通常需要安装 Cloudflared 或设置反向代理，对新手来说配置比较繁琐。

◉ 沟通渠道 (Channels)

操作：使用方向键下移到 Telegram。按一次 空格键 勾选为 [✓] 后，再按 Enter (回车)。

• Telegram Bot API token: 填入你从 @BotFather 申请到的 Token。

◉ 插件工具 (Tools)

操作：建议保持默认设置，或者根据需求增减。核心必选推荐：

• Web Search (必选)：让你的机器人能联网查资料，这是 AI 助手的灵魂。
• LLM Context (必选)：配合联网搜索，提供更准确的背景信息。

◉ Docker 沙箱机制 (Docker Sandbox)

提示：Enable Docker sandbox? [y/N]
操作：直接输入 y 并回车。开启沙箱可以限制 AI 的系统权限，防止它误删服务器里的文件。

◉ Claude Code 模式

提示：Enable Claude Code sandbox mode? [y/N]
操作：输入 y。如果你的 API 支持 Claude Code，开启后可以调用 Claude 的专业能力在 Docker 里写代码。

• 注意：如果因为没有 Anthropic 官方凭证报错 No Anthropic credentials found，提示 Retry after setting up credentials? [y/N] 时，直接输入 n 跳过即可。这只是关闭了 Claude 专用沙箱模式，刚才配置好的 Telegram 机器人和基础 AI 功能依然可以正常运行。

◉ 后台心跳任务 (Background Tasks)

提示：Enable heartbeat? [y/N]
操作：直接输入 y 并回车。如果你之前勾选了 Gmail 或 Google Calendar，开启心跳任务能让机器人在后台自动检查日程和邮件通知，而不是等你问它时才去查。

• Check interval in minutes: 默认 30，直接按 Enter (回车)。
• Notify channel on findings: 输入 telegram 并回车。

4. 启动与绑定 Telegram

启动机器人

在终端输入以下命令启动服务：

ironclaw run

完成设备配对

1. 去 Telegram 里给你的机器人随便发一条信息，它会回复你一条带有配对命令的乱码。
2. 复制机器人发给你的那行蓝色命令（例如：ironclaw pairing approve telegram LX3JYDMQ）。
3. 回到你的 VPS 终端（SSH 窗口），直接粘贴并按回车即可完成配对！

💡 结语
整个配置过程中，最容易卡住的是 API Key / Base URL / Model Name 的配置。因为每个人使用的接口商都不一样，如果你拿到 Key 不知道怎么配，建议直接把服务商的说明截图发给 AI 问一下。

这个排版效果符合你的预期吗？如果你想在帖子的开头或结尾加上特定的个人介绍，或者需要补充一些关于 VPS 环境的细节，随时告诉我！