1. 为什么 OpenClaw 部署最容易翻车的不是安装而是 Key 管理OpenClaw 是一个能读写文件、执行命令、调用外部模型的自动化 Agent 框架适合想用自然语言驱动本地或云端任务的人。它本身不复杂真正让新手翻车的是部署方式Docker、WSL2、云服务器三套环境各跑一份每份都塞一个 API Key时间一长你自己都记不清哪个 Key 对应哪个实例。更麻烦的是一旦某个实例被扫到泄露的不只是 Key还有它背后能触达的文件和命令权限。我见过太多人图省事直接curl | bash在宿主机裸跑结果 OpenClaw 以当前用户身份拿到了整个家目录的读写权。低风险部署的核心不是“装得快”而是三件事环境隔离、Key 集中管理、连通性可验证。这篇就围绕这三点给你 Docker、WSL2、云服务器三套可复制的配置骨架并用 TaoToken 的统一 Key 把多环境凭证收敛到一处。先说清楚适合谁如果你只在一台机器上玩本文的隔离思路同样适用如果你要在开发机、Windows 子系统、云主机之间切换那统一 Key 接入能帮你省掉大量“这个 Key 是哪来的”排查时间。下面所有配置我都实测过命令可以直接抄。2. TaoToken 前置把多环境 Key 收敛成一个入口TaoToken 在这里扮演的角色是统一的模型接入层。你不需要在每个环境里分别配置不同厂商的 Key而是让 OpenClaw 的各个实例都指向同一个 TaoToken 入口用同一套凭证访问模型能力。这样做的好处很直接轮换 Key 时只改一处审计调用时看一个后台某个环境出问题也不会牵连其他环境的凭证。接入前你需要准备两样东西一个 TaoToken 账号以及一个 API Key。Key 在控制台的 API Keys 页面生成建议按环境命名比如openclaw-docker、openclaw-wsl2、openclaw-cloud这样即使共用同一个入口也能在后台区分调用来源排查问题时一眼看出是哪个实例在发请求。生成 Key 的入口在这里控制台 API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite拿到 Key 之后先别急着往三个环境里各贴一遍。正确做法是把它写进每个环境的.env或密钥文件配置文件里只引用变量名不出现明文。这样即使你把config.toml提交到私有仓库也不会把 Key 带出去。TaoToken 的 API 基地址是https://taotoken.net/api这个地址在三个环境里保持一致不需要为 Docker 或 WSL2 单独改。如果你还想确认模型侧的行为是否符合预期可以先用模型对话页面做一次手动验证确认 Key 有效、模型可调用再进入部署环节模型对话验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite这一步花两分钟能省掉后面“到底是网络问题还是 Key 问题”的大量扯皮。3. 可复制配置三套环境的 config.toml 与 settings.json 骨架3.1 Docker 环境容器隔离 环境变量注入Docker 方案的重点是让容器只拿到它需要的 Key而不是把宿主机的环境变量全盘透传。下面这份docker-compose.yml骨架把 Key 通过env_file注入端口只绑定到127.0.0.1避免公网直接可达。services: openclaw-gateway: image: openclaw/openclaw:latest container_name: openclaw-gateway restart: unless-stopped env_file: - .env ports: - 127.0.0.1:18789:18789 volumes: - ./data:/home/openclaw/.openclaw deploy: resources: limits: cpus: 2.0 memory: 4g配套的.env文件只放三行Key 不写进 compose 文件TAOTOKEN_API_BASEhttps://taotoken.net/api TAOTOKEN_API_KEYsk-你的Key OPENCLAW_SANDBOX_ENABLEDtrue然后是 OpenClaw 自己的config.toml放在挂载目录./data/config.toml。这份骨架的关键是allowed_commands白名单和denied_commands黑名单同时存在前者限定能跑什么后者兜底拦掉危险操作[gateway] host 127.0.0.1 port 18789 sandbox true [model] provider openai-compatible base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY model claude-sonnet-4 max_tokens 2048 [security] allowed_commands [ls, cat, grep, git, python3] denied_commands [rm -rf, curl, wget, chmod 777]注意api_key_env写的是变量名而不是 Key 本身OpenClaw 启动时会从环境里读。这样容器内env命令能看到变量但配置文件本身是干净的。3.2 WSL2 环境settings.json 与 Windows 侧隔离WSL2 的坑在于 Windows 和 Linux 两套文件系统的权限边界。建议把 OpenClaw 的工作目录放在 WSL2 的 Linux 文件系统内比如~/openclaw不要放在/mnt/c/下否则文件权限会变得难以预测。依赖安装用 Node.js 官方源避免版本过旧。sudo apt update sudo apt install -y nodejs npm git npm install -g openclawlatest mkdir -p ~/openclaw cd ~/openclawWSL2 侧用settings.json管理配置和 Docker 的config.toml字段对应但格式不同{ gateway: { host: 127.0.0.1, port: 18789, sandbox: true }, model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, model: claude-sonnet-4, maxTokens: 2048 }, security: { allowedCommands: [ls, cat, grep, git, python3], deniedCommands: [rm -rf, curl, wget] } }Key 同样走环境变量写进~/.bashrc或单独的~/.openclaw.env然后source进去。不要把 Key 写进settings.json这个文件很容易被误传到别处。3.3 云服务器最小暴露面 安全组白名单云服务器的第一原则是管理接口绝不监听0.0.0.0。下面这条docker run把端口绑到127.0.0.1外部要访问只能通过 SSH 隧道或反向代理安全组里也只放行 SSH 端口。docker run -d \ --name openclaw \ --restart unless-stopped \ -p 127.0.0.1:18789:18789 \ -v ~/.openclaw:/home/openclaw/.openclaw \ --env-file ~/.openclaw/.env \ openclaw/openclaw:latest云上的config.toml和 Docker 版一致额外加一条日志轮转避免磁盘被日志写满[logging] level info max_size_mb 100 max_files 5三套环境的配置骨架到这里就齐了。核心思路统一Key 走环境变量配置文件只引用变量名端口只绑本地命令走白名单。4. 逐环境验证连通性检查命令与成功结果配置写完不代表能用必须逐环境验证。下面每个环境给一条检查命令和预期结果照着跑一遍就知道通没通。Docker 环境先确认容器起来了再进容器内部测模型调用docker ps --filter nameopenclaw-gateway docker exec -it openclaw-gateway openclaw doctoropenclaw doctor会依次检查配置文件、环境变量、模型连通性。成功时你会看到类似model: reachable和api_key: loaded的输出。如果api_key: missing说明.env没被正确加载检查env_file路径。WSL2 环境直接跑内置诊断openclaw doctor --config ~/openclaw/settings.json预期输出里gateway和model两项都是ok。如果model报连接超时先curl -I https://taotoken.net/api确认网络可达再检查apiKeyEnv指向的变量是否在当前 shell 里echo $TAOTOKEN_API_KEY有值。云服务器环境多一步从外部确认端口没有暴露ss -tlnp | grep 18789正确结果应该显示127.0.0.1:18789而不是0.0.0.0:18789。如果看到后者说明端口绑定写错了立刻改回本地绑定并重启容器。然后再在服务器内部跑一次openclaw doctor确认模型可达。三个环境都通过后建议做一次端到端验证在 OpenClaw 里发一条简单指令比如让它列出当前目录文件确认它既能调用模型又能执行白名单内的命令。这一步过了部署才算真正完成。5. 本篇常见错排查Key 不生效、端口暴露、沙箱失效Key 不生效报 401 或 unauthorized。九成是环境变量没加载。Docker 里检查docker exec openclaw-gateway env | grep TAOTOKENWSL2 里检查echo $TAOTOKEN_API_KEY。如果变量为空说明.env没被 source 或env_file路径写错。还有一种情况是 Key 复制时带了空格或换行重新从控制台复制一次。端口暴露到公网。检查ss -tlnp或docker port只要看到0.0.0.0就是错的。改 compose 文件里的端口映射为127.0.0.1:18789:18789重启容器。云服务器还要去安全组确认没有放行 18789。沙箱没生效Agent 能碰宿主机文件。确认config.toml里sandbox true并且容器启动时没有加--privileged。如果挂载了宿主机根目录或家目录沙箱的意义会大打折扣只挂载 OpenClaw 自己的工作目录即可。WSL2 里命令找不到。通常是 PATH 问题npm install -g装的包在~/.npm-global/bin或/usr/local/bin确认这个路径在$PATH里。另外 WSL2 的 Windows 互操作可能让openclaw解析到 Windows 侧的同名程序用which openclaw确认指向 Linux 路径。云服务器上模型调用超时。先排除网络curl -I https://taotoken.net/api看能否握手。如果网络通但 OpenClaw 超时检查config.toml里的base_url是否写成了带路径的完整地址正确写法是https://taotoken.net/api不要多加/v1之类的后缀。6. 长期维护Key 轮换与 Coding Plan 的衔接部署跑通只是开始长期维护里最容易被忽略的是 Key 轮换。因为三个环境共用 TaoToken 入口轮换时你只需要在控制台生成新 Key然后更新三个环境的.env文件并重启对应服务不需要逐个去改模型厂商的配置。建议每季度轮换一次旧 Key 在控制台直接吊销。如果你打算把 OpenClaw 用在长期编码或 Agent 任务上单次调用计费可能不如套餐划算。Coding Plan 适合这种持续、高频的使用场景接入方式和你现在配置的base_url一致只是计费模型不同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最后提醒一句无论哪个环境管理接口永远只绑127.0.0.1需要远程访问就开 SSH 隧道别为了图方便把端口开到公网。低风险部署的本质不是装得多快而是每个环节都留了退路。