OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

托管与部署

exe.dev

目标： 在 exe.dev 虚拟机上运行 OpenClaw Gateway 网关，并可通过 https://<vm-name>.exe.xyz 访问。

本指南假设使用 exe.dev 默认的 exeuntu 镜像。在其他发行版上，请对应调整软件包。

所需条件

  • exe.dev 账户
  • 通过 ssh exe.dev 访问 exe.dev 虚拟机的权限（可选，用于手动设置）

新手快速路径

  1. 打开 https://exe.new/openclaw
  2. 根据需要填写身份验证密钥或令牌
  3. 点击虚拟机旁边的 "Agent"，等待 Shelley 完成预配
  4. 打开 https://<vm-name>.exe.xyz/，使用已配置的共享密钥进行身份验证（默认使用令牌身份验证；如果切换 gateway.auth.mode，也可以使用密码身份验证）
  5. 使用 openclaw devices approve <requestId> 批准待处理的设备配对请求

使用 Shelley 自动安装

exe.dev 的智能体 Shelley 可以根据提示安装 OpenClaw：

text
Set up OpenClaw (https://docs.openclaw.ai/install) on this VM. Use the non-interactive and accept-risk flags for openclaw onboarding. Add the supplied auth or token as needed. Configure nginx to forward from the default port 18789 to the root location on the default enabled site config, making sure to enable Websocket support. Pairing is done by "openclaw devices list" and "openclaw devices approve <request id>". Make sure the dashboard shows that OpenClaw's health is OK. exe.dev handles forwarding from port 8000 to port 80/443 and HTTPS for us, so the final "reachable" should be <vm-name>.exe.xyz, without port specification.

手动安装

  • Create the VM

    在你的设备上运行：

    bash
    ssh exe.dev new

    然后连接：

    bash
    ssh <vm-name>.exe.xyz

  • Install prerequisites (on the VM)

    bash
    sudo apt-get updatesudo apt-get install -y git curl jq ca-certificates openssl

  • Install OpenClaw

    bash
    curl -fsSL https://openclaw.ai/install.sh | bash

  • Configure nginx to proxy to port 8000

    编辑 /etc/nginx/sites-enabled/default：

    nginx
    server {    listen 80 default_server;    listen [::]:80 default_server;    listen 8000;    listen [::]:8000;     server_name _;     location / {        proxy_pass http://127.0.0.1:18789;        proxy_http_version 1.1;         # WebSocket support        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";         # Standard proxy headers        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $remote_addr;        proxy_set_header X-Forwarded-Proto $scheme;         # Timeout settings for long-lived connections        proxy_read_timeout 86400s;        proxy_send_timeout 86400s;    }}

    请覆盖转发标头，而不是保留客户端提供的链。OpenClaw 只信任由显式配置的代理提供的转发 IP 元数据，并将追加式 X-Forwarded-For 链视为安全加固风险。

  • Access OpenClaw and approve devices

    打开 https://<vm-name>.exe.xyz/（参见新手引导输出中的 Control UI）。如果系统提示进行身份验证，请粘贴虚拟机中配置的共享密钥。

    本指南默认使用令牌身份验证，因此请使用 openclaw config get gateway.auth.token 获取 gateway.auth.token，或使用 openclaw doctor --n 生成新令牌。如果你已将 Gateway 网关切换为密码身份验证，请改用 gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD。

    使用 openclaw devices list 和 openclaw devices approve <requestId> 批准设备。如有疑问，请在浏览器中使用 Shelley。

    • 远程渠道设置

    对于远程主机，优先使用一次 config patch 调用，而不是通过多次 SSH 调用执行 config set。将真实令牌保存在虚拟机环境或 ~/.openclaw/.env 中，并且只在 openclaw.json 中放置 SecretRef。完整的 SecretRef 契约请参阅密钥管理。

    在虚拟机上，让服务环境包含其所需的密钥：

    bash
    cat >> ~/.openclaw/.env <<'EOF'SLACK_BOT_TOKEN=xoxb-...SLACK_APP_TOKEN=xapp-...DISCORD_BOT_TOKEN=...OPENAI_API_KEY=sk-...EOF

    在本地计算机上创建补丁文件，并通过管道将其传输到虚拟机：

    json5
    // openclaw.remote.patch.json5{  secrets: {    providers: {      default: { source: "env" },    },  },  channels: {    slack: {      enabled: true,      mode: "socket",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      groupPolicy: "open",      requireMention: false,    },    discord: {      enabled: true,      token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },      dmPolicy: "disabled",      dm: { enabled: false },      groupPolicy: "allowlist",    },  },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },      models: {        "openai/gpt-5.6-sol": { params: { fastMode: true } },      },    },  },}
    bash
    ssh <vm-name>.exe.xyz 'openclaw config patch --stdin --dry-run' < ./openclaw.remote.patch.json5ssh <vm-name>.exe.xyz 'openclaw config patch --stdin' < ./openclaw.remote.patch.json5ssh <vm-name>.exe.xyz 'openclaw gateway restart && openclaw health'

    当嵌套允许列表需要完全替换为补丁值时，请使用 --replace-path，例如替换 Discord 渠道允许列表：

    bash
    ssh <vm-name>.exe.xyz 'openclaw config patch --stdin --replace-path "channels.discord.guilds[\"123\"].channels"' < ./discord.patch.json5

    完整的频道配置参考请参阅 Discord 和 Slack。

    远程访问

    exe.dev 负责处理远程访问的身份验证。默认情况下，来自端口 8000 的 HTTP 流量会转发到 https://<vm-name>.exe.xyz，并使用电子邮件身份验证。

    更新

    bash
    openclaw update

    有关渠道切换和手动恢复，请参阅更新。

    相关内容

    Was this useful?
    On this page

    On this page