机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

架构

功能

• 🤖 多模型支持 – 支持 OpenAI、Claude、Gemini、Mistral、OpenRouter、Ollama 或任何兼容 OpenAI 的 API（LM Studio、llama.cpp、Groq 等）。
• 🌐 网页界面 – 基于 Streamlit 的界面，用于交互式调查。
• 🔌 MCP 支持 – 可通过任何支持 MCP 的代理运行 Robin，使用该代理自己的模型。详见 Robin 作为 MCP。
• 💬 对话式跟进 – 针对调查提出有根据的后续问题，无需重新运行搜索，从该调查自身的数据中获取答案。
• 🔀 一键切换 – 根据调查结果推荐的后续查询；点击即可启动新的调查。
• 🐳 Docker 就绪 – 推荐使用 Docker 部署，实现干净、隔离的使用环境。

⚠️ 免责声明

此工具仅用于教育和合法的调查目的。根据您的司法管辖区，访问或与某些暗网内容互动可能是非法的。作者不对任何滥用此工具或使用其收集的数据负责。

请负责任地使用并自行承担风险。在进行开源情报调查之前，确保您遵守所有相关法律和机构政策。

此外，Robin 利用第三方 API（包括大语言模型）。在发送可能包含敏感信息的查询时要小心，并查看你使用的任何 API 或模型提供商的服务条款。

安装

Docker [推荐]

• 拉取最新的 Robin Docker 镜像

  docker pull apurvsg/robin:latest

• 在你运行的文件夹中创建一个 .env 文件，并在其中放入你的 API 密钥（参见 .env.example ）。请在第一次运行前创建它：如果它不存在，Docker 会挂载一个空文件夹，而 Robin 会在没有密钥的情况下启动。

  touch .env   # then add your API key to it

• 运行 Docker 镜像为：

  docker run --rm \
  -v "$(pwd)/.env:/app/.env" \
  --add-host=host.docker.internal:host-gateway \
  -p 8501:8501 \
  apurvsg/robin:latest

docker run --rm \
   -v "$(pwd)/.env:/app/.env" \
   -v robin-investigations:/app/investigations \
   --add-host=host.docker.internal:host-gateway \
   -p 8501:8501 \ apurvsg/robin:latest

Docker 运行 --rm \
   -v "$(pwd)/.env:/app/.env" \
   -v "$(pwd)/investigations:/app/investigations" \
   --add-host=host.docker.internal:host-gateway \
   -p 8501：8501 \ apurvsg/robin：latest

• 打开浏览器并导航到 http://localhost:8501。

自行构建

如果要运行自己的构建而不是发布的镜像，请克隆仓库并进行构建：

docker build -t robin .

然后使用相同的运行命令，将 apurvsg/robin:latest 替换为 robin：

docker run --rm \
   -v "$(pwd)/.env:/app/.env" \
   --add-host=host.docker.internal:host-gateway \
   -p 8501:8501 \
   robin

docker run --rm \
   -v "$(pwd)/.env:/app/.env" \
   -v "$(pwd)/investigations:/app/investigations" \
   --add-host=host.docker.internal:host-gateway \
   -p 8501:8501 \
   robin

• 打开你的浏览器并访问 http://localhost:8501

罗宾作为 MCP

任何能够使用MCP的LLM服务都可以运行它，使用其自身的模型。下面的部分是面向常见主机的工作示例；未列出的主机也以相同方式工作，使用其为“添加MCP服务器”所使用的任何措辞。

Claude 代码

claude mcp add robin -- docker run -i --rm -v robin-investigations:/app/investigations apurvsg/robin mcp

或者将其签入 .mcp.json 项目。Tor 调查只需几分钟，所以提高每个服务器的超时时间：

{
  "mcpServers": {
    "robin": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "robin-investigations:/app/investigations", "apurvsg/robin", "mcp"],
      "timeout": 600000
    }
  }
}

法典

codex mcp add robin -- docker run -i --rm -v robin-investigations:/app/investigations apurvsg/robin mcp

ChatGPT 桌面应用程序共享此主机：在 设置 → MCP 服务器 下添加 Robin，会写入相同的配置，并且其工具会出现在 Codex 会话中，而不是普通的 ChatGPT 聊天中。

Tor 搜索通常需要几分钟，这可能会超过 Codex 默认的 MCP 工具超时，因此请在 ~/.codex/config.toml 中提高限制：

[mcp_servers.robin]
command = "docker"
args = ["run", "-i", "--rm", "-v", "robin-investigations:/app/investigations", "apurvsg/robin", "mcp"]
tool_timeout_sec = 600
startup_timeout_sec = 60

# Only for non-interactive runs (`codex exec`): Codex declines MCP tool calls
# that would need approval, so pre-approve Robin's read-only tools.
default_tools_approval_mode = "approve"

先拉取镜像（docker pull apurvsg/robin:latest），这样第一次启动就不会同时下载。

Claude 桌面版

将此添加到 claude_desktop_config.json 并重启应用：

{
  "mcpServers": {
    "robin": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "robin-investigations:/app/investigations", "apurvsg/robin", "mcp"]
    }
  }
}

赫尔墨斯

In ~/.hermes/config.yaml:

mcp_servers:
  robin:
    command: docker
    args: [run, -i, --rm, -v, "robin-investigations:/app/investigations", apurvsg/robin, mcp]
    timeout: 600

开爪

openclaw mcp add robin --command docker --arg run --arg -i --arg --rm --arg -v --arg robin-investigations:/app/investigations --arg apurvsg/robin --arg mcp

或者在配置中，在 mcp.servers 下：

{
  "mcp": {
    "servers": {
      "robin": {
        "transport": "stdio",
        "command": "docker",
        "args": ["run", "-i", "--rm", "-v", "robin-investigations:/app/investigations", "apurvsg/robin", "mcp"],
        "requestTimeoutMs": 600000
      }
    }
  }
}

ChatGPT

桌面应用的 设置 → MCP 服务器 配置了应用、Codex CLI 和 IDE 扩展共享的 Codex 主机，所以在这里添加 Robin 后，它会出现在 Codex 会话中：参见 Codex。普通的 ChatGPT 聊天无法运行它，因为聊天通过在 OpenAI 基础设施上运行的连接器访问 MCP 服务器，而不是在你的机器上。

安全性

• 没有任何内容会发送、执行或运行 shell。唯一会写入的是保存的报告，保存到 investigations/ 下由 Robin 选择的文件名；代理从不自行命名路径。
• 搜索、网页抓取和搜索引擎健康检查通过 Tor 进行，因此你使用的应用不会自己获取暗网页面。模型提供商调用和模型列表刷新是直接进行的，不通过 Tor。
• 抓取的文本会返回在不受信任的数据分隔符内，首先会去掉控制字符、零宽字符和双向文本字符，所以你的模型将其解读为证据，而不是指令。

致谢

• 灵感来源于 Thomas Roccia 以及他关于 暗网困惑度 的演示。
• 工具灵感来自我在 暗网的 OSINT 工具 仓库。
• LLM 提示灵感来自 OSINT-Assistant 仓库。
• 标志设计由我的朋友 Tanishq Rupaal 完成