必须将API Key写入环境变量OPENCLAW_API_KEY才能启动OpenClaw，否则报错退出；需确认版本≥v0.4.0，Linux/macOS用export临时或编辑.zshrc/.bashrc永久设置，Windows通过系统环境变量配置并重启终端验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在本地运行 OpenClaw 时，必须将 API Key 写入环境变量才能调用大模型服务，否则启动会报错 【Missing API key】 并直接退出。
确认 OpenClaw 版本与配置路径
先执行 openclaw --version 确认当前使用的是 v0.4.0 或更高版本——低于该版本不支持自动读取 OPENCLAW_API_KEY 环境变量，需降级或升级。
打开终端，输入 which openclaw 查看可执行文件路径，确认不是通过 alias 或 shell 函数伪装的假命令。
Linux/macOS：写入 Shell 环境变量
方法一：临时生效（仅当前终端会话）
在终端中直接运行：export OPENCLAW_API_KEY=sk-abc123xyz，把 sk-abc123xyz 替换为你的真实密钥。
方法二：永久生效（推荐）
编辑你的 Shell 配置文件：
→ 若使用 zsh（macOS Catalina 及以后默认），运行 nano ~/.zshrc；
→ 若使用 bash，则编辑 ~/.bashrc 或 ~/.bash_profile。
在文件末尾新增一行：export OPENCLAW_API_KEY="sk-abc123xyz"，注意双引号必须保留，否则含空格或特殊字符的密钥会解析失败。
【密钥前后不能有空格，等号两侧也不加空格】
保存后执行 source ~/.zshrc（或对应配置文件）使变量立即生效。
Windows：通过系统设置写入环境变量
第一步：按 Win + R → 输入 sysdm.cpl → 回车 → 切换到「高级」选项卡 → 点击「环境变量」。
第二步：在「系统变量」区域点击「新建」→ 变量名填 OPENCLAW_API_KEY → 变量值粘贴你的密钥（不要额外换行或空格）→ 点击「确定」。
第三步：关闭所有已打开的命令提示符或 PowerShell 窗口，重新打开一个——旧窗口不会自动继承新变量。
验证是否成功：在新打开的 CMD 中运行 echo %OPENCLAW_API_KEY%，应完整显示密钥字符串。若显示为空或报错，说明未生效。
