常见问题

# 使用 nvm 安装最新版本
nvm install 22
nvm use 22

# 或使用 n
npm install -g n
n latest

# 验证版本
node --version

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

npm install -g pnpm
pnpm install -g openclaw@latest

npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080

# 检查端口是否被占用
netstat -an | grep 18789

# 使用其他端口
docker run -p 18790:18789 openclaw

# 添加当前用户到 docker 组
sudo usermod -aG docker $USER

# 重新登录或执行
newgrp docker

docker logs openclaw

{
  "models": {
    "default": {
      "provider": "ollama",
      "model": "llama2",
      "baseURL": "http://localhost:11434"
    }
  }
}

# 查看配置文件路径
openclaw config path

# 编辑配置
openclaw config edit

# 验证配置
openclaw config validate

{
  "models": {
    "default": {
      "provider": "kimi",
      "apiKey": "sk-xxx",
      "model": "moonshot-v1-8k"
    },
    "coding": {
      "provider": "claude",
      "apiKey": "sk-xxx",
      "model": "claude-3-sonnet"
    },
    "cheap": {
      "provider": "deepseek",
      "apiKey": "sk-xxx",
      "model": "deepseek-chat"
    }
  }
}

openclaw status

# 测试 Token
curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

openclaw logs --tail 50

# 测试 Telegram API 连通性
curl https://api.telegram.org

openclaw restart

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "telegram-bot-token"
    },
    "discord": {
      "enabled": true,
      "token": "discord-bot-token"
    },
    "feishu": {
      "enabled": true,
      "appId": "feishu-app-id",
      "appSecret": "feishu-app-secret"
    }
  }
}

openclaw skill install <skill-name>

npm install -g @openclaw/skill-<name>

openclaw skill install github:username/repo

openclaw restart

openclaw skill list

openclaw skill enable <skill-name>

openclaw skill logs <skill-name>

# 安装 Chromium
npx puppeteer browsers install chrome

# 或指定系统已有的 Chrome
export PUPPETEER_EXECUTABLE_PATH=/usr/bin/google-chrome

# 运行测试确保一切就绪
openclaw skill test browser

{
  "security": {
    "pairing": {
      "enabled": true,
      "token": "your-secret-token"
    },
    "whitelist": {
      "enabled": true,
      "users": ["user-id-1", "user-id-2"]
    },
    "skillSandbox": true,
    "auditLog": true
  }
}

export OPENCLAW_API_KEY="sk-xxx"
openclaw start

{
  "safety": {
    "confirmDangerousActions": true,
    "dangerousActions": [
      "file.delete",
      "system.shutdown",
      "browser.submit"
    ]
  }
}

{
  "cache": {
    "enabled": true,
    "ttl": 3600,
    "maxSize": "1GB"
  }
}

{
  "concurrency": {
    "maxConcurrentRequests": 5,
    "queueSize": 100
  }
}

# 查看当前运行版本
openclaw --version

# NPM 升级到最新发布版本
npm update -g openclaw

# 如果出错，也可以重新覆盖安装
npm install -g openclaw@latest

# 切换到 beta 通道
openclaw update --channel beta

# 出现问题可随时切回 stable
openclaw update --channel stable

# 打包备份配置主目录
tar -czf openclaw-backup.tar.gz ~/.openclaw/

# 部署至新机器解压覆盖
tar -xzf openclaw-backup.tar.gz -C ~/

{
  "backup": {
    "enabled": true,
    "schedule": "0 2 * * *",
    "retention": 7
  }
}

# 检查当前的强制配对 token
openclaw config get security.pairing.token

# 令其重置 token 防火墙
openclaw pairing reset

# （危险）也可以选择完全裸奔使用，但不推荐
openclaw config set security.pairing.enabled false

{
  "rateLimit": {
    "enabled": true,
    "maxRequestsPerMinute": 60,
    "queue": true
  }
}

{
  "logging": {
    "level": "info",
    "maxSize": "100MB",
    "maxFiles": 5,
    "compress": true
  }
}

# 安全剔除掉 7 天前的历史冗余记录
openclaw logs clean --older-than 7d

# 刷写新版本 Node.js 支持底包
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 拉取安装主体包
npm install -g openclaw@latest

{
  "language": "zh-CN"
}