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 检查是否正确加载。