编辑 bashrc 或 zshrc

我来帮你配置 AI小龙虾 (OpenClaw) 的环境变量,以下是详细步骤：

基础环境变量配置

Linux/macOS 系统

# 添加以下内容
export OPENCLAW_HOME=/path/to/openclaw  # 替换为实际安装路径
export PATH=$OPENCLAW_HOME/bin:$PATH
export PYTHONPATH=$OPENCLAW_HOME/src:$PYTHONPATH
# 使配置生效
source ~/.bashrc

Windows 系统

# 方法1：通过系统属性
# 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
# 新建系统变量：
# 变量名：OPENCLAW_HOME
# 变量值：C:\path\to\openclaw
# 编辑Path变量，添加：%OPENCLAW_HOME%\bin
# 方法2：PowerShell临时设置
$env:OPENCLAW_HOME = "C:\path\to\openclaw"
$env:Path += ";$env:OPENCLAW_HOME\bin"

完整配置文件示例

创建配置文件 ~/.openclawrc：

#!/bin/bash
# OpenClaw 环境配置
# 基础路径
export OPENCLAW_HOME="$HOME/code/openclaw"
export OPENCLAW_MODELS="$OPENCLAW_HOME/models"
export OPENCLAW_DATA="$OPENCLAW_HOME/data"
export OPENCLAW_LOG="$OPENCLAW_HOME/logs"
# Python 相关
export PYTHONPATH="$OPENCLAW_HOME/src:$PYTHONPATH"
export PYTHONIOENCODING=utf-8
# 模型配置（根据实际使用的模型调整）
export OPENCLAW_MODEL_NAME="claw-model"
export OPENCLAW_MODEL_PATH="$OPENCLAW_MODELS/$OPENCLAW_MODEL_NAME"
# 硬件加速配置
export CUDA_VISIBLE_DEVICES="0"  # 使用GPU 0
export TF_FORCE_GPU_ALLOW_GROWTH="true"
# 日志级别
export OPENCLAW_LOG_LEVEL="INFO"

Docker 环境变量配置

如果使用 Docker，在 docker-compose.yml 中：

version: '3.8'
services:
  openclaw:
    image: openclaw:latest
    environment:
      - OPENCLAW_HOME=/app
      - OPENCLAW_MODELS=/app/models
      - PYTHONPATH=/app/src
      - CUDA_VISIBLE_DEVICES=0
    volumes:
      - ./models:/app/models
      - ./data:/app/data

验证配置

创建验证脚本 check_env.py：

import os
import sys
def check_env():
    required_vars = ['OPENCLAW_HOME', 'OPENCLAW_MODELS']
    print("=== OpenClaw 环境检查 ===")
    for var in required_vars:
        value = os.getenv(var)
        if value:
            print(f"✓ {var}: {value}")
        else:
            print(f"✗ {var}: 未设置")
    # 检查路径是否存在
    openclaw_home = os.getenv('OPENCLAW_HOME')
    if openclaw_home:
        if os.path.exists(openclaw_home):
            print(f"✓ OpenClaw目录存在: {openclaw_home}")
        else:
            print(f"✗ OpenClaw目录不存在: {openclaw_home}")
    print(f"\nPython路径:")
    for path in sys.path:
        print(f"  {path}")
if __name__ == "__main__":
    check_env()

运行验证：

python check_env.py

常用环境变量说明

自动化安装脚本

#!/bin/bash
# install_openclaw_env.sh
set -e
OPENCLAW_DIR="${1:-$HOME/openclaw}"
echo "正在安装 OpenClaw 环境到: $OPENCLAW_DIR"
# 创建目录
mkdir -p $OPENCLAW_DIR/{bin,models,data,logs,src}
# 克隆代码（如果是git仓库）
# git clone https://github.com/yourrepo/openclaw.git $OPENCLAW_DIR
# 创建配置文件
cat > ~/.bashrc_openclaw << EOF
# OpenClaw 环境配置
export OPENCLAW_HOME="$OPENCLAW_DIR"
export PATH="\$OPENCLAW_HOME/bin:\$PATH"
export PYTHONPATH="\$OPENCLAW_HOME/src:\$PYTHONPATH"
export OPENCLAW_MODELS="\$OPENCLAW_HOME/models"
export OPENCLAW_DATA="\$OPENCLAW_HOME/data"
EOF
# 添加到bashrc
echo "source ~/.bashrc_openclaw" >> ~/.bashrc
echo "安装完成！请运行: source ~/.bashrc"

常见问题解决

1. 环境变量不生效

   • 检查配置文件是否正确加载
   • 重启终端或运行 source ~/.bashrc

2. Python导入错误

   • 确认 PYTHONPATH 包含源代码目录
   • 检查 Python 版本兼容性

3. 模型路径问题

   • 确保 OPENCLAW_MODELS 目录存在且包含模型文件
   • 检查文件权限

需要我帮你调整某个特定系统的配置吗？

标签： 编辑 Shell配置文件