Files
Moltbot/docs/zh-CN/platforms/oracle.md
Seb Slight c18452598a docs: restructure Get Started tab and improve onboarding flow (#9950)
* docs: restructure Get Started tab and improve onboarding flow

- Flatten nested Onboarding group into linear First Steps flow
- Add 'What is OpenClaw?' narrative section to landing page
- Split wizard.md into streamlined overview + full reference (reference/wizard.md)
- Move Pairing to Channels > Configuration
- Move Bootstrapping to Agents > Fundamentals
- Move macOS app onboarding to Platforms > macOS companion app
- Move Lore to Help > Community
- Remove duplicate install instructions from openclaw.md
- Mirror navigation changes in zh-CN tabs
- No content deleted — all detail preserved or relocated

* docs: move deployment pages to install/, fix Platforms tab routing, clarify onboarding paths

- Move deployment guides (fly, hetzner, gcp, macos-vm, exe-dev, railway, render,
  northflank) from platforms/ and root to install/
- Add 'Hosting and deployment' group to Install tab
- Slim Gateway & Ops 'Remote access and deployment' down to 'Remote access'
- Swap Platforms tab before Gateway & Ops to fix path-prefix routing
- Move macOS app onboarding into First steps (parallel to CLI wizard)
- Rename sidebar titles to 'Onboarding: CLI' / 'Onboarding: macOS App'
- Add redirects for all moved paths
- Update all internal links (en + zh-CN)
- Fix img tag syntax in onboarding.md
2026-02-05 17:45:01 -05:00

9.3 KiB
Raw Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
在 Oracle Cloud 上设置 OpenClaw
寻找 OpenClaw 的低成本 VPS 托管
想要在小型服务器上 24/7 运行 OpenClaw
在 Oracle Cloud 上运行 OpenClawAlways Free ARM Oracle Cloud
generated_at model provider source_hash source_path workflow
2026-02-03T07:53:25Z claude-opus-4-5 pi d3cc337b40ea512b5756ac15ec4341fecad417ede75f717fea3035678c7c6697 platforms/oracle.md 15

在 Oracle CloudOCI上运行 OpenClaw

目标

在 Oracle Cloud 的 Always Free ARM 层上运行持久化的 OpenClaw Gateway 网关。

Oracle 的免费层非常适合 OpenClaw特别是如果你已经有 OCI 账户),但有一些权衡:

  • ARM 架构(大多数东西都能工作,但某些二进制文件可能仅支持 x86
  • 容量和注册可能比较麻烦

成本比较2026

提供商 方案 配置 价格/月 说明
Oracle Cloud Always Free ARM 最多 4 OCPU24GB RAM $0 ARM容量有限
Hetzner CX22 2 vCPU4GB RAM ~ $4 最便宜的付费选项
DigitalOcean Basic 1 vCPU1GB RAM $6 易用的 UI文档完善
Vultr Cloud Compute 1 vCPU1GB RAM $6 多个地区
Linode Nanode 1 vCPU1GB RAM $5 现为 Akamai 的一部分

先决条件

1) 创建 OCI 实例

  1. 登录 Oracle Cloud Console
  2. 导航到 Compute → Instances → Create Instance
  3. 配置:
    • Name: openclaw
    • Image: Ubuntu 24.04 (aarch64)
    • Shape: VM.Standard.A1.FlexAmpere ARM
    • OCPUs: 2或最多 4
    • Memory: 12 GB或最多 24 GB
    • Boot volume: 50 GB最多 200 GB 免费)
    • SSH key: 添加你的公钥
  4. 点击 Create
  5. 记录公网 IP 地址

提示: 如果实例创建失败并显示"Out of capacity",尝试不同的可用性域或稍后重试。免费层容量有限。

2) 连接并更新

# 通过公网 IP 连接
ssh ubuntu@YOUR_PUBLIC_IP

# 更新系统
sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential

注意: build-essential 是某些依赖项 ARM 编译所必需的。

3) 配置用户和主机名

# 设置主机名
sudo hostnamectl set-hostname openclaw

# 为 ubuntu 用户设置密码
sudo passwd ubuntu

# 启用 lingering注销后保持用户服务运行
sudo loginctl enable-linger ubuntu

4) 安装 Tailscale

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --ssh --hostname=openclaw

这会启用 Tailscale SSH所以你可以从 tailnet 上的任何设备通过 ssh openclaw 连接——不需要公网 IP。

验证:

tailscale status

从现在开始,通过 Tailscale 连接: ssh ubuntu@openclaw(或使用 Tailscale IP

5) 安装 OpenClaw

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

当提示"How do you want to hatch your bot?"时,选择 "Do this later"

注意:如果你遇到 ARM 原生构建问题,在使用 Homebrew 之前先从系统包开始(例如 sudo apt install -y build-essential)。

6) 配置 Gateway 网关loopback + 令牌认证)并启用 Tailscale Serve

使用令牌认证作为默认值。它是可预测的,避免需要任何"不安全认证"的控制 UI 标志。

