OpenClaw 是连接模型、工具和对话的智能体运行环境。可以用独立 VPS 评估工作助手,无需授予它访问笔记本文件或公司生产凭据的权限。本指南从私有且受限的助手开始;邮件、浏览器和 shell 集成需日后明确添加,此处不启用。
目标环境: Ubuntu Server 24.04 LTS、x86-64、SSH 和 sudo 账户。文档审核日期:2026 年 11 月 15 日。命令尚未在 Ubuntu 上完成端到端测试。
开始之前
使用外部模型 API 的预构建网关可预留约 2 个 vCPU、4 GB 内存和 20 GB 可用磁盘。较大的浏览器任务需要更多资源。本地推理另有模型内存要求;API 订阅及用量费用与 VPS 托管独立。
这些资源数值仅为小规模评估的规划估算,不是性能保证或套餐规格。VPS/VDS 不代表包含 GPU。下单前请检查可用内存、存储和其他资源。
全新 Ubuntu 可使用以下软件包。如果 Docker 已从其他仓库安装,请保留并先检查兼容性,不要混用 Docker CE 和 docker.io 软件包。使用 Compose v2;缺少软件包时,请检查是否启用 Ubuntu Universe。
sudo apt update
sudo apt install -y docker.io docker-compose-v2 curl openssl
sudo systemctl enable --now docker
sudo docker compose version
所有示例仅将端口发布到服务器的 127.0.0.1。请从本机通过 SSH 隧道访问,无需域名。不要将这些端口开放到互联网。容器内部监听 0.0.0.0 不会改变宿主机端口仅绑定回环地址的事实。
以下项目均为全新安装。不要对现有部署重新执行密钥生成步骤。
1. 创建隔离项目
将网关令牌保存在此私有环境文件中。命名卷保留状态和独立的认证配置密钥目录,不挂载宿主机 Docker socket 或个人主目录。将以下配置保存为 compose.yaml。
umask 077
mkdir -p ~/ai-openclaw
cd ~/ai-openclaw
printf 'OPENCLAW_GATEWAY_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
services:
gateway:
image: ghcr.io/openclaw/openclaw:latest
init: true
restart: unless-stopped
env_file: .env
environment:
HOME: /home/node
ports:
- "127.0.0.1:18789:18789"
volumes:
- state:/home/node/.openclaw
- auth:/home/node/.config/openclaw
cap_drop: [NET_RAW, NET_ADMIN]
security_opt: [no-new-privileges:true]
command: ["node", "dist/index.js", "gateway", "--bind", "lan", "--port", "18789"]
volumes:
state:
auth:
2. 启动网关前完成初始化
运行交互向导,选择可用服务商和模型,提供自己的 API 凭据,保留令牌认证,暂时跳过渠道。当要求网关令牌时,使用私有 .env 中的值。不要在容器内安装宿主机守护服务。然后限制工具,只允许 SSH 隧道使用的两个本地浏览器源。
sudo docker compose pull
sudo docker compose run --rm --no-deps --entrypoint node gateway dist/index.js onboard --mode local --no-install-daemon
sudo docker compose run --rm --no-deps --entrypoint node gateway dist/index.js config set --batch-json '[{"path":"gateway.mode","value":"local"},{"path":"gateway.bind","value":"lan"},{"path":"gateway.controlUi.allowedOrigins","value":["http://localhost:18789","http://127.0.0.1:18789"]},{"path":"tools.profile","value":"minimal"}]'
sudo docker compose up -d gateway
sudo docker compose exec gateway node dist/index.js security audit --deep
3. 连接并测试无害任务
在本机替换 YOUR_USER 和 YOUR_SERVER_IP,保持 SSH 会话开启。打开 http://127.0.0.1:18789,使用网关令牌认证;如要求配对,仅批准自己的设备。让助手总结不含机密的示例文本。模型能回复只验证聊天功能,不代表获准执行命令。
ssh -N -L 127.0.0.1:18789:127.0.0.1:18789 YOUR_USER@YOUR_SERVER_IP
4. 有计划地添加工作集成
最小工具配置有意限制能力;授予特定功能前请检查审计结果。使用独立且范围有限的凭据,对有实质影响的操作要求批准,不要让不可信内容决定权限。容器化本身不是智能体沙箱。不要为方便任务挂载 Docker socket。请备份两个命名卷与 .env,认证状态或密钥任一丢失都可能导致恢复失败。
更新与恢复
升级前停止应用以制作一致性备份,将数据和密钥保留在 VPS 之外,并在独立实例测试恢复。示例中的浮动镜像标签用于初期评估;长期使用前请固定已审核的版本或摘要。可通过 sudo docker image inspect IMAGE_NAME --format '{{json .RepoDigests}}' 记录当前摘要。不要在未检查兼容性时无人值守升级,也不要用 down -v 删除持久卷。
启动失败时,请检查 sudo docker compose ps、近期日志、剩余磁盘和内存。不要分享包含密钥、提示词或个人数据的日志。目录权限出错时,应核对预期 UID/GID 与所有权,不要授予 777。共享访问前请配置 HTTPS、认证和请求限制。