openclaw通过环境变量openclaw_api_key安全存储免费模型api密钥，禁止硬编码；linux/macos需写入shell配置并source生效，windows需powershell设置用户级变量并重启终端，项目级可使用.env文件配合python-dotenv加载。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在OpenClaw中安全存储免费模型API Key，必须避免将密钥硬编码进配置文件或源码，否则一旦代码提交到Git仓库，密钥将永久泄露且无法撤销。

确认OpenClaw支持的环境变量命名规范

OpenClaw默认读取OPENCLAW_API_KEY环境变量作为主密钥入口。若使用免费模型（如Qwen、Phi-3、Gemma等），该变量值即为对应模型提供商分配的密钥字符串。不支持自定义变量名，强行改名会导致初始化失败并抛出KeyError: 'OPENCLAW_API_KEY'异常。

这一步操作起来很简单，直接把文件拖进去就行。

Linux/macOS系统：永久写入Shell配置文件

第一步：打开终端，执行echo 'export OPENCLAW_API_KEY="sk-free-abc123xyz"' >> ~/.zshrc（若使用bash则改为~/.bashrc）。

第二步：执行source ~/.zshrc使变量立即生效。注意：不要漏掉source命令，否则新终端窗口仍读不到该变量。

第三步：验证是否设置成功——运行echo $OPENCLAW_API_KEY，应输出完整密钥字符串。若为空，请检查引号是否闭合、等号两侧有无空格、文件路径是否正确。

Windows系统：通过PowerShell设置用户级变量

以管理员身份打开PowerShell，运行以下命令：

[System.Environment]::SetEnvironmentVariable('OPENCLAW_API_KEY', 'sk-free-abc123xyz', 'User')

OpenClaw Bug Report

为 OpenClaw 创建可直接分流的 GitHub issue 草稿，用于报告代理缓慢、损坏、无响应、工具匮乏、性能下降或“不够智能”等问题。使用 ...

下载

【必须重启所有已打开的IDE或终端窗口】，否则Python进程无法继承新变量。

项目级隔离：使用.env文件配合python-dotenv

方法一：创建.env文件（注意开头带点，无扩展名），内容仅一行：OPENCLAW_API_KEY=sk-free-abc123xyz。

方法二：在Python启动脚本顶部添加两行：

from dotenv import load_dotenv
load_dotenv()

注意：.env文件必须放在项目根目录，且load_dotenv()要在任何导入OpenClaw模块之前调用，否则无效。

验证密钥是否被正确加载

运行以下最小验证脚本：

import os
print("API Key loaded:", bool(os.getenv("OPENCLAW_API_KEY")))

输出True表示成功；若为False，说明环境变量未生效或名称拼错。

大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！