准备环境：你需要什么

本教程适合完全零基础的读者。你只需要一台能联网的电脑，以及最基本的命令行操作常识（打开终端、输入命令）。

• Python 3.8 或更高版本：Python 是一种编程语言，用来运行我们的 AI 助手。如果你还没装，可以去 python.org 下载安装包，安装时记得勾选“Add Python to PATH”。
• Anthropic API 密钥：这是 AI 模型（Claude）的通行证。去 console.anthropic.com 注册账号，创建一个密钥并复制保存。暂时不需要理解它怎么工作，后面会用到。
• 终端（命令行）：Windows 用户请打开“命令提示符”或“PowerShell”，Mac/Linux 用户打开“终端”。

安装步骤：一步步来

1. 克隆项目代码：在终端输入 git clone https://github.com/your-repo/openosint.git 并回车。如果没有 Git，也可以直接下载 ZIP 压缩包然后解压。
2. 安装 Python 包：进入项目文件夹（cd openosint），然后运行 pip install -r requirements.txt。这会自动安装所有依赖库，包括与 AI 模型通信的 SDK。
3. 设置 API 密钥：在终端输入 export ANTHROPIC_API_KEY=你的密钥（Windows 用户使用 set ANTHROPIC_API_KEY=你的密钥）。这样 AI 助手就能调用 Claude 模型了。
4. 安装可选工具：本 AI 助手能调用外部工具，比如 holehe（检查邮箱注册了哪些网站）和 sherlock（搜索用户名在 300+ 平台的踪迹）。按需安装：pip install holehe sherlock。如果只测试 AI 能力，可以跳过这一步。

验证是否成功：跑通第一次 AI 调用

在终端运行 python repl.py，你会看到一个交互式提示符。输入 帮我查一下 test@example.com，AI 助手会分析你的请求，并自动调用 holehe 工具（如果安装了）来查询。如果一切正常，你会看到工具执行的结果。如果报错，检查 API 密钥是否正确，以及网络是否通畅。

这个 AI 助手的设计非常特别：它不会“编造”结果。当它决定调用工具时，它会暂停并等待真实工具的输出，然后基于真实结果决定下一步。所以你看不到 AI 胡编乱造的信息，只有真实的查询结果。

下一步可以做什么

• 尝试不同的查询，比如用户名、域名，观察 AI 如何自动选择工具。
• 阅读项目中的 agent.py 文件，了解 AI 助手的工作循环。
• 将工具暴露为 MCP 服务器，集成到 Claude Desktop 中使用。