给你的 OpenClaw装上互联网：Agent-Reach 安装、配置与使用全指南

摘要：Agent-Reach 是一款开源的 AI Agent 技能插件（Skill），能让 Claude Code、OpenClaw、Cursor 等 Agent 一键接入互联网，覆盖 Twitter、YouTube、B站、小红书等 11+ 平台。本文从安装到配置到实际使用，手把手带你走一遍完整流程。

---

一、Agent-Reach 是什么？

用过 OpenClaw 或 Claude Code 的同学大概都有一个感受——Agent 什么都好，就是上不了网。它读不了链接、刷不了推、看不了视频，遇到需要联网的任务就只能干瞪眼。

Agent-Reach 就是来解决这个问题的。

简单一句话概括：它是一个给 AI Agent 装上互联网能力的开源 Skill。底层集成了 xreach CLI、yt-dlp、Jina Reader、Exa、mcporter 等一系列开源工具，不依赖任何付费 API Key，完全免费。

• GitHub 地址：https://github.com/Panniantong/Agent-Reach
• 兼容平台：OpenClaw、Claude Code、Cursor、Windsurf
• 支持渠道：网页、YouTube、Twitter/X、B站、小红书、抖音、Reddit、GitHub、LinkedIn、微信公众号、RSS

---

二、安装

Agent-Reach 提供了三种安装方式，按推荐程度排序。

2.1 让 Agent 自己安装（推荐）

这是最省心的方式。直接在你的 Agent 对话框里发送以下内容：

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

Agent 会自动完成以下步骤：

1. 通过 pip install 安装 agent-reach 命令行工具；
2. 检测当前系统环境；
3. 安装所需的系统依赖（Node.js、gh CLI、mcporter、xreach 等）；
4. 运行健康检查，报告各渠道状态。

整个过程通常在几分钟内完成。

小贴士：如果你对自动安装系统包有顾虑，可以追加"安全模式"指令：

帮我安装 Agent Reach（安全模式）：... 安装时使用 --safe 参数

安全模式只会列出需要安装的依赖清单，不会自动执行安装。

2.2 手动 pip 安装

适合希望自己掌控安装过程的用户。要求 Python 3.10+。

pip3 install --upgrade pip
pip3 install agent-reach

# 验证（输出版本号即为成功）
agent-reach --version

# 运行完整安装（自动检测环境并安装依赖）
agent-reach install --env=auto

2.3 作为 Skill 直接注册

npx skills add Panniantong/Agent-Reach@agent-reach

2.4 安装后验证

agent-reach doctor

---

三、平台支持与配置

3.1 各平台配置一览

平台	装好即用	配置后解锁	配置方式
网页	阅读任意网页	—	无需配置
YouTube	字幕提取 + 搜索	—	无需配置
RSS	阅读任意 RSS/Atom 源	—	无需配置
全网搜索	—	全网语义搜索	MCP 自动接入
GitHub	公开仓库读取 + 搜索	私有仓库、Issue/PR	告诉 Agent「帮我登录 GitHub」
Twitter/X	读取单条推文	搜索、时间线、发推	Cookie 认证
B站	本地环境可用	服务器环境	配置代理
小红书	—	阅读、搜索、发帖	Cookie 认证
抖音	—	视频解析、无水印下载	Cookie 认证

3.2 Twitter 配置

1. Chrome 安装 Cookie-Editor 扩展；
2. 登录 Twitter/X → Cookie-Editor 导出；
3. 执行：

agent-reach configure twitter-cookies "<导出的 Cookie>"

3.3 代理配置

agent-reach config set proxy.http "http://127.0.0.1:7890"
agent-reach config set cache.ttl 3600

---

四、使用方式

核心原则：你不需要记任何命令。 Agent 读取 SKILL.md 后就知道该调用什么工具，用自然语言描述需求即可。

场景	对 Agent 说	命令行方式
阅读网页	帮我看看这个链接	—
视频总结	帮我总结这个视频	—
Twitter 搜索	搜一下最近关于 XX 的讨论	agent-reach fetch twitter "XX" --latest 20
小红书抓取	看看小红书上关于 XX 的笔记	agent-reach fetch xiaohongshu "XX" --days 7
GitHub 搜索	找一下 star 超过 100 的 XX 项目	agent-reach fetch github "XX" --stars 100+
跨平台批量	—	agent-reach fetch multi "AI" --platforms twitter,bilibili

---

五、架构 & 卸载

模块化设计，每个渠道一个独立 Python 文件，互不耦合：

channels/
├── web.py  → Jina Reader    ├── twitter.py  → xreach
├── youtube.py → yt-dlp      ├── github.py   → gh CLI
├── xiaohongshu.py → mcporter └── rss.py      → feedparser

卸载命令：

agent-reach uninstall --dry-run      # 预览
agent-reach uninstall --keep-config  # 保留 token
pip uninstall agent-reach            # 完全移除

如果觉得有帮助，欢迎 点赞 👍 收藏 ⭐ 关注 🔔，有问题评论区见！

---

本文为原创内容，转载请注明出处。