1. 为什么 WSL 里的 OpenClaw 必须做安全加固很多人第一次在 Windows WSL 里跑 OpenClaw注意力全在“能不能通”“模型回不回话”上等 Gateway 起来了、飞书也接上了就默认这套环境已经可用。问题是OpenClaw 本质上是一个本地 AI 网关它同时握着三样东西监听端口、模型 API Key、以及外部平台比如飞书的凭据。这三样任意一个暴露都不是“重启一下就好”的小事。我见过最典型的场景是这样的WSL2 默认走 NAT 虚拟网卡Ubuntu 里的服务监听0.0.0.0Windows 主机和 WSL 之间网络互通局域网里另一台机器扫到18789端口直接就能访问你的 Gateway 面板。更麻烦的是 Ollama 的11434如果绑定成0.0.0.0同网段任何设备都能调用你的本地模型甚至通过它反查你的配置。这不是危言耸听是默认配置下很容易踩到的坑。所以这一篇要解决的核心问题有三个第一把网络边界收窄让 OpenClaw 的端口只对可信来源开放第二把敏感凭据从明文配置文件里挪走避免误提交到 Git 或被其他用户读到第三把 OpenClaw 的 API 请求统一指向 TaoToken 通道让模型调用路径可控、可验证、可排查。这三件事做完你的 WSL 环境才算从“能跑”进入“敢用”。适合谁看如果你已经在 Windows WSL 里装好了 OpenClaw能启动 Gateway但还没认真处理过防火墙、文件权限和 Key 管理这篇就是给你写的。如果你正准备把 OpenClaw 从本机测试推向小团队内网使用那更要把这一篇的配置逐条落地。下面我会按“先收网络、再收凭据、最后接通道”的顺序展开每一步都给可复制的命令和配置片段。2. TaoToken 通道前置准备与凭据隔离思路在讲防火墙之前先把 TaoToken 通道这件事说清楚因为它直接决定了你后面环境变量怎么设计。TaoToken 是一个面向开发者的模型 API 聚合入口你可以把它理解成“统一收口的模型调用通道”OpenClaw 不需要分别记住每家模型的地址和 Key只需要把 Base URL 指向 TaoToken用一把 Key 走统一出口。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数配置时别把推广参数写进 Base URL。为什么要在安全篇里先讲通道因为凭据隔离的设计和通道选择是绑在一起的。如果你用多个模型供应商就要在环境变量里维护多把 Key权限边界会变得很碎而统一走 TaoToken 通道后OpenClaw 侧只需要一个TAOTOKEN_API_KEY配合一个 Base URL敏感信息的数量直接降下来。凭据越少泄露面越小轮换成本也越低。具体到 WSL 环境我建议的隔离策略是三层第一层Windows 用户级环境变量存真实 Key不写进任何项目文件第二层WSL 里的.env文件只做引用或本地覆盖权限设成600第三层OpenClaw 的config.env里只保留变量名不出现明文。这样即使你把项目目录打包发给别人或者不小心git add .也不会把 Key 带出去。你需要提前准备的东西不多一个 TaoToken 账号在控制台生成 API Key确认你的 OpenClaw 版本支持自定义 Base URL以及一个能跑curl的 WSL Ubuntu 环境。Key 的生成入口在控制台的 API Keys 页面建议生成后先复制到密码管理器里再写入 Windows 环境变量不要直接贴在聊天窗口或记事本里。下面进入具体配置。3. 可复制的 wsl.conf、ufw 规则与通道配置这一节是整篇的核心所有片段都可以直接复制。先处理 WSL 的基础行为再配防火墙最后写 OpenClaw 的通道配置。顺序不要颠倒否则可能出现“规则加了但不生效”的情况。3.1 wsl.conf 安全项WSL 的全局配置在/etc/wsl.conf这个文件控制启动行为、互操作和挂载选项。安全相关的关键项是关闭自动挂载 Windows 路径的写权限风险以及确保 systemd 正常拉起服务。编辑前先备份sudo cp /etc/wsl.conf /etc/wsl.conf.bak sudo tee /etc/wsl.conf /dev/null EOF [boot] systemdtrue [interop] enabledtrue appendWindowsPathfalse [automount] enabledtrue optionsmetadata,umask22,fmask11 EOF这里appendWindowsPathfalse是重点。默认情况下 WSL 会把 Windows 的 PATH 追加进来意味着你在 WSL 里执行命令时可能意外调用到 Windows 侧的同名程序攻击面会变大。关掉之后WSL 的命令解析更干净。automount的umask22,fmask11让挂载的 Windows 盘符默认权限更严格避免/mnt/c下的文件被 WSL 内其他用户随意读写。改完执行wsl --shutdown重启生效注意这会关闭所有 WSL 会话。3.2 ufw 规则片段WSL Ubuntu 里装 ufw 并配置默认策略。默认拒绝入站、允许出站这是最小权限的起点sudo apt-get update sudo apt-get install -y ufw sudo ufw default deny incoming sudo ufw default allow outgoing sudo ufw allow from 127.0.0.1 to any port 18789 proto tcp comment openclaw-local sudo ufw allow from 172.20.0.1 to any port 18789 proto tcp comment openclaw-windows-host sudo ufw allow 22/tcp comment ssh sudo ufw --force enable sudo ufw status verbose172.20.0.1是 WSL 视角下 Windows 主机的网关地址不同机器可能不同用ip route show default确认。如果你不需要 SSH把22/tcp那条删掉。Ollama 的11434不要对Anywhere开放只允许本机或 WSL 内部网段。启用后ufw status verbose应该显示Status: active并且规则里能看到注释。3.3 OpenClaw 通道配置片段OpenClaw 的模型通道配置建议放在~/.openclaw/config.env权限600。下面这段把请求统一指向 TaoTokenmkdir -p ~/.openclaw chmod 700 ~/.openclaw touch ~/.openclaw/config.env chmod 600 ~/.openclaw/config.env cat ~/.openclaw/config.env EOF GATEWAY_PORT18789 GATEWAY_TOKEN${OPENCLAW_GATEWAY_TOKEN} MODEL_PROVIDERtaotoken TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_API_KEY${OPENCLAW_TAOTOKEN_API_KEY} TAOTOKEN_MODELclaude-sonnet-4-5 ENABLE_FEISHUtrue FEISHU_APP_IDcli_xxxxxxxx FEISHU_APP_SECRET${OPENCLAW_FEISHU_APP_SECRET} EOF注意TAOTOKEN_BASE_URL写的是https://taotoken.net/api不带任何查询参数。TAOTOKEN_API_KEY用变量引用真实值放在 Windows 用户级环境变量里。如果你用 Cline 或 Claude Code 这类工具配置结构类似关键是三件套齐全Base URL、API Key、Model ID。Model ID 按 TaoToken 文档里当前可用的写别照抄过期的。3.4 Windows 侧环境变量写入在 PowerShell 里写用户级环境变量不需要管理员权限[Environment]::SetEnvironmentVariable(OPENCLAW_TAOTOKEN_API_KEY, sk-your-taotoken-key, User) [Environment]::SetEnvironmentVariable(OPENCLAW_GATEWAY_TOKEN, your-gateway-token, User) [Environment]::SetEnvironmentVariable(OPENCLAW_FEISHU_APP_SECRET, your-feishu-secret, User)写完新开一个终端验证[Environment]::GetEnvironmentVariable(OPENCLAW_TAOTOKEN_API_KEY,User)。WSL 里读取 Windows 环境变量可以用cmd.exe /c echo %OPENCLAW_TAOTOKEN_API_KEY%但更稳的做法是在 WSL 启动脚本里显式导出避免appendWindowsPathfalse之后互操作行为变化。4. 验证请求与成功结果确认配置写完不代表生效必须做一次端到端验证。验证分两步先确认网络规则真的在拦再确认 OpenClaw 的请求真的走到了 TaoToken 通道。4.1 验证 ufw 与端口监听在 WSL 里看监听状态ss -tlnp | grep -E (18789|11434)预期看到18789绑定在127.0.0.1或 WSL 内网地址而不是0.0.0.0。如果看到0.0.0.0:18789说明 OpenClaw 的监听配置没改回到config.env检查GATEWAY_HOST之类的项。然后从 Windows 主机测试连通性用 PowerShellTest-NetConnection -ComputerName 127.0.0.1 -Port 18789本机应该通。再从局域网另一台机器测应该不通或被拒绝这才说明边界生效。4.2 用 curl 验证 TaoToken 通道这一步是确认请求路径正确。在 WSL 里执行source ~/.openclaw/config.env curl -sS -X POST ${TAOTOKEN_BASE_URL}/v1/messages \ -H Authorization: Bearer ${TAOTOKEN_API_KEY} \ -H Content-Type: application/json \ -d { model: ${TAOTOKEN_MODEL}, max_tokens: 64, messages: [{role: user, content: ping}] } | head -c 500如果返回里包含正常的模型响应结构说明 Base URL、Key、Model ID 三件套都对。如果返回 401先检查 Key 是否带上了Bearer前缀以及环境变量是否真的被 source 进来。如果返回连接超时检查 WSL 的出站是否被 ufw 拦了——默认allow outgoing不应该拦但如果你改过策略就要确认。4.3 验证 OpenClaw 实际调用重启 OpenClaw Gateway然后在 Dashboard 或日志里发一条测试消息。观察日志里请求的 host 是不是taotoken.net而不是某个直连的模型域名。这一步能确认 OpenClaw 没有绕过config.env里的通道配置。如果日志里还是旧地址说明配置没被加载检查服务启动时的工作目录和config.env路径。5. 本篇常见报错排查配置过程中最容易撞上的几类报错我按实际遇到的频率排一下。401 Unauthorized最常见。原因通常是 Key 没读到、Key 写错、或者 Base URL 带了多余路径。排查顺序先echo $TAOTOKEN_API_KEY确认变量非空再确认TAOTOKEN_BASE_URL是https://taotoken.net/api没有尾部斜杠叠加最后确认请求头是Authorization: Bearer sk-xxx不是x-api-key。如果用的是 Claude Code 类工具注意它可能读ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN变量名要对上。local proxy failed / connection refused这类报错通常出现在 WSL 里访问 Windows 侧服务或者反过来。WSL2 的 NAT 模式下localhost在两边含义不同。如果你在 WSL 里连 Windows 上的代理要用 Windows 主机在 WSL 网络里的 IP也就是172.20.0.1这类网关地址不是127.0.0.1。反过来 Windows 连 WSL 服务也要用 WSL 的实际 IP用hostname -I查。reading choices 相关报错这通常说明返回体不是预期的 JSON 结构可能是请求打到了错误的端点或者被中间层返回了 HTML 错误页。先curl -i看 HTTP 状态码和Content-Type如果是text/html基本就是地址写错了。确认TAOTOKEN_BASE_URL后面拼的路径和文档一致。OAuth 相关报错如果你在 OpenClaw 里配了需要 OAuth 的外部平台比如飞书报 OAuth 失败时先检查FEISHU_APP_SECRET是否从环境变量正确读取。WSL 里cmd.exe读 Windows 变量时可能带\r用tr -d \r清掉。另外回调地址要和平台后台配置一致WSL 的 IP 变化会导致回调失败。ufw 规则加了但不生效检查规则顺序ufw按添加顺序匹配允许规则要在拒绝规则之前。用ufw status numbered看编号必要时ufw delete重加。另外 WSL 重启后 IP 可能变硬编码的172.20.0.1如果变了规则就失效建议写个启动脚本动态更新。6. 把通道固定下来让后续接入更省事安全配置做完之后你会发现一个额外好处因为所有模型请求都收口到了 TaoToken 通道后面不管你是接 Claude Code、Cline 还是自己写的 Agent配置都变成同一套三件套——Base URL、API Key、Model ID。你不需要为每个工具单独记一套供应商地址也不用担心某个工具的 Key 泄露后要满世界改配置。轮换的时候只改 Windows 环境变量里的那一把 KeyWSL 里 source 一下重启服务就完事。如果你还在选长期编码或 Agent 场景的通道方案可以看下 Coding Plan 的说明如果只是想先验证模型通不通模型对话页面可以直接试接入文档里有各工具的完整配置示例。排障和接入相关的问题优先从 API Keys 和接入文档入手比在群里问快得多。最后留一个我自己的习惯每季度做一次审计跑一遍ufw status numbered、ss -tlnp、ls -la ~/.openclaw/确认权限还是600、监听还是本地、规则没有多出奇怪的条目。安全这件事配置一次不够得让它变成例行检查。