技能库 / 效率工具 / 在 GCP 部署 OpenClaw

在 GCP 部署 OpenClaw

在 Google Cloud 上初始化与配置 OpenClaw 环境;项目、网络与密钥管理见 SKILL.md。

v1.0.0 divide-by-0
作者 / 来源

skillhub

在来源站打开

安装方式

CLI 安装(推荐)

claw install shub-create-new-openclaw-in-gcp

需要安装 CLAW CLI

手动下载安装

下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常,本站会改为提示页 + 原始链接,请按页内说明操作。

下载 ZIP (shub-create-new-openclaw-in-gcp-v1.0.0.zip)

触发指令

/openclaw-cloud-setup-ski

使用指南

在 GCP 部署 OpenClaw

围绕 在 GCP 部署 OpenClaw:在 Google Cloud 上初始化与配置 OpenClaw 环境;项目、网络与密钥管理见 SKILL.md。 无需在每次任务前把零散英文说明手工拼进上下文,也 减少 与客户端默认行为脱节的试错;具体命令、钩子与 JSON 参数仍以 ZIP 包内 SKILL.md 为权威。下文结构与站内 MCP CLI 类专题稿相同:何时用、前置、流程、速查与故障。

何时使用

  • 在 Google Cloud 上初始化与配置 OpenClaw 环境
  • 项目、网络与密钥管理见 SKILL.md
  • 已获取本技能 ZIP,并准备在 Claude Code / OpenClaw 中按 SKILL.md 挂载。
  • 希望用中文专题稿快速判断「该不该启用」,再深入英文 SKILL 查参数与边界。
  • 需要与团队对齐同一套触发方式、目录约定或回调格式时。

前置条件

  • 通用:可运行 Claude Code 或文档要求的客户端;有可读写的项目工作区(或 SKILL.md 指定的沙箱目录)。
  • 权威细节:API Key / OAuth、钩子路径、环境变量以 ZIP 内 SKILL.md 为准。
  • OpenClaw:实例可访问本机或远端的 Claude Code / 脚本路径,网络与权限与当前部署一致。

典型流程

  1. 从 ClawHub / 站内分发获取技能 ZIP,校验版本与校验和(若提供)。
  2. 阅读 SKILL.md 的安装段落:目录落点、客户端类型(Claude Code / OpenClaw / 脚本)。
  3. 用文档中的最小示例完成第一次调用(单文件修改、单次查询或单次委派)。
  4. 确认工作目录、权限边界与输出路径后,再处理多文件或长耗时任务。
  5. 需要回调 / Webhook / 通知时,按 SKILL.md 配置端点并在测试环境先验通。

与 ZIP / SKILL.md 的关系

站内专题稿与 MCP CLI 类 oss 稿同样:概括何时用、怎么接、怎么排错命令模板、钩子名、JSON 字段、版本矩阵一律以 ZIP 内 SKILL.md 与 ClawHub 上游为准。

命令示例(摘自包内 SKILL.md)

以下为从上游 SKILL.md(或入库正文)自动抽取的终端/脚本片段;路径、环境变量与参数以当前 ZIP 与官方说明为准。

ClawHub slugcreate-new-openclaw-in-gcp(安装命令以 SKILL.md / claw CLI 为准)。

export OPENCLAW_PROJECT_ID="your-gcp-project"
export OPENCLAW_USERNAME="your-ssh-username"
export ANTHROPIC_TOKEN="sk-ant-oat01-..."   # Keep secret
export BRAVE_API_KEY="..."                   # Keep secret
chmod +x openclaw-quick-setup.sh
./openclaw-quick-setup.sh
# Set variables first (see above)
ZONE="us-central1-a"
VM="openclaw"

# Create VM
gcloud compute instances create "$VM" \
  --project="$OPENCLAW_PROJECT_ID" --zone="$ZONE" \
  --machine-type=e2-medium \
  --image-family=debian-12 --image-project=debian-cloud \
  --boot-disk-size=10GB \
  --metadata=ssh-keys="${OPENCLAW_USERNAME}:$(cat ~/.ssh/id_ed25519.pub)"

IP=$(gcloud compute instances describe "$VM" \
  --project="$OPENCLAW_PROJECT_ID" --zone="$ZONE" \
  --format='get(networkInterfaces[0].accessConfigs[0].natIP)')

