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