Add NETWORK.md for OpenClaw network routing rules
This commit is contained in:
Chen Gu
+194
@@ -0,0 +1,194 @@
|
||||
# NETWORK.md - OpenClaw 网络访问分层与规则
|
||||
|
||||
更新时间：2026-03-15
|
||||
|
||||
这份文件用于记录 OpenClaw 在当前机器上的网络访问原则，避免以后在“哪些能力该走代理、哪些能力该直连”上反复排查。
|
||||
|
||||
核心原则：
|
||||
|
||||
> **默认直连；Telegram、Google 和部分海外访问按需走 mihomo `127.0.0.1:7897`。**
|
||||
|
||||
---
|
||||
|
||||
## 一、当前代理基础设施
|
||||
|
||||
### mihomo
|
||||
- 本地代理端口：`127.0.0.1:7897`
|
||||
- 用途：作为当前机器统一的按需代理出口
|
||||
- 备注：Clash Verge 已停用，mihomo 接管 `7897`
|
||||
|
||||
### OpenClaw 当前网络思路
|
||||
- **不追求 OpenClaw 全局强制走代理**
|
||||
- 采用“按能力分流”策略：
|
||||
- 能直连的尽量直连
|
||||
- 明确依赖海外链路的能力显式走代理
|
||||
|
||||
---
|
||||
|
||||
## 二、当前分类
|
||||
|
||||
## A. 必须代理
|
||||
|
||||
这些在当前网络环境下，应默认视为必须走代理：
|
||||
|
||||
### 1. Telegram channel
|
||||
- 原因：Telegram API / 连接在当前网络环境下通常无法稳定直连
|
||||
- 当前状态：已在 OpenClaw 配置中显式指定代理
|
||||
- 配置形态：
|
||||
- `channels.telegram.proxy = socks5://127.0.0.1:7897`
|
||||
|
||||
### 2. Gmail / Google Workspace 相关
|
||||
- 包括但不限于：
|
||||
- Gmail
|
||||
- Google Calendar
|
||||
- Google Drive
|
||||
- Google Docs
|
||||
- 其它 Google API
|
||||
- 原因：当前环境下直连容易超时或不可达
|
||||
- 结论：应优先走 mihomo 代理
|
||||
|
||||
---
|
||||
|
||||
## B. 建议直连
|
||||
|
||||
这些目前更适合默认直连：
|
||||
|
||||
### 1. OpenClaw 主聊天链路
|
||||
- 当前主会话：`agent:main:main`
|
||||
- 当前实测模型：`sub2api/gpt-5.4`
|
||||
- 直连实测结果：成功
|
||||
- 代理实测结果：也成功
|
||||
- 结论：**可直连，不依赖代理**
|
||||
|
||||
### 2. `sub2api`
|
||||
- 性质：国内中转端点
|
||||
- 当前结论：走代理反而可能更不稳
|
||||
- 策略：默认直连
|
||||
|
||||
### 3. `lkeap`
|
||||
- 性质：国内链路 provider
|
||||
- 策略：默认直连
|
||||
|
||||
### 4. OpenClaw 本地能力
|
||||
- 文件读写
|
||||
- `exec`
|
||||
- `gateway`
|
||||
- `sessions`
|
||||
- `subagents`
|
||||
- `memory`
|
||||
- 本地工作流与控制面
|
||||
- 策略：不需要代理
|
||||
|
||||
---
|
||||
|
||||
## C. 视场景而定
|
||||
|
||||
这些不应简单归为“全都代理”或“全都直连”，而应根据目标站点决定：
|
||||
|
||||
### 1. `web_search`
|
||||
- 搜索本身通常可用
|
||||
- 但搜索结果指向的目标网页如果是海外站，后续访问可能受影响
|
||||
|
||||
### 2. `web_fetch`
|
||||
- 抓国内站：一般直连即可
|
||||
- 抓海外站：可能需要代理
|
||||
|
||||
### 3. `browser`
|
||||
- 打开国内站：直连
|
||||
- 打开海外站（如 GitHub、Google、海外文档站）：视情况走代理
|
||||
|
||||
### 4. 未来新增海外服务
|
||||
可能包括：
|
||||
- Discord
|
||||
- Slack（部分场景）
|
||||
- X / Twitter
|
||||
- OpenAI / Anthropic 直连
|
||||
- 海外 webhook / SaaS API
|
||||
- 结论：新增后单独归类，不要默认混进“全局代理”
|
||||
|
||||
---
|
||||
|
||||
## 三、当前判断规则
|
||||
|
||||
以后遇到新服务 / 新模型 / 新应用时，按下面顺序判断：
|
||||
|
||||
### Step 1：先判断链路属性
|
||||
这个服务是：
|
||||
- 本地能力？
|
||||
- 国内服务？
|
||||
- 海外服务？
|
||||
- 国内中转？
|
||||
|
||||
### Step 2：优先实测，不靠印象
|
||||
至少做两种测试：
|
||||
- 直连是否成功
|
||||
- 经 `127.0.0.1:7897` 是否成功
|
||||
|
||||
### Step 3：按结果归类
|
||||
- 直连稳定，代理更差 → 归入“建议直连”
|
||||
- 直连失败/明显不稳 → 归入“必须代理”
|
||||
- 两者都可，但目标站点不同 → 归入“视场景而定”
|
||||
|
||||
---
|
||||
|
||||
## 四、当前已确认结论（可直接复用）
|
||||
|
||||
### 已确认必须代理
|
||||
- Telegram
|
||||
- Gmail / Google Workspace
|
||||
|
||||
### 已确认建议直连
|
||||
- `sub2api`
|
||||
- `lkeap`
|
||||
- OpenClaw 主聊天（当前 `sub2api/gpt-5.4`）
|
||||
- OpenClaw 本地能力
|
||||
|
||||
### 已确认需要按场景判断
|
||||
- `web_search`
|
||||
- `web_fetch`
|
||||
- `browser`
|
||||
- 未来新增海外服务
|
||||
|
||||
---
|
||||
|
||||
## 五、后续维护原则
|
||||
|
||||
### 原则 1：不要把“OpenClaw 要不要走代理”当成全局问题
|
||||
正确问题应当是：
|
||||
|
||||
> **OpenClaw 的哪些能力需要代理，哪些能力不需要？**
|
||||
|
||||
### 原则 2：新增模型 / 渠道 / 集成时，及时更新本文件
|
||||
每次新增能力后，补充：
|
||||
- 服务名称
|
||||
- 是否必须代理
|
||||
- 测试结论
|
||||
- 推荐策略
|
||||
|
||||
### 原则 3：优先做能力级分流，不做粗暴全局翻墙
|
||||
目标是：
|
||||
- 降低复杂度
|
||||
- 降低误判
|
||||
- 提高稳定性
|
||||
- 让网络问题更容易定位
|
||||
|
||||
---
|
||||
|
||||
## 六、建议的后续扩展字段（以后可加）
|
||||
|
||||
后面如果服务和模型越来越多，可以在本文件中追加表格字段：
|
||||
|
||||
| 名称 | 类型 | 地域属性 | 直连结果 | 代理结果 | 结论 | 备注 |
|
||||
|------|------|----------|----------|----------|------|------|
|
||||
|
||||
适合记录：
|
||||
- 新模型 provider
|
||||
- 新 channel
|
||||
- 新 skill 的外部 API
|
||||
- 新 webhook / SaaS 集成
|
||||
|
||||
---
|
||||
|
||||
## 一句话总纲
|
||||
|
||||
> **OpenClaw 默认直连；Telegram、Google 和部分海外访问按需走 mihomo `127.0.0.1:7897`。**
|
||||
Reference in New Issue
Block a user