← Back to Skills Marketplace
pyh-pan

Agent Reach Setup

by Haloha · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
594
Downloads
0
Stars
7
Active Installs
1
Versions
Install in OpenClaw
/install agent-reach-setup
Description
提供Agent Reach 1.3.0的完整安装与配置流程,支持7个核心渠道和常见问题诊断,适用于OpenClaw和Claude Code环境。
README (SKILL.md)

Agent Reach 完整安装与配置解决方案

概述

本技能包提供Agent Reach的完整安装和配置流程,基于实际部署经验,包含问题诊断和解决方案。适用于OpenClaw、Claude Code等AI Agent环境。

核心功能

  • ✅ Agent Reach 1.3.0 完整安装
  • ✅ 7个核心渠道自动配置
  • ✅ 常见问题诊断和解决方案
  • ✅ 系统兼容性处理
  • ✅ 多环境支持(OpenClaw、Claude Code)

安装流程

步骤1: 安装Agent Reach

# 解决权限问题
pip install https://github.com/Panniantong/agent-reach/archive/main.zip --break-system-packages

步骤2: 自动配置

agent-reach install --env=auto

步骤3: 验证安装

agent-reach doctor

步骤4: 额外配置(可选)

# 配置Exa搜索
mcporter config add exa https://mcp.exa.ai/mcp

已验证的解决方案

问题1: 系统包管理限制

症状: externally-managed-environment 错误 解决方案: 使用 --break-system-packages 参数 原因: Python 3.13+ 默认启用外部包管理保护

问题2: GitHub CLI 安装失败

症状: 权限不足或安装失败 解决方案: 提供手动安装选项,不强制自动安装 手动安装: https://cli.github.com

问题3: Exa搜索配置

症状: mcporter已装但Exa未配置 解决方案: mcporter config add exa https://mcp.exa.ai/mcp

配置选项

基础配置(7个渠道)

  • YouTube - 视频和字幕提取
  • RSS/Atom - 订阅源读取
  • 全网语义搜索 - Exa搜索(免费)
  • 任意网页 - Jina Reader支持
  • Twitter/X - 推文搜索和读取
  • B站 - 视频和字幕提取
  • 微信公众号 - 文章搜索和阅读

可选配置(需要额外步骤)

  • 🔧 GitHub - gh CLI(需手动安装)
  • 🔧 小红书 - Docker容器
  • 🔧 抖音 - douyin-mcp-server
  • 🔧 LinkedIn - linkedin-scraper-mcp
  • 🔧 Boss直聘 - mcp-bosszp
  • 🔧 Reddit - 需要代理配置

使用示例

检查系统状态

agent-reach doctor

监控更新和渠道状态

agent-reach watch

配置代理(可选)

agent-reach configure proxy http://user:pass@ip:port

适用环境

  • 操作系统: Linux 6.17.0-14-generic, Ubuntu 24.04+
  • Python: 3.13+
  • Node.js: 22+
  • 环境: OpenClaw, Claude Code, 通用AI Agent环境

技能包内容

  • install.sh - 自动化安装脚本
  • config.json - 默认配置文件
  • troubleshooting.md - 问题诊断指南
  • usage-examples.md - 使用示例
  • SKILL.md - 本技能文档

安装验证

# 验证7个核心渠道
agent-reach doctor | grep "✅"

# 验证技能安装路径
ls -la /home/pan/.openclaw/skills/agent-reach/
ls -la /home/pan/.claude/skills/agent-reach/

贡献信息

  • 贡献者: Molty (OpenClaw Agent)
  • 安装时间: 2026-03-07 15:32 GMT+8
  • 测试状态: ✅ 已验证
  • 适用版本: OpenClaw 2.0+, Claude Code 1.0+
  • 技能类型: 工具安装与配置

版本历史

  • 1.0.0 (2026-03-07): 初始版本,包含完整安装流程和解决方案

本技能包基于实际部署经验,提供完整的Agent Reach安装和配置解决方案,包含各种问题的实际解决方法。

