195 lines
4.6 KiB
Markdown
195 lines
4.6 KiB
Markdown
# 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`。**
|