# Wait for SSH, then run setup
sleep 30
ssh -o StrictHostKeyChecking=no "${OPENCLAW_USERNAME}@${IP}" "
set -euo pipefail
sudo apt-get update && sudo apt-get install -y git curl ufw jq
curl -fsSL https://tailscale.com/install.sh | sh
"

# Manual: authorize Tailscale
ssh "${OPENCLAW_USERNAME}@${IP}" "sudo tailscale up"

# Continue setup
ssh "${OPENCLAW_USERNAME}@${IP}" "
set -euo pipefail
sudo ufw allow 22/tcp && sudo ufw allow in on tailscale0 && echo y | sudo ufw enable
echo 'nameserver 8.8.8.8' | sudo tee -a /etc/resolv.conf
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.nvm/nvm.sh && nvm install 22
source ~/.nvm/nvm.sh && npm install -g openclaw@latest
"

# Configure OpenClaw (credentials via stdin)
ssh "${OPENCLAW_USERNAME}@${IP}" '
source ~/.nvm/nvm.sh
openclaw onboard --non-interactive --accept-risk \
  --auth-choice token --token-provider anthropic \
  --token "$(cat)" --gateway-bind loopback --install-daemon
' <<< "$ANTHROPIC_TOKEN"

# Add Brave key + enable Tailscale auth
ssh "${OPENCLAW_USERNAME}@${IP}" "
set -euo pipefail
mkdir -p ~/.config/systemd/user/openclaw-gateway.service.d
cat > ~/.config/systemd/user/openclaw-gateway.service.d/brave.conf << CONF
[Service]
Environment=\"BRAVE_API_KEY=$(cat)\"
CONF
chmod 600 ~/.config/systemd/user/openclaw-gateway.service.d/brave.conf
systemctl --user daemon-reload
source ~/.nvm/nvm.sh
jq '.gateway.auth.allowTailscale = true' ~/.openclaw/openclaw.json > /tmp/oc.json
mv /tmp/oc.json ~/.openclaw/openclaw.json
chmod 600 ~/.openclaw/openclaw.json
openclaw gateway restart
sudo tailscale serve --bg 18789
" <<< "$BRAVE_API_KEY"

# Get dashboard URL
ssh "${OPENCLAW_USERNAME}@${IP}" "tailscale serve status"

# After first browser access, approve device
ssh "${OPENCLAW_USERNAME}@${IP}" 'source ~/.nvm/nvm.sh && openclaw devices list'
# Then: openclaw devices approve <REQUEST_ID>

站内入库时的触发命令(完整语义见 ZIP):

# 使用本技能时可在对话中引用或执行上述指令;完整参数与示例见下载包内 SKILL.md。
/openclaw-cloud-setup-ski

最佳实践

  • SKILL.md 再猜参数;站内专题稿不替代 schema 与必填字段说明。
  • 委派任务时写清验收标准(命令、文件路径、测试命令),减少来回追问。
  • 长任务用文档推荐的回调 / 日志落盘代替高频轮询,省 Token 也省机器负载。
  • 多技能同时启用时,注意钩子加载顺序与重复工具调用(以 SKILL.md 冲突说明为准)。

调试与排错

  • 打开 stderr 与客户端日志;PTY/tmux 场景同时看面板最后几十行输出。
  • 参数错误时对照 SKILL.md 中的 JSON/CLI 示例(引号、转义、工作目录)。
  • 网络类失败:查代理、防火墙、MCP 传输方式(stdio / HTTP / SSE)。
  • OpenClaw 侧核对 channel、路由与 Claude Code 进程是否仍在运行。

速查

| 动作 | 说明 | |------|------| | 获取技能包 | ClawHub / 站内 ZIP,核对版本 | | 权威步骤 | 优先阅读 ZIP 内 SKILL.md | | 首次试跑 | 使用 SKILL.md 最小示例 | | 验收 | 对照路径、测试命令或回调负载 | | OpenClaw | 路由、channel 与远端进程状态 |

常见故障

  • 无输出或立即退出 → 工作目录错误、依赖未装、或 Claude Code 未登录;按 SKILL.md 自检清单执行。
  • 权限被拒绝 → 检查沙箱路径、--permission-mode 与工具白名单。
  • 与简介不符 → 以英文 SKILL 与上游仓库为准,站内稿仅作结构化导读。