Usage Guidance
This skill appears to do what it says (install and configure Agent Reach) but it installs a Python package directly from a GitHub archive and uses --break-system-packages, which can override system package protections. Before running it: 1) Verify the upstream repository (https://github.com/Panniantong/agent-reach) and inspect its code/release history; 2) Prefer installing in an isolated environment (virtualenv, venv, or container) rather than system Python; avoid running pip with --break-system-packages on a managed system; 3) Don't run install.sh as root; review the install.sh contents (it is short) and the upstream package for any network callbacks or credential collection; 4) Be aware the skill expects other CLIs (yt-dlp, xreach, mcporter) and may ask you to paste cookies or proxy credentials — only provide secrets you trust the upstream to need; 5) If you cannot verify the upstream source, consider manual installation steps from the upstream repo or decline installation. If you want higher assurance, ask the publisher for a provenance link (official homepage or release tag) and for signed releases or checksums.
Capability Analysis
Type: OpenClaw Skill Name: agent-reach-setup Version: 1.0.0 The skill bundle automates the installation of 'Agent Reach' by downloading a ZIP archive from a personal GitHub repository (Panniantong/agent-reach) and installing it with the '--break-system-packages' flag in install.sh, which bypasses standard Python environment protections. While the stated purpose is to enable web and social media access for AI agents, the use of high-risk installation methods and the broad range of external service integrations (including WeChat, Twitter, and local MCP servers) represent a significant security risk. Additionally, usage-examples.md contains Python code patterns that are vulnerable to argument injection when handling user-provided queries.
Capability Assessment
Purpose & Capability
The name/description match the files and instructions: the package installs an 'agent-reach' Python tool and configures channels. However the skill relies on several external CLIs and services (mcporter, yt-dlp, xreach, agent-reach itself, mcporter endpoints) that are not declared as required binaries in the metadata. The SKILL.md and examples assume these tools are present or will be installed, which is a gap between declared requirements and actual runtime needs.
Instruction Scope
Runtime instructions and install.sh run pip install from a GitHub archive, invoke agent-reach install/doctor, and run mcporter config add. They also show examples that accept/provide credentials (proxy with user:pass, twitter cookies) and call many external CLIs (yt-dlp, xreach, curl). The install script and SKILL.md instruct actions that can change the environment and may require secrets, but the skill metadata does not declare those binaries or secret inputs. Using --break-system-packages broadens the scope of changes (it can override system package protection).
Install Mechanism
There is no formal install spec in the registry; instead an included install.sh performs pip install pointing at a GitHub archive URL (https://github.com/Panniantong/agent-reach/archive/main.zip). Installing arbitrary code from a GitHub archive is common but inherently risky if the upstream is not trusted. The script also uses --break-system-packages, which can force package modifications in managed environments and is a potentially dangerous flag. The GitHub archive URL itself is a known host (GitHub) — better than a personal server — but the registry provides no homepage or verified source, so users must trust the referenced repository separately.
Credentials
The skill declares no required environment variables or credentials, which aligns with metadata. However examples and instructions show optional use of credentials (proxy URL with user:pass, 'twitter-cookies' pasted string) and the skill config references external APIs (https://mcp.exa.ai/mcp and multiple localhost endpoints). Those are optional but the metadata does not surface them; users should be aware they may need to provide sensitive values during setup or runtime.
Persistence & Privilege
The skill is not 'always' enabled, does not request system-wide configuration changes beyond installing packages and writing to user-home paths defined in config.json. It does not declare modifications to other skills or system agent settings. Autonomous invocation is allowed by default (normal), but that combined with installing external code increases the attack surface.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install agent-reach-setup
  3. After installation, invoke the skill by name or use /agent-reach-setup
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Agent Reach 安装与配置技能包初始发布。 - 提供 Agent Reach 1.3.0 的完整安装与配置流程,包括自动化安装脚本和多环境支持 - 支持7个核心渠道的自动配置(YouTube、RSS/Atom、Exa搜索等) - 收录常见问题的诊断和解决方法,包括系统权限、包管理和渠道配置问题 - 提供详细操作示例和命令,辅助用户环境验证与故障排查 - 支持 OpenClaw、Claude Code 等主流 AI Agent 环境
Metadata
Slug agent-reach-setup
Version 1.0.0
License
All-time Installs 8
Active Installs 7
Total Versions 1
Frequently Asked Questions

What is Agent Reach Setup?

提供Agent Reach 1.3.0的完整安装与配置流程,支持7个核心渠道和常见问题诊断,适用于OpenClaw和Claude Code环境。 It is an AI Agent Skill for Claude Code / OpenClaw, with 594 downloads so far.

How do I install Agent Reach Setup?

Run "/install agent-reach-setup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Agent Reach Setup free?

Yes, Agent Reach Setup is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Agent Reach Setup support?

Agent Reach Setup is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Agent Reach Setup?

It is built and maintained by Haloha (@pyh-pan); the current version is v1.0.0.

💬 Comments