# Agent Reach Setup

> agent-reach 的安装和配置引导

- Skill: `wike-chi/agent-reach-setup` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add wike-chi/agent-reach-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wike-chi/agent-reach-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: wike-chi (https://skillmd.com/u/wike-chi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wike-chi/agent-reach-setup

---


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

> **Skill Graph：** 领域 → [[_index-operations|运营自动化领域]]


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

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

## 安装流程

### 步骤1: 安装Agent Reach
```bash
# 解决权限问题
pip install https://github.com/Panniantong/agent-reach/archive/main.zip --break-system-packages
```

### 步骤2: 自动配置
```bash
agent-reach install --env=auto
```

### 步骤3: 验证安装
```bash
agent-reach doctor
```

### 步骤4: 额外配置（可选）
```bash
# 配置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** - 需要代理配置

## 使用示例

### 检查系统状态
```bash
agent-reach doctor
```

### 监控更新和渠道状态
```bash
agent-reach watch
```

### 配置代理（可选）
```bash
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` - 本技能文档

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

# 验证技能安装路径
ls -la {{SKILLS_DIR}}/agent-reach/
ls -la {{SKILLS_DIR}}/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安装和配置解决方案，包含各种问题的实际解决方法。**