🚀 部署与运维

Docker、Nix、云服务器部署，远程访问、更新维护全攻略

📦 部署方式对比

🐳

Docker

⭐⭐

适用：服务器部署、隔离环境、快速迁移

✅ 优点

• 环境隔离
• 易于迁移
• 版本控制

❌ 缺点

• 需要 Docker 知识
• 资源占用稍高

❄️

Nix

⭐⭐⭐

适用：NixOS 用户、可复现构建

✅ 优点

• 完全可复现
• 依赖管理优秀
• 原子升级

❌ 缺点

• 学习曲线陡峭
• 社区相对小众

📦

npm 全局安装

⭐

适用：本地开发、快速体验

✅ 优点

• 最简单
• 更新方便
• 资源占用低

❌ 缺点

• 依赖本地 Node 环境
• 不够隔离

☁️

云服务器

⭐⭐

适用：24/7 运行、远程访问

✅ 优点

• 随时在线
• 公网访问
• 专业运维

❌ 缺点

• 需要付费
• 配置复杂

🐳

Docker 部署

推荐的生产环境部署方式

快速启动

docker pull openclaw/openclaw:latest

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e ANTHROPIC_API_KEY=your-key \
  openclaw/openclaw:latest

Docker Compose

version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "18789:18789"
    volumes:
      - ./openclaw-data:/root/.openclaw
    environment:
      - ANTHROPIC_API_KEY=your-key
      - OPENCLAW_LOG_LEVEL=info
    restart: unless-stopped

💡 小贴士：使用 -v 挂载数据目录防止数据丢失，docker logs -f openclaw 查看实时日志

🌐 远程访问

🔒

Tailscale

零配置 VPN，最简单安全的远程访问方案

在 Gateway 和客户端都安装 Tailscale
确保两台设备在同一个 tailnet
Gateway 会自动通过 Tailscale IP 可访问

🔑

SSH 隧道

通过 SSH 端口转发访问远程 Gateway

本地运行: ssh -L 18789:localhost:18789 user@remote-server
然后访问本地的 http://localhost:18789
或使用 -N -f 后台运行

🔄 更新方法

npm/pnpm npm install -g openclaw@latest

Docker docker pull openclaw/openclaw:latest && docker restart openclaw

Nix nix-env -u openclaw

🛠️ 日常维护

查看日志

openclaw logs

openclaw logs --follow

openclaw logs --since 1h

健康检查

openclaw doctor

openclaw gateway status

备份恢复

cp -r ~/.openclaw ~/.openclaw.backup

tar -czf backup.tar.gz ~/.openclaw

清理维护

openclaw sessions prune

openclaw memory compact

←

🍎 平台指南

故障排查 🔧

→