Agent 与 Skills约 9 分钟

Agent-Reach 怎么安装？一句话命令装好并自检

Q: 安装之后怎么确认装好了？

答：跑 agent-reach doctor 。它会探测每个渠道是否真实可用、当前走哪条后端，坏掉的渠道还会教你怎么修，等于给所有联网渠道做完一次体检。

AI 指南·更新于 2026-09-22·◉ 0 浏览

Agent-Reach 是一个给 AI Agent 一键装上互联网能力的开源工具，GitHub 当前已有 78k 多 star。它的官方仓库采用 MIT 协议，安装方式很特别：不是让你手动跑一堆 pip 命令，而是把一段 install.md 链接丢给你的 Agent（Claude Code、Cursor、OpenClaw 等），让 Agent 自己完成剩下的下载、装依赖、配渠道。全程免费，本地电脑不需要代理服务器，只有把服务部署到服务器上才要约 1 美元/月。

如果你还没把某个 Agent 接好 MCP 或外部工具，可以先看我们关于MCP 接入和开源 Agent 上手的文章，把基础搭好再来装 Agent-Reach，会顺畅很多。

装之前需要准备什么（国内用户视角）

Agent-Reach 依赖 Agent 能执行 shell 命令，所以你至少需要：

一个能跑命令行的 Agent，如 Claude Code、Cursor、Windsurf，或开源的 OpenClaw
Agent 能上网（它要去拉取 GitHub 上的安装脚本）
目标机器装了 Python 3.10 及以上
建议先装 Node.js 和 gh CLI，Agent 会自动检查，缺了会提示怎么补

国内注意：仓库本体访问 GitHub 可能较慢，作者提供了 AtomGit 同步镜像，便于国内克隆。判断 Agent 是本地电脑还是服务器时，本地一般不需要代理，只有放到服务器上跑才需要（约 1 美元/月）。

如果你还没用它接入过浏览器相关的 Agent 工具，可先看浏览器 MCP 集成教程，再回来装 Agent-Reach 会更快。

一句话安装命令（核心）

官方推荐的安装方式只有一步，把下面这句话复制给你的 Agent（安装脚本原文见官方 install.md）：

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

Agent 读取 install.md 后会自动做这些事：

从仓库安装 agent-reach 命令行工具（自带 yt-dlp、feedparser；注意不要从 PyPI 下载同名包，它不是本项目）
检查 Node.js、gh CLI、mcporter 等系统基建，缺了给提示
检测环境，判断是本地电脑还是服务器
默认只激活 6 个零配置渠道；小红书、Twitter、Reddit、Facebook、Instagram 这些需要登录态的，Agent 会列菜单问你要哪些，点名才装
问你要不要开启系统权限（默认不改文件，只检查）

OpenClaw 用户先确认 exec 权限

如果你用的是 OpenClaw，默认 messaging 配置下 Agent 无法执行命令，必须先开启 exec 权限，否则装不上：

openclaw config set tools.profile "coding"

或在 ~/.openclaw/openclaw.json 里设置 "tools": { "profile": "coding" }。改完重启 Gateway（openclaw gateway restart）并开新对话即可。Claude Code、Cursor、Windsurf 这类平台不受此限制。

手动安装：安全检查优先

想手动装或不想让 Agent 乱改系统，可以自己跑 agent-reach install，有几种模式：

方式	命令	适合场景
默认安全检查	`agent-reach install --env=auto`	所有环境；只读检查并列出缺失项，不改文件
显式安装系统依赖	`agent-reach install --env=auto --system`	你明确允许修改当前机器时
兼容安全参数	`agent-reach install --env=auto --safe`	与默认行为相同，更保守
仅预览	`agent-reach install --env=auto --dry-run`	先看看会做什么，适合谨慎用户

默认 agent-reach install 只检查环境，不会自动装系统包或写入配置。只有当你明确允许，才用 agent-reach install --system。这比一把梭更稳妥。

