1. 先搞清楚 export: not valid in this context 到底在报什么export: not valid in this context这个报错字面意思是「export 在当前上下文里不合法」。它跟 OpenClaw 本身没多大关系本质是 shell 解析器在告诉你你写export的这个地方它不认。OpenClaw 部署时踩到这个坑通常是因为环境变量配置脚本被用错了方式执行或者脚本里混进了 Windows 换行符、命令替换、管道这类让export脱离正常语句位置的东西。我先把结论摆出来这个报错 90% 的情况出在三个地方——脚本被sh而不是bash执行、脚本带 CRLF 换行、export被塞进了$(...)或管道里。剩下 10% 是 fish shell 语法不兼容以及 WSL 里 shell 类型判断错。这篇就按「先定位、再修、再验证」的顺序走一遍最后给一份可以直接复制的 OpenClaw 环境变量配置骨架顺带把 TaoToken 的统一 Key 接进去让 OpenClaw 调用模型时不用到处散落密钥。适合谁看正在部署 OpenClaw、被环境变量卡住、对 bash/zsh/fish 差异不太熟的同学。你不需要是 shell 高手跟着命令一条条敲就行。先做一次最小复现确认你遇到的是不是同一类问题# 用 sh 执行一段含 export 的脚本很多系统上 sh 指向 dash sh -c export OPENCLAW_HOME/opt/openclaw; echo $OPENCLAW_HOME如果这条在你机器上报export: not valid in this context那基本可以确定是 shell 兼容性问题而不是 OpenClaw 安装包坏了。接下来按下面的流程逐项排查。2. TaoToken 前置统一 Key 与环境变量接入思路OpenClaw 部署完真正要跑起来还得接模型。与其把 API Key 硬编码进 OpenClaw 的配置文件不如统一走环境变量这样换 Key、换模型都不用改代码。TaoToken 提供 OpenAI 兼容接口把 base_url 指向https://taotoken.net/apiKey 从控制台生成后写进环境变量即可。你需要先拿到两样东西一个 API Key以及确认要用的模型名。Key 在控制台创建模型列表在文档里能查到。这两步做完再回到 shell 配置避免配了一半发现 Key 没准备好。TaoToken 控制台入口创建和管理 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_env_consoleAPI Key 管理页直接生成 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_env_apikeys接入文档查 base_url、模型名、请求格式https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_env_doc这里有个关键点环境变量名建议统一用TAOTOKEN_API_KEY和TAOTOKEN_BASE_URLOpenClaw 侧读取这两个变量去构造请求。这样你的 shell 配置脚本只需要管「把变量 export 出去」不掺业务逻辑出问题的面就小很多。注意不要把 Key 直接写进会提交到 git 的脚本里。环境变量配置文件建议放~/.config/openclaw/env.sh并加进.gitignore。3. 可复制的环境变量配置骨架bash/zsh/fish/WSL 全覆盖下面这份骨架分两部分通用变量 TaoToken 接入变量。核心原则是——脚本本身不假设自己被source还是被直接执行而是通过判断BASH_SOURCE来决定行为这样能绕开大部分export: not valid in this context。先建目录和文件mkdir -p ~/.config/openclaw touch ~/.config/openclaw/env.sh chmod 600 ~/.config/openclaw/env.sh写入以下内容bash/zsh 通用#!/usr/bin/env bash # ~/.config/openclaw/env.sh # OpenClaw 环境变量配置骨架兼容 bash / zsh # ---------- OpenClaw 基础路径 ---------- export OPENCLAW_HOME${OPENCLAW_HOME:-/opt/openclaw} export PATH$OPENCLAW_HOME/bin:$PATH export LD_LIBRARY_PATH$OPENCLAW_HOME/lib:${LD_LIBRARY_PATH:-} export PYTHONPATH$OPENCLAW_HOME/python:${PYTHONPATH:-} # ---------- TaoToken 统一接入 ---------- export TAOTOKEN_API_KEY${TAOTOKEN_API_KEY:-sk-替换成你的Key} export TAOTOKEN_BASE_URLhttps://taotoken.net/api export OPENCLAW_MODEL${OPENCLAW_MODEL:-gpt-4o-mini} # ---------- 仅在直接执行时打印被 source 时静默 ---------- if [[ ${BASH_SOURCE[0]} ${0} ]]; then echo OpenClaw 环境变量已加载 echo OPENCLAW_HOME $OPENCLAW_HOME echo TAOTOKEN_BASE_URL $TAOTOKEN_BASE_URL echo OPENCLAW_MODEL $OPENCLAW_MODEL fi这段脚本有两个设计点值得说。第一所有变量都用${VAR:-默认值}形式重复 source 不会把 PATH 越拼越长。第二末尾用BASH_SOURCE判断只有直接bash env.sh时才打印被source时安静加载避免污染交互式终端输出。zsh 用户直接把上面这段 source 进~/.zshrc即可语法完全兼容。fish 用户不能直接用需要改写# ~/.config/fish/config.fish 片段 set -gx OPENCLAW_HOME /opt/openclaw set -gx PATH $OPENCLAW_HOME/bin $PATH set -gx LD_LIBRARY_PATH $OPENCLAW_HOME/lib $LD_LIBRARY_PATH set -gx PYTHONPATH $OPENCLAW_HOME/python $PYTHONPATH set -gx TAOTOKEN_API_KEY sk-替换成你的Key set -gx TAOTOKEN_BASE_URL https://taotoken.net/api set -gx OPENCLAW_MODEL gpt-4o-minifish 里没有export用的是set -gx这就是为什么在 fish 里跑 bash 脚本会报export: not valid in this context——fish 根本不认识export这个内建命令。WSL 场景要额外注意WSL 默认登录 shell 可能是 bash但如果你在 Windows Terminal 里配置了启动命令或者用wsl -e sh进入shell 类型就变了。先确认echo $SHELL echo $0 ps -p $$ -o args如果$0显示sh或dash那你的~/.bashrc根本不会被读取环境变量自然不生效还可能因为脚本里用了 bash 特有语法而报错。4. 逐条验证从 shell 类型到请求成功配置写完不算完得逐条验证。下面这套命令按顺序跑每一步都有明确预期输出。第一步确认当前 shell 和是否交互式echo SHELL$SHELL echo 当前进程$0 case $- in *i*) echo 交互式 shell;; *) echo 非交互式 shell;; esac预期SHELL指向/bin/bash或/bin/zsh且显示「交互式 shell」。如果显示非交互式说明你在脚本或 CI 环境里export的作用域只在当前进程不会持久。第二步加载配置并检查变量source ~/.config/openclaw/env.sh echo OPENCLAW_HOME$OPENCLAW_HOME echo TAOTOKEN_BASE_URL$TAOTOKEN_BASE_URL echo OPENCLAW_MODEL$OPENCLAW_MODEL预期三个变量都有值TAOTOKEN_BASE_URL是https://taotoken.net/api。第三步检查 PATH 是否包含 OpenClaw 的 bin 目录且没有重复echo $PATH | tr : \n | grep -c openclaw预期输出1。如果输出大于 1说明你重复 source 了多次需要清理 PATH 里的重复项。第四步验证 Key 是否被正确读取不打印完整 Keyif [ -n $TAOTOKEN_API_KEY ] [ ${TAOTOKEN_API_KEY:0:3} sk- ]; then echo Key 格式正常长度 ${#TAOTOKEN_API_KEY} else echo Key 未设置或格式异常 fi第五步发一个真实请求验证接入是否通。用 curl 直接打 TaoToken 的 OpenAI 兼容接口curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { \model\: \$OPENCLAW_MODEL\, \messages\: [{\role\: \user\, \content\: \只回复两个字通了\}], \max_tokens\: 16 }预期返回一段 JSONchoices[0].message.content里是「通了」。如果返回 401说明 Key 不对返回 404检查 base_url 是否多了或少了/v1返回超时检查网络出口。第六步确认 OpenClaw 能读到这些变量。OpenClaw 启动脚本通常会读环境变量你可以用env | grep -E OPENCLAW|TAOTOKEN确认变量在当前进程可见。如果 OpenClaw 是以 systemd 服务方式启动环境变量得写进 unit 文件的Environment或EnvironmentFile光在.bashrc里配是读不到的。5. 本篇常见错排查export 报错的六种真实成因把上面流程跑完大部分问题能定位。下面按报错场景逐条拆。成因一用 sh 执行了 bash 脚本。很多系统/bin/sh指向 dashdash 对export的支持和 bash 不同某些写法会直接报not valid in this context。修法是显式用 bashbash setup_openclaw.sh或者把脚本 shebang 改成#!/usr/bin/env bash并加执行权限。成因二脚本带 Windows 换行符。从 Windows 拷过来的脚本每行结尾是\r\nbash 会把\r当成命令的一部分导致export后面跟了个不可见字符解析失败。检查file setup_openclaw.sh # 出现 with CRLF line terminators 就是这个问题修复用sed -i s/\r$// setup_openclaw.sh或者装dos2unix后dos2unix setup_openclaw.sh。成因三export 被塞进命令替换。像$(export OPENCLAW_HOME/opt/openclaw)这种写法export在子 shell 里执行父 shell 拿不到变量而且某些 shell 会直接报错。正确做法是直接export OPENCLAW_HOME/opt/openclaw不要包在$()里。成因四export 出现在管道中。export FOObar | cat这种写法export是 shell 内建命令不产生标准输出管道没有意义部分 shell 会报上下文错误。去掉管道即可。成因五fish shell 里跑 bash 语法。fish 用set -gx不认export。如果你在 fish 里source了一个 bash 脚本就会报这个错。解决方法是给 fish 单独写配置或者用bash -c包一层。成因六WSL 里 shell 判断错。WSL 里$SHELL可能显示/bin/bash但实际执行脚本的进程是sh。用ps -p $$ -o args看真实进程名别只看$SHELL。排查时可以用这个组合命令一次性收集信息{ echo shell ; echo $SHELL; ps -p $$ -o args echo 换行符 ; file ~/.config/openclaw/env.sh echo 变量 ; env | grep -E OPENCLAW|TAOTOKEN echo PATH 重复 ; echo $PATH | tr : \n | sort | uniq -d } 21把输出贴出来基本能一眼看出问题在哪。6. 配置校验通过后把 OpenClaw 跑起来环境变量验证通过、curl 请求也通了接下来就是让 OpenClaw 真正用上这套配置。如果你只是临时验证模型连通性可以直接在模型对话页测试不用改本地配置模型对话入口在线验证 Key 和模型是否可用https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_env_chat如果你打算长期跑 OpenClaw 做编码或 Agent 任务建议把 Key 和模型配置固定下来用 Coding Plan 管理额度更省心Coding Plan 入口长期编码/Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_env_codingplan最后再给一个持久化的小技巧把source ~/.config/openclaw/env.sh这行加到~/.bashrc或~/.zshrc末尾但加之前先确认文件里没有旧的 OpenClaw 配置块否则会出现变量重复。可以用grep -n OPENCLAW ~/.bashrc检查有旧的就先注释掉。到这里export: not valid in this context的根因定位、修复、验证、持久化就闭环了。核心就一句话先确认 shell 类型和执行上下文再让配置脚本只做「导出变量」这一件事剩下的交给验证命令去证明。