Agent Reach 安装使用教程

项目简介

Agent Reach 是一个开源的 AI Agent 互联网能力扩展工具。它能让你的 AI Agent（OpenClaw、Claude Code、Cursor 等）轻松访问 Twitter、Reddit、YouTube、GitHub、B站、小红书等 15 个主流平台，完全不需要付费 API Key，只需提供平台 Cookie 即可。

一句话发给你的 Agent，几分钟后它就能读推特、搜 Reddit、看 YouTube、刷小红书了。安装、配置全自动，Agent 自己搞定一切。

💡
GitHub 地址：
https://github.com/Panniantong/Agent-Reach

核心亮点

支持平台一览

环境要求

• Python：3.8+
• Node.js：推荐安装（部分工具依赖）
• AI Agent：OpenClaw / Claude Code / Cursor / Windsurf 等任意能跑命令行的 Agent
• Docker：可选（小红书等平台的 MCP 服务需要）

⚠️ OpenClaw 用户注意：如果使用默认的 messaging 工具配置，Agent 无法执行 shell 命令。安装前请先开启 exec 权限：openclaw config set tools.profile "coding"

安装步骤

一句话安装（推荐）

复制下面这句话发给你的 AI Agent，它会自动完成所有安装和配置：

帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

agent-reach doctor

帮我配小红书
帮我配 Twitter

手动安装

pip install agent-reach

agent-reach install --env=auto

agent-reach doctor

底层原理

Agent Reach 本质是一个脚手架，帮你把各平台的工具选型和配置做好了。安装完成后，Agent 直接调用上游开源工具：

每个渠道都是可插拔的，不满意某个工具？换掉对应文件就行，不影响其他渠道。

安全提醒

⚠️ 使用专用小号：需要 Cookie 的平台（Twitter、小红书等），请务必使用专用小号，不要用主账号。平台可能检测到非正常浏览器的 API 调用行为，存在封号风险。

• 凭据本地存储：Cookie、Token 只存在你本机 ~/.agent-reach/config.yaml，文件权限 600，不上传不外传
• 安全模式：agent-reach install --safe 不会自动修改系统，只列出需要什么
• 完全开源：代码透明，随时可审查

常见问题

Q: Agent Reach 完全免费吗？

100% 免费。所有后端工具都是开源项目，不需要付费 API Key。唯一可选开销是服务器代理（约 $1/月），本地电脑不需要。

Q: 支持哪些 AI Agent？

支持所有能执行命令行的 Agent：OpenClaw、Claude Code、Cursor、Windsurf、Codex 等。

Q: 小红书访问稳定吗？

小红书使用 MCP 工具通过 Docker 运行，完全模拟人类真实使用环境，非常稳定安全。不过仍建议使用专用小号。

Q: 怎么更新？

一句话：发给你的 Agent「帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」

Q: 怎么卸载？

运行 agent-reach uninstall 即可清除所有配置和 Cookie。卸载 Python 包：pip uninstall agent-reach。