開發工具

Agent-Reach 安裝與排錯：為 Claude Code、Codex 接入網頁與多平台搜尋

從安全預覽、安裝和 doctor 檢查開始，為 Claude Code、Codex 等命令列 Agent 設定網頁、GitHub、YouTube、B站及其他平台的讀取能力，並說明登入狀態風險與常見故障。

Agent-Reach 不是新的搜尋引擎，而是一層安裝、路由和健康檢查工具。它會為 AI Agent 選擇網頁讀取、GitHub、YouTube、RSS、B站等渠道所對應的上游工具，並透過 agent-reach doctor 顯示哪些能力目前可用。

如果只想查一份官方文件，普通瀏覽器更簡單；如果希望 Claude Code、Codex、Cursor 或 OpenClaw 連續完成「搜尋、讀取、整理」任務，Agent-Reach 才更有價值。

安裝前先確認邊界

安裝過程可能呼叫 pip，並偵測 Node.js、GitHub CLI 和 MCP 工具。不要直接在正式伺服器或存有重要憑證的主要環境中全自動安裝。更穩妥的順序是：

  1. 先在普通使用者帳號或隔離環境測試。
  2. 先執行 dry run，查看它準備安裝及修改什麼。
  3. 正式伺服器或多人共用機器使用 safe 模式。
  4. Twitter、小紅書、Reddit 等需要登入狀態的平台使用專用小號。

OpenClaw 使用者還要確認 Agent 有執行命令的權限：

1
2

openclaw config set tools.profile "coding"
openclaw gateway restart

Claude Code、Codex、Cursor 這類本來就能執行終端命令的用戶端通常不需要這一步。

建議安裝流程

先安裝或升級 CLI：

1

python -m pip install --upgrade agent-reach

先預覽安裝動作，不修改系統：

1

agent-reach install --env=auto --dry-run

確認輸出中的相依套件、技能目錄和 MCP 設定位置沒有問題後，再選擇安全模式：

1

agent-reach install --env=auto --safe

個人測試機也可以使用預設自動安裝，但仍建議先做 dry run：

1

agent-reach install --env=auto

官方也提供一份可以直接交給 Agent 閱讀的安裝說明：

1
2
3

請用安全模式幫我安裝 Agent Reach：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
安裝時使用 --safe 參數。

安裝後如何驗收

不要只看「安裝成功」，應執行：

1

agent-reach doctor

檢查結果可以分成三類：

狀態 含義 下一步
網頁、YouTube、RSS 可用 零設定渠道已經正常 用公開網址做一次讀取測試
GitHub 公開倉庫可讀 gh 或對應後端正常 私有倉庫需要另外執行 gh auth login
Twitter、Reddit、小紅書不可用 通常缺少登入狀態或 Cookie 按 doctor 提示設定，不要反覆重裝

可以先給 Agent 三個小任務：讀取一個公開網頁、概括一個公開 GitHub 倉庫、擷取一個公開影片的字幕。三項都正常後，再設定需要登入的平台。

平台能力並非全部「裝好即用」

網頁、YouTube、RSS 和部分 GitHub/B站能力可以不登入使用；Twitter、Reddit、小紅書、Facebook、Instagram 等通常需要瀏覽器登入狀態或 Cookie。平台反爬規則會變化，因此「CLI 已安裝」不等於「每個平台永久可用」。

Agent-Reach 的價值在於為同一渠道保留首選和備選後端，並讓 doctor 提供目前路由及修復建議。遇到平台介面失效時，應先更新並重新體檢：

1
2

python -m pip install --upgrade agent-reach
agent-reach doctor

常見故障判斷

找不到 agent-reach 命令

先確認 Python 實際安裝位置：

1
2

python -m pip show agent-reach
python -m site --user-base

如果套件已安裝但命令不存在，多半是 Python Scripts 目錄沒有加入 PATH。重新開啟終端後再檢查，不要連續安裝多個 Python 副本。

Agent 能聊天但不會執行安裝

這通常是用戶端沒有 shell/exec 權限，而不是 Agent-Reach 故障。檢查用戶端工具權限；OpenClaw 則確認 tools.profile 已設為 coding，並在重新啟動 Gateway 後開啟新工作階段。

登入平台突然失效

Cookie 可能過期，平台也可能更換介面或觸發風控。先執行 agent-reach doctor 確認具體失敗渠道，只更新對應登入狀態。不要把主要帳號 Cookie 放進聊天記錄、公開日誌或遠端伺服器。

解除安裝與復原

先預覽會刪除哪些內容：

1

agent-reach uninstall --dry-run

完整解除安裝會清除設定目錄、技能檔案和相關 MCP 設定：

1
2

agent-reach uninstall
python -m pip uninstall agent-reach

如果只想重新安裝技能並保留 Token/Cookie，可以使用：

1

agent-reach uninstall --keep-config

結論

Agent-Reach 適合需要重複執行多平台研究的命令列 Agent 使用者。正確做法不是一次打開全部渠道，而是先 dry run、安裝零設定能力、執行 doctor 驗收，再按需要增加登入平台。這樣更容易判斷失敗發生在用戶端權限、上游工具還是平台登入狀態，也能降低帳號和憑證風險。

參考資料