快速开始
Oracle Cloud
在 Oracle Cloud 的 Always Free ARM 层(最高 4 OCPU、24 GB RAM、200 GB 存储)上免费运行一个持久化的 OpenClaw Gateway 网关。
前提条件
- Oracle Cloud 账户(注册)——如果遇到问题,请参阅社区注册指南
- Tailscale 账户(可在 tailscale.com 免费注册)
- 一对 SSH 密钥
- 大约 30 分钟
设置
Create an OCI instance
- 登录 Oracle Cloud Console。
- 导航到 Compute > Instances > Create Instance。
- 配置:
- 名称:
openclaw - 镜像: Ubuntu 24.04 (aarch64)
- 形状:
VM.Standard.A1.Flex(Ampere ARM) - OCPU: 2(或最高 4)
- 内存: 12 GB(或最高 24 GB)
- 启动卷: 50 GB(最高 200 GB 免费)
- SSH 密钥: 添加你的公钥
- 名称:
- 点击 Create 并记下公网 IP 地址。
Connect and update the system
ssh ubuntu@YOUR_PUBLIC_IP
sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential
ARM 编译某些依赖项需要 build-essential。
Configure user and hostname
sudo hostnamectl set-hostname openclaw
sudo passwd ubuntu
sudo loginctl enable-linger ubuntu
启用 linger 可在退出登录后继续运行用户服务。
Install Tailscale
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --ssh --hostname=openclaw
从现在开始,通过 Tailscale 连接:ssh ubuntu@openclaw。
Install OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
source ~/.bashrc
当提示 “How do you want to hatch your bot?” 时,选择 Do this later。
Configure the gateway
将令牌认证与 Tailscale Serve 配合使用,以获得安全的远程访问。
openclaw config set gateway.bind loopback
openclaw config set gateway.auth.mode token
openclaw doctor --generate-gateway-token
openclaw config set gateway.tailscale.mode serve
openclaw config set gateway.trustedProxies '["127.0.0.1"]'
systemctl --user restart openclaw-gateway.service
这里的 gateway.trustedProxies=["127.0.0.1"] 仅用于本地 Tailscale Serve 代理的转发 IP/本地客户端处理。它不是 gateway.auth.mode: "trusted-proxy"。在此设置中,Diff 查看器路由会保持失败关闭行为:没有转发代理标头的原始 127.0.0.1 查看器请求可能返回 Diff not found。附件请使用 mode=file / mode=both,如果你需要可共享的查看器链接,请有意启用远程查看器并设置 plugins.entries.diffs.config.viewerBaseUrl(或传入代理 baseUrl)。
Lock down VCN security
在网络边界阻止除 Tailscale 之外的所有流量:
- 在 OCI Console 中进入 Networking > Virtual Cloud Networks。
- 点击你的 VCN,然后点击 Security Lists > Default Security List。
- 移除除
0.0.0.0/0 UDP 41641(Tailscale)之外的所有入站规则。 - 保留默认出站规则(允许所有出站流量)。
这会在网络边界阻止 22 端口上的 SSH、HTTP、HTTPS 以及其他所有流量。从此以后,你只能通过 Tailscale 连接。
Verify
openclaw --version
systemctl --user status openclaw-gateway.service
tailscale serve status
curl http://localhost:18789
从 tailnet 上的任意设备访问控制 UI:
https://openclaw.<tailnet-name>.ts.net/
将 <tailnet-name> 替换为你的 tailnet 名称(可在 tailscale status 中看到)。
验证安全姿态
在 VCN 已锁定(仅开放 UDP 41641)且 Gateway 网关绑定到 loopback 的情况下,公网流量会在网络边界被阻止,管理员访问仅限 tailnet。这消除了若干传统 VPS 加固步骤的必要性:
| 传统步骤 | 是否需要? | 原因 |
|---|---|---|
| UFW 防火墙 | 否 | VCN 会在流量到达实例之前阻止它。 |
| fail2ban | 否 | 22 端口在 VCN 处被阻止;没有暴力破解暴露面。 |
| sshd 加固 | 否 | Tailscale SSH 不使用 sshd。 |
| 禁用 root 登录 | 否 | Tailscale 按 tailnet 身份进行认证,而不是系统用户。 |
| 仅 SSH 密钥认证 | 否 | 同理——tailnet 身份取代系统 SSH 密钥。 |
| IPv6 加固 | 通常不需要 | 取决于 VCN/子网设置;请验证实际分配/暴露的内容。 |
仍然建议:
- 使用
chmod 700 ~/.openclaw限制凭证文件权限。 - 使用
openclaw security audit执行 OpenClaw 专用的安全姿态检查。 - 定期运行
sudo apt update && sudo apt upgrade以应用操作系统补丁。 - 定期查看 Tailscale 管理控制台中的设备。
快速验证命令:
# Confirm no public ports are listening
sudo ss -tlnp | grep -v '127.0.0.1\|::1'
# Verify Tailscale SSH is active
tailscale status | grep -q 'offers: ssh' && echo "Tailscale SSH active"
# Optional: disable sshd entirely once Tailscale SSH is confirmed working
sudo systemctl disable --now ssh
ARM 注意事项
Always Free 层是 ARM(aarch64)。大多数 OpenClaw 功能都能正常工作;少量原生二进制文件需要 ARM 构建:
- Node.js、Telegram、WhatsApp(Baileys):纯 JavaScript,没有问题。
- 大多数包含原生代码的 npm 包:有可用的预构建
linux-arm64构件。 - 可选 CLI 辅助工具(例如 Skills 随附的 Go/Rust 二进制文件):安装前检查是否有
aarch64/linux-arm64发布版本。
使用 uname -m 验证架构(应输出 aarch64)。对于没有 ARM 构建的二进制文件,请从源码安装或跳过。
持久化和备份
OpenClaw 状态位于:
~/.openclaw/——openclaw.json、每个智能体的auth-profiles.json、渠道/提供商状态以及会话数据。~/.openclaw/workspace/—— Agent 工作区(SOUL.md、记忆、构件)。
这些内容会在重启后保留。要创建可移植快照:
openclaw backup create
回退方案:SSH 隧道
如果 Tailscale Serve 无法工作,请从你的本地机器使用 SSH 隧道:
ssh -L 18789:127.0.0.1:18789 ubuntu@openclaw
然后打开 http://localhost:18789。
故障排除
实例创建失败(“Out of capacity”)——免费层 ARM 实例很受欢迎。请尝试不同的可用性域,或在非高峰时段重试。
Tailscale 无法连接——运行 sudo tailscale up --ssh --hostname=openclaw --reset 重新认证。
Gateway 网关无法启动——运行 openclaw doctor --non-interactive,并使用 journalctl --user -u openclaw-gateway.service -n 50 查看日志。
ARM 二进制文件问题——大多数 npm 包可在 ARM64 上工作。对于原生二进制文件,请查找 linux-arm64 或 aarch64 发布版本。使用 uname -m 验证架构。
后续步骤
- 渠道——连接 Telegram、WhatsApp、Discord 等
- Gateway 网关配置——所有配置选项
- 更新——让 OpenClaw 保持最新