验证安装是否成功：agent-reach doctor

装完是不是真的通了，靠一条命令体检：

agent-reach doctor

它会告诉你每个渠道的当前状态、现在走的是哪条后端链路。这是 Agent-Reach 的核心差异化，其他工具大多是装了就当能用，Agent-Reach 会真实探测每个候选后端：第一个完整可用的当选，坏掉的会给出修复处方（具体链路见官方 README）。

装好就能直接用的渠道（零配置）：

读网页：用 r.jina.ai 网关读任意网页
GitHub：gh repo view owner/repo 读公开仓库
YouTube：yt-dlp 提取字幕
B站：bili search（无需登录，yt-dlp 已被 B站 412 风控封死）
全网搜索：Exa 语义搜索（MCP 接入，免 Key）
订阅 RSS：feedparser 解析

需要登录态的渠道（小红书、Twitter 等），你直接告诉 Agent「帮我配 XXX」，它会一步步引导。

常见报错速查

现象	原因	解法
`agent-reach: command not found`	从 PyPI 装了同名包，非本项目	不要从 PyPI 装，从本仓库装官方 CLI
OpenClaw 装不上/不执行命令	exec 权限没开	`openclaw config set tools.profile "coding"` 后重启 Gateway
B站视频读不了	yt-dlp 已被 B站 412 风控封	换 bili-cli，无需登录可搜可读
需要登录的平台被检测	脚本/API 调用可能触发封号	用专用小号，别用主账号
Cookie 权限报错	Cookie 只在你本地，权限 600	用 Cookie-Editor 手工导出后配置

Cookie 只存在你本机 ~/.agent-reach/config.yaml，文件权限 0600，不上传不外传。代码完全开源，可随时审查。

卸载

agent-reach uninstall

会清掉 ~/.agent-reach/（含所有 token/cookie）、各 Agent 的 skill 文件、mcporter 里的 MCP 配置。想保留配置单独删 skill，用 agent-reach uninstall --keep-config。卸载后如需重装再走前面步骤即可。

想要更多 Agent 技能？

Agent-Reach 本质是把哪个网站怎么读这件事替你选好装好。如果你想给 Agent 配更多可复用的技能包，可看 Omen 上手和 Codex 视频摘要技巧，把 Agent 用得再顺手一点。

结语

一句话装好 Agent 联网能力、agent-reach doctor 一键体检、平台失效自动换后端，这三件事能让 Agent 从只会打字变成能读网页、看 B站、刷小红书。先跑一次 doctor 看看到底哪个渠道能用，再决定要不要动 --system 开系统依赖。

署名：AI345

最后更新：2026 年 9 月

常见问题

Agent-Reach 是免费的吗？

答：是。所有工具都开源、所有 API 免费。唯一可能花钱的是把服务部署到服务器时要代理（约 1 美元/月），本地电脑不需要。Cookie/token 只存在本地，不额外收费。

装 Agent-Reach 一定要手动跑命令吗？

答：不用。复制一句话跟 Agent 说「帮我安装 Agent Reach」，把 install.md 链接丢给它，它会自动下载依赖、装 CLI、激活渠道。想自己掌控节奏，再手动跑 `agent-reach doctor` 体检。

安装之后怎么确认装好了？

答：跑 `agent-reach doctor`。它会探测每个渠道是否真实可用、当前走哪条后端，坏掉的渠道还会教你怎么修，等于给所有联网渠道做完一次体检。

国内网络直接访问 GitHub 仓库，装得动吗？

答：GitHub 直连可能较慢，作者提供了 AtomGit 镜像，便于国内克隆和下载；本地电脑不需要代理，只有部署到服务器才需要代理（约 1 美元/月）。

需要登录的平台会被封号吗？

答：有风险。通过脚本/API 调用 Twitter、小红书等平台，可能被平台检测并封号。务必用专用小号，别用主账号；Cookie 只在本地存储，不主动上传。