Linux 下 OpenClaw 环境变量配置含临时生效、永久生效、专用 .env 文件三种方式，按步骤操作即可。

OPENclaw小龙虾本地一键部署安装简单实用快：www.totom.top

一、先确认 Shell（bash/zsh）

bash

运行

echo $SHELL

• /bin/bash→ 用~/.bashrc
• /bin/zsh→ 用~/.zshrc

二、临时生效（当前终端，重启失效）

直接复制执行，适合快速测试：

bash

运行

# 基础配置 export OPENCLAW_PORT=11451 export OPENCLAW_HOST=0.0.0.0 export OPENCLAW_LOG_LEVEL=info # 模型 API Key（按需填） export MOONSHOT_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # 把 openclaw 加入 PATH（关键） export PATH="$(npm prefix -g)/bin:$PATH"

验证：

bash

运行

openclaw -v env | grep OPENCLAW

三、永久生效（用户级，重启 / 新开终端都有效）

1）编辑配置文件（二选一）

bash

运行

# bash nano ~/.bashrc # zsh nano ~/.zshrc

2）粘贴到文件末尾（可直接复制）

bash

运行

# === OpenClaw 环境变量 === export OPENCLAW_PORT=11451 export OPENCLAW_HOST=0.0.0.0 export OPENCLAW_LOG_LEVEL=info # 模型密钥（替换成你自己的） export MOONSHOT_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # 确保 openclaw 命令能找到 export PATH="$(npm prefix -g)/bin:$PATH"

保存退出：nano 按Ctrl+O→ 回车 →Ctrl+X

3）立即生效

bash

运行

# bash source ~/.bashrc # zsh source ~/.zshrc

四、专用 .env 文件（安全，推荐）

OpenClaw 会自动读取~/.openclaw/.env，适合管理密钥。

1）创建目录与文件

bash

运行

mkdir -p ~/.openclaw nano ~/.openclaw/.env

2）写入内容（直接复制）

bash

运行

# ~/.openclaw/.env OPENCLAW_PORT=11451 OPENCLAW_HOST=0.0.0.0 OPENCLAW_LOG_LEVEL=info MOONSHOT_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

保存退出，设置权限（仅自己可读）：

bash

运行

chmod 600 ~/.openclaw/.env

3）启动时加载（二选一）

• 方式 1：启动前手动加载

bash

运行

source ~/.openclaw/.env openclaw start

• 方式 2：写入 shell 配置，每次自动加载

bash

运行

echo "source ~/.openclaw/.env" >> ~/.bashrc source ~/.bashrc

五、全局生效（所有用户，谨慎用）

bash

运行

sudo nano /etc/profile

粘贴下面内容，保存后source /etc/profile：

bash

运行

export OPENCLAW_PORT=11451 export OPENCLAW_HOST=0.0.0.0 export PATH="$(npm prefix -g)/bin:$PATH"

六、常用变量清单（可直接复制）

bash

运行

# 基础 OPENCLAW_PORT=11451 OPENCLAW_HOST=0.0.0.0 OPENCLAW_LOG_LEVEL=info # 模型 MOONSHOT_API_KEY=sk-xxx OPENAI_API_KEY=sk-xxx DEEPSEEK_API_KEY=sk-xxx # 路径（可选） OPENCLAW_HOME=~/.openclaw OPENCLAW_STATE_DIR=~/.openclaw/state

七、常见问题

• 提示command not found: openclaw→ 执行export PATH="$(npm prefix -g)/bin:$PATH"并写入配置文件。
• 面板打不开 → 检查OPENCLAW_PORT端口是否放行（防火墙 / 安全组）。
• API Key 不生效 → 用env | grep KEY检查是否正确加载。