要成功运行 OpenClaw，需要配置好网络以允许其访问以下几个关键服务

openclaw openclaw官方 2026-04-09 3

核心网络需求

访问 OpenAI / 其他 LLM API
- 域名/地址：api.openai.com（或您配置的其他 LLM 供应商的端点，如 api.anthropic.com， api.groq.com 等）。
- 端口：HTTPS (443)。
- 说明：这是最核心的需求，框架需要将提示词和上下文发送给大模型，并接收返回的结果，请确保您的网络环境可以稳定访问这些外部 API。
访问搜索引擎（如果启用）
- 域名/地址：如果使用 SerpAPI，则需要能访问 serpapi.com；如果使用 DuckDuckGo 或其他在线服务，也需要相应的网络出口。
- 端口：HTTPS (443)。
- 说明：当智能体需要获取实时信息时，会调用搜索引擎工具。
访问本地/远程工具服务
- 地址/端口：取决于您为智能体配置的工具。
- 本地工具：如本地运行的数据库、文件服务器、内部 API 等，通常为 localhost:端口号 或内网地址。
- 远程工具：如需要访问特定的外部 API（如 GitHub API, api.github.com）、天气 API 等。
- 说明：您需要根据自己定义的工具，开放对应的网络访问权限。
向量数据库连接（如果使用）
- 地址/端口：使用本地 ChromaDB（无需外部网络），或远程的 Pinecone (api.pinecone.io)、Qdrant、Weaviate 等。
- 说明：用于存储和检索长期记忆或知识库。

配置文件和设置

网络配置主要体现在以下几个地方：

环境变量文件（如 .env） 这是最主要的配置点，您需要在项目根目录创建或修改 .env 文件，设置 API 密钥和端点。

# 示例 .env 文件
OPENAI_API_KEY=sk-your-openai-api-key-here
OPENAI_BASE_URL=https://api.openai.com/v1  # 如果使用代理或自定义端点，可以修改此项
# 其他可能用到的
SERPAPI_API_KEY=your-serpapi-key
ANTHROPIC_API_KEY=your-claude-key
GROQ_API_KEY=your-groq-key

代理设置（如果需要） 如果您的环境需要通过代理服务器访问外网（如公司网络），需要在代码或系统层面配置。
- 系统环境变量（Linux/macOS/Windows）：
```
export HTTP_PROXY=http://your-proxy-server:port
export HTTPS_PROXY=http://your-proxy-server:port
```
- 在 Python 代码中（如果框架支持）：有些 SDK 允许在初始化客户端时传递 http_client 参数来配置代理。
防火墙规则
- 确保运行 OpenClaw 的服务器的出站规则允许访问上述提到的外部域名和端口。
- OpenClaw 需要提供 Web 服务或 API 供外部调用（如通过 Gradio 或 FastAPI 暴露界面），还需要配置入站规则，开放相应的端口（如 7860, 8000 等）。

典型问题排查步骤

API 连接失败：
- 检查命令：在运行 OpenClaw 的服务器上，执行 curl -v https://api.openai.com 或 ping api.openai.com（注意 API 通常只响应 HTTPS）。
- 排查：确认 OPENAI_API_KEY 正确无误且有效；检查网络代理设置；确认账户是否有余额或权限。
工具调用失败：
- 排查：检查该工具所需的 API 密钥是否已在 .env 中配置；使用 curl 或 telnet 测试工具对应的网络端点是否可达。
本地服务无法连接：
- 排查：确认服务已在运行（netstat -an | grep 端口号）；如果是 Docker 环境，检查容器网络模式和端口映射。