IronClaw 简介、安装使用方法与案例应用

下载或构建

仓库建议查看 Releases 页面获取最新二进制或安装程序。README 提到 Windows Installer 可直接下载运行。

配置（Setup / onboard）

首次配置通过命令行向导：

ironclaw onboard

向导会负责：数据库连接设置、NEAR AI 的浏览器 OAuth 认证、以及把机密保存到系统密钥链并写入数据库。某些引导变量（如 DATABASE_URL、LLM_BACKEND）会写入 ~/.ironclaw/.env 以便在数据库启动前使用。

2、使用方法

常用运行命令（示例）

# 启动交互式 REPL
cargo run

# 启动并开启 debug 日志
RUST_LOG=ironclaw=debug cargo run

# 第一次 onboard（如上）
ironclaw onboard

这些命令出自 README 的'Usage'部分。

通道与插件安装（举例：Telegram）

仓库提供 docs/TELEGRAM_SETUP.md，说明如何为 IronClaw 配置 Telegram 通道：

• 支持 Webhook（推荐）与 Polling（可选、约 30s 延迟）模式；
• 在 ironclaw onboard 向导中启用 Telegram 通道并粘贴 Bot Token；向导会验证 token，并可配置 webhook secret 与 tunnel（ngrok / cloudflared）等；
• 支持 DM pairing（配对）流程用于控制谁能与 agent 交互（需管理员手动批准配对码）。

开发 / 测试（本地）

仓库同样列出常见开发命令：

# 格式化代码
cargo fmt

# Lint
cargo clippy --all --benches --tests --examples --all-features

# 运行测试
createdb ironclaw_test
cargo test
# 或运行指定测试
cargo test test_name

IronClaw 的案例应用

示例用来说明如何把 IronClaw 用到实际场景：

1) 作为个人／团队的'离线/可控'智能助理

将 IronClaw 部署在自有服务器或本地机器（数据库在 Postgres），所有会话与工具调用都记录在本地数据库，凭证加密存储，适用于希望把敏感数据留在自己控制下的个人或小团队。该用例基于项目'数据本地化、无遥测'的设计理念。

2) 聊天通道：Telegram（实战）

借助 docs/TELEGRAM_SETUP.md，可把 IronClaw 作为 Telegram Bot 使用，支持：

• Webhook 模式（需要将本机暴露到 HTTPS，推荐使用 ngrok 或 cloudflared）；
• Polling 模式（无 tunnel 时可用，但有 ~30 秒延迟）；
• DM Pairing：当陌生用户发起 DM，会收到配对码；管理员通过 ironclaw pairing approve telegram <CODE> 批准后该用户才能交互（有效的访问控制流程）。

常用命令示例（文档中）包括：列出待配对请求 ironclaw pairing list telegram、批准配对 ironclaw pairing approve telegram ABC12345、以及在向导中保存 telegram_bot_token 等。

3) 自动化与后台任务（Routines / Webhooks）

可以利用 Routines（cron-style）与 webhook handlers 把 IronClaw 用作自动化引擎，例如按计划拉取/处理信息、监测任务并执行工具链（WASM 工具），这些都以'并行作业、隔离上下文'的方式执行，适合后台自动化场景。

4) 开发自定义工具（WASM）与集成

IronClaw 支持把自定义工具编译为 WASM 并以 capability 限权方式加载（channels-src 下有现成通道模板），适用于把现有脚本/功能打包成安全的工具供 agent 使用。文档也提到如果修改了通道源（例如 Telegram），需要运行 ./channels-src/telegram/build.sh 在构建前把更新的 WASM 打包进二进制。