1. 国内网络环境下 OpenClaw 到底卡在哪OpenClaw 是一个可以本地部署、接入多种大模型与消息通道的智能体框架能帮你把模型对话、工具调用、企业微信/钉钉这类通道串起来跑自动化。它适合想自己掌控数据、又需要多模型切换的开发者。但很多人第一次在国内网络里跑 OpenClaw卡点往往不在代码而在网络npm install 转圈、docker pull 超时、海外模型 API 连不上、国产模型反而因为走了代理变慢。我试过在一台干净的云主机上从零装一遍光是 npm 和镜像这两步就能耗掉半小时。这篇就聚焦国内网络环境把 OpenClaw 的代理、镜像加速、npm 配置一次性讲清楚再配合 TaoToken 统一 Key/API 通道完成接入验证。目标很明确让你照着复制配置就能跑通而不是在报错里反复试。先给一张判断表决定你要不要配代理服务类型示例是否需要代理国产模型 APIDeepSeek、Qwen、Moonshot、GLM不需要国内通道企业微信、钉钉、飞书不需要npm 安装国内镜像registry.npmmirror.com不需要Docker 镜像国内仓库阿里/腾讯镜像仓库不需要海外模型 APIOpenAI、Anthropic、Google需要海外通道Telegram、Slack、Discord消息通道需要GitHub 拉代码代码拉取、Issue视情况而定如果你只用国产模型加国内通道完全可以跳过代理章节直接看镜像加速和 TaoToken 接入部分。下面按「先镜像、再代理、后接入」的顺序来。2. TaoToken 前置统一 Key 与 API 通道在动手配网络之前先把模型接入这条线理顺。OpenClaw 支持配置多个模型 provider但每个 provider 都要单独填 base_url 和 api_key管理起来很碎。TaoToken 的作用是提供一个统一的 API 通道你只需要一个 Key就能在 OpenClaw 里对接不同模型省去到处找 endpoint 的麻烦。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 这个不加 UTM。你需要先去控制台创建一个 API Key路径在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。拿到 Key 之后先别急着写进配置后面会结合 config.toml 一起给。注意TaoToken 是合规的 API 聚合通道不是任何形式的网络中转工具。它的定位是帮你统一管理模型 Key和代理是两回事别混在一起理解。如果你后面要长期跑编码类 Agent可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到字段不确定时对着文档查最快。3. 可复制配置镜像加速 代理 OpenClaw 骨架这一节是全文的核心所有配置都可以直接复制。顺序是先配 npm 镜像再配 Docker 镜像然后按需配代理最后写 OpenClaw 的 config.toml 和 settings.json。3.1 npm 镜像加速OpenClaw 的安装依赖 npm国内直连官方源经常超时。换成 npmmirror原淘宝镜像即可npm config set registry https://registry.npmmirror.com npm config get registry第二条命令用来验证输出https://registry.npmmirror.com就说明生效了。如果只是临时装一个包不想改全局配置npm install --registry https://registry.npmmirror.com3.2 Docker 镜像加速用 Docker 跑 OpenClaw 的话先配镜像加速器。编辑/etc/docker/daemon.json{ registry-mirrors: [ https://mirror.ccs.tencentyun.com, https://docker.mirrors.ustc.edu.cn ] }改完重启 Dockersudo systemctl restart docker也可以直接从国内镜像仓库拉 OpenClaw 镜像绕开 Docker Hubdocker pull registry.cn-hangzhou.aliyuncs.com/openclaw/openclaw:latest3.3 代理配置仅海外通道需要如果你确实要用海外模型或 Telegram 这类通道才需要配代理。系统级环境变量方式export HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890 export NO_PROXYlocalhost,127.0.0.1,.deepseek.com,.aliyuncs.com,.tencent.com,.baidu.com要永久生效就写进~/.bashrc或~/.zshrc然后source一下。这里的关键是NO_PROXY一定要把国产模型和国内服务的域名排除掉否则国内流量绕一圈代理反而更慢甚至报错。如果系统级代理对 Node.js 不生效用 global-agent 在 Node 层兜底npm install -g global-agent export GLOBAL_AGENT_HTTP_PROXYhttp://127.0.0.1:7890 openclaw startDocker 环境还要单独给 daemon 配代理编辑/etc/docker/daemon.json{ proxies: { http-proxy: http://127.0.0.1:7890, https-proxy: http://127.0.0.1:7890, no-proxy: localhost,127.0.0.1,.aliyuncs.com,.tencent.com } }容器级代理则在docker run时传环境变量docker run -d \ -e HTTP_PROXYhttp://host.docker.internal:7890 \ -e HTTPS_PROXYhttp://host.docker.internal:7890 \ -e NO_PROXYlocalhost,.deepseek.com,.aliyuncs.com \ registry.cn-hangzhou.aliyuncs.com/openclaw/openclaw:latest3.4 OpenClaw config.toml 骨架下面这份 config.toml 把 TaoToken 作为统一模型通道同时保留一个国产模型直连示例。字段按你的实际 Key 替换[server] host 0.0.0.0 port 8080 [models.default] provider taotoken base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model claude-3-5-sonnet [models.fallback] provider deepseek base_url https://api.deepseek.com/v1 api_key ${DEEPSEEK_API_KEY} model deepseek-chat [channels.wecom] enabled true corp_id your-corp-id agent_id your-agent-id secret ${WECOM_SECRET} [channels.telegram] enabled false token your-bot-token proxy http://127.0.0.1:7890注意[channels.wecom]里没有 proxy 字段因为企业微信是国内通道不需要代理而[channels.telegram]单独配了 proxy只让这一个通道走代理。这种「通道级代理」比全局代理更干净。3.5 settings.json 骨架有些版本用 settings.json 管理运行时参数骨架如下{ network: { timeout: 30000, retry: 3, noProxy: [localhost, 127.0.0.1, .deepseek.com, .aliyuncs.com] }, models: { default: taotoken, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY } } }, logging: { level: info } }把 Key 放在环境变量里配置文件只引用变量名这样提交代码时不会泄露。设置环境变量export TAOTOKEN_API_KEY你的Key4. 验证请求与成功结果配置写完先别急着启动完整服务用 curl 单独验证 TaoToken 通道是否通curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-3-5-sonnet, messages: [{role: user, content: ping}] }返回里带choices字段和一段回复内容就说明 Key 和通道都正常。如果返回 401检查 Key 是否复制完整返回 404检查 base_url 有没有多写或少写/v1。再验证国产模型直连不走代理curl -v https://api.deepseek.com/v1/models能返回模型列表就说明国内直连没问题。接着跑 OpenClaw 自带的网络诊断openclaw doctor --network这个命令会逐项检查 npm 源、Docker 镜像、模型连通性输出里每项是绿色或 OK 就通过了。最后启动服务openclaw start看到监听 8080 端口、模型 provider 加载成功的日志就说明整条链路跑通了。此时你在企业微信里发一条消息应该能收到模型回复。5. 本篇常见错排查跑不通的时候对照下面这张表定位基本能覆盖九成问题症状可能原因解决npm install 超时未配国内镜像设置 npmmirror 源docker pull 超时未配镜像加速用国内镜像仓库海外模型 API 超时未配代理设置 HTTP_PROXY国产模型 API 变慢国内流量走了代理检查 NO_PROXYGitHub 克隆失败网络不稳定用国内代码镜像间歇性连接失败DNS 解析问题换可靠 DNSDNS 这块单独说下。如果遇到时好时坏的连接失败多半是解析不稳定可以换公共 DNSecho nameserver 223.5.5.5 | sudo tee /etc/resolv.conf echo nameserver 223.6.6.6 | sudo tee -a /etc/resolv.conf还有一个容易忽略的坑NO_PROXY里写域名时前缀的点号.deepseek.com表示匹配所有子域名别漏了点号否则api.deepseek.com不会被排除。另外 Docker 容器里访问宿主机的代理要用host.docker.internal而不是127.0.0.1因为容器里的 localhost 指向容器自己。如果 TaoToken 通道报鉴权错误先去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 确认 Key 状态再对着 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 检查请求格式。想先在网页上试模型效果可以直接用模型对话页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。6. 接入与长期使用建议网络配置这件事核心思路就一句话国内流量走直连海外流量才走代理镜像全部换国内源。把NO_PROXY配好比全局代理省心得多。TaoToken 在这里扮演的是统一 Key 通道的角色让你不用为每个模型单独维护 endpoint。如果你只是偶尔验证模型用模型对话页最快如果是长期跑编码或 Agent 任务建议看下 Coding Plan配额和通道更稳定https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入过程中遇到字段问题文档页 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 和 API Keys 页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 是最常翻的两个地方。最后留个实操习惯每次改完网络配置先跑openclaw doctor --network再启动服务能省掉大量「启动了但连不上」的排查时间。配置文件和 Key 分开管理Key 走环境变量配置文件进版本库这套组合用久了会越来越顺。