# 在 VM 上保持 Gateway 网关私有
openclaw config set gateway.bind loopback

# 要求 Gateway 网关 + 控制 UI 的认证
openclaw config set gateway.auth.mode token
openclaw doctor --generate-gateway-token

# 通过 Tailscale Serve 暴露HTTPS + tailnet 访问)
openclaw config set gateway.tailscale.mode serve
openclaw config set gateway.trustedProxies '["127.0.0.1"]'

systemctl --user restart openclaw-gateway

7) 验证

# 检查版本
openclaw --version

# 检查守护进程状态
systemctl --user status openclaw-gateway

# 检查 Tailscale Serve
tailscale serve status

# 测试本地响应
curl http://localhost:18789

8) 锁定 VCN 安全

现在一切正常工作了,锁定 VCN 以阻止除 Tailscale 之外的所有流量。OCI 的虚拟云网络充当网络边缘的防火墙——流量在到达你的实例之前就被阻止。

  1. 在 OCI Console 中转到 Networking → Virtual Cloud Networks
  2. 点击你的 VCN → Security Lists → Default Security List
  3. 移除除以下之外的所有入站规则:
    • 0.0.0.0/0 UDP 41641Tailscale
  4. 保留默认出站规则(允许所有出站)

这会在网络边缘阻止端口 22 上的 SSH、HTTP、HTTPS 和其他所有内容。从现在开始,你只能通过 Tailscale 连接。


访问控制 UI

从你 Tailscale 网络上的任何设备:

https://openclaw.<tailnet-name>.ts.net/

<tailnet-name> 替换为你的 tailnet 名称(在 tailscale status 中可见)。

不需要 SSH 隧道。Tailscale 提供:

  • HTTPS 加密(自动证书)
  • 通过 Tailscale 身份认证
  • 从 tailnet 上的任何设备(笔记本电脑、手机等)访问

安全VCN + Tailscale推荐基线

通过锁定 VCN仅开放 UDP 41641并将 Gateway 网关绑定到 loopback你获得了强大的纵深防御公共流量在网络边缘被阻止管理访问通过你的 tailnet 进行。

此设置通常消除了纯粹为了阻止互联网范围的 SSH 暴力破解而需要额外的基于主机的防火墙规则的需求——但你仍应保持操作系统更新,运行 openclaw security audit,并验证你没有意外地在公共接口上监听。

已经受保护的内容

传统步骤 是否需要? 原因
UFW 防火墙 VCN 在流量到达实例之前就阻止了
fail2ban 如果端口 22 在 VCN 被阻止则无暴力破解
sshd 加固 Tailscale SSH 不使用 sshd
禁用 root 登录 Tailscale 使用 Tailscale 身份,而不是系统用户
仅 SSH 密钥认证 Tailscale 通过你的 tailnet 认证
IPv6 加固 通常不需要 取决于你的 VCN/子网设置;验证实际分配/暴露的内容

仍然推荐

  • 凭证权限: chmod 700 ~/.openclaw
  • 安全审计: openclaw security audit
  • 系统更新: 定期 sudo apt update && sudo apt upgrade
  • 监控 TailscaleTailscale 管理控制台 中查看设备

验证安全态势

# 确认没有公共端口在监听
sudo ss -tlnp | grep -v '127.0.0.1\|::1'

# 验证 Tailscale SSH 处于活动状态
tailscale status | grep -q 'offers: ssh' && echo "Tailscale SSH active"

# 可选:完全禁用 sshd
sudo systemctl disable --now ssh

备用方案SSH 隧道

如果 Tailscale Serve 不工作,使用 SSH 隧道:

# 从你的本地机器(通过 Tailscale
ssh -L 18789:127.0.0.1:18789 ubuntu@openclaw

然后打开 http://localhost:18789


故障排除

实例创建失败("Out of capacity"

免费层 ARM 实例很受欢迎。尝试:

  • 不同的可用性域
  • 在非高峰时段(清晨)重试
  • 选择 shape 时使用"Always Free"过滤器

Tailscale 无法连接

# 检查状态
sudo tailscale status

# 重新认证
sudo tailscale up --ssh --hostname=openclaw --reset

Gateway 网关无法启动

openclaw gateway status
openclaw doctor --non-interactive
journalctl --user -u openclaw-gateway -n 50

无法访问控制 UI

# 验证 Tailscale Serve 正在运行
tailscale serve status

# 检查 Gateway 网关是否在监听
curl http://localhost:18789

# 如需要则重启
systemctl --user restart openclaw-gateway

ARM 二进制文件问题

某些工具可能没有 ARM 构建。检查:

uname -m  # 应该显示 aarch64

大多数 npm 包工作正常。对于二进制文件,寻找 linux-arm64aarch64 版本。


持久化

所有状态存储在:

  • ~/.openclaw/ — 配置、凭证、会话数据
  • ~/.openclaw/workspace/ — 工作区SOUL.md、记忆、产物

定期备份:

tar -czvf openclaw-backup.tar.gz ~/.openclaw ~/.openclaw/workspace

另请参阅