在本地部署OpenClaw（原Clawdbot）时，不同操作系统下配置环境变量的具体方法，这是部署过程中关键的一步，主要用于存储API密钥、模型配置等敏感信息，确保配置生效且不泄露。

---

一、环境变量配置核心原则

1. 持久化配置：配置后重启终端/服务仍生效（推荐）
2. 临时配置：仅当前终端会话有效（测试用）
3. 优先级：系统环境变量 > 自定义配置文件 > 命令行参数

二、不同操作系统配置方法

1. macOS/Linux 系统（持久化配置）

步骤1：确定终端类型

执行以下命令查看终端类型：

echo $SHELL

• 输出 /bin/zsh → 使用 ~/.zshrc（主流）
• 输出 /bin/bash → 使用 ~/.bash_profile 或 ~/.bashrc

步骤2：编辑配置文件

以 zsh 为例，打开配置文件：

# 用vim编辑（新手也可用nano或文本编辑器）
vim ~/.zshrc

步骤3：添加环境变量

在文件末尾添加需要的配置（示例）：

# OpenClaw 模型配置（OpenAI）
export OPENAI_API_KEY="sk-你的OpenAI密钥"
export OPENAI_BASE_URL="https://api.openai.com/v1"

# 阿里云百炼配置（可选）
export DASHSCOPE_API_KEY="你的阿里云API密钥"

# OpenClaw 网关端口（自定义）
export CLAWDBOT_GATEWAY_PORT="18789"

# Ollama 本地模型配置（可选）
export OLLAMA_BASE_URL="http://localhost:11434"

步骤4：生效配置

# 立即生效（无需重启终端）
source ~/.zshrc

# 验证是否生效
echo $OPENAI_API_KEY

✅ 输出你的密钥即配置成功。

2. Windows 系统（持久化配置）

方法A：图形界面配置（推荐新手）

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
2. 在「用户变量」或「系统变量」中点击「新建」：
   • 变量名：OPENAI_API_KEY
   • 变量值：sk-你的OpenAI密钥
   • 按需添加其他变量（如 DASHSCOPE_API_KEY）
3. 点击「确定」保存，重启终端/PowerShell 生效。

方法B：PowerShell 命令行配置（持久化）

# 设置用户级环境变量（推荐）
[Environment]::SetEnvironmentVariable(
    "OPENAI_API_KEY", 
    "sk-你的OpenAI密钥", 
    "User"
)

# 设置系统级环境变量（需管理员权限）
[Environment]::SetEnvironmentVariable(
    "CLAWDBOT_GATEWAY_PORT", 
    "18789", 
    "Machine"
)

✅ 验证：重启PowerShell，执行 echo $env:OPENAI_API_KEY 查看是否输出密钥。

3. 临时配置（仅当前会话有效，测试用）

• macOS/Linux：

  export OPENAI_API_KEY="sk-临时密钥"
  

• Windows PowerShell：

  $env:OPENAI_API_KEY="sk-临时密钥"
  

三、OpenClaw 专属配置文件（替代方案）

如果不想修改系统环境变量，可直接编辑 OpenClaw 配置文件：

1. 找到配置文件路径：~/.clawdbot/clawdbot.json（macOS/Linux）或 C:\Users\你的用户名\.clawdbot\clawdbot.json（Windows）
2. 编辑文件，添加环境变量相关配置：

{
  "env": {
    "OPENAI_API_KEY": "sk-你的密钥",
    "OLLAMA_BASE_URL": "http://localhost:11434"
  },
  "gateway": {
    "port": 18789
  }
}

3. 重启 OpenClaw 网关生效：

clawdbot gateway restart

四、验证配置是否生效

部署完成后，执行以下命令检测：

# 检测所有配置
clawdbot doctor

# 查看已加载的环境变量
clawdbot env list

如果输出中包含你配置的变量（如 OPENAI_API_KEY），且无红色错误提示，即配置成功。

---

总结

1. macOS/Linux：优先编辑 ~/.zshrc/~/.bash_profile，添加变量后执行 source 生效；
2. Windows：新手用图形界面配置环境变量，需重启终端；
3. 验证：通过 clawdbot doctor 或 clawdbot env list 确认变量加载成功；
4. 安全：不要将含密钥的配置文件提交到代码仓库，可通过 .gitignore 排除。