先确认前提:你需要一个 Control Plane 账号、一套可用的 Global Virtual Cloud,以及可访问模型和聊天平台的凭据。准备 OpenClaw 所需模型时,可选 Anthropic、OpenAI,或 OpenRouter、LiteLLM 这类 OpenAI 兼容端点;若要通过 Telegram、Slack、Discord 或 WhatsApp 使用,还需对应的机器人凭据,其中 WhatsApp 不需要 bot token。

进入 Console 的 Template Catalog,搜索并安装 OpenClaw 模板,也可从 CLI、Terraform 或 Pulumi 启动。安装后不要立刻开放公网入口:Gateway 默认没有公网端点,只有同一 GVC 内的负载能够访问,跨工作负载流量使用 mTLS。模板会同时准备 Gateway、存储、身份和 Headless Chromium,并注册名为 cpln 的 Control Plane MCP 服务。
准备访问入口时,在本机运行 cpln port-forward,将端口转发到 OpenClaw 的 Control UI。完成初始化后,你应能看到内置控制界面、配置与运行状态;只有确实需要外部访问时才开启 public access,并可绑定自定义域名。因为聊天渠道通常主动向外连接,所以仅用 Slack 或 Telegram 时,可以全程保持无公网 URL 的私有部署。
在 Control Plane 中创建一个字典 secret,至少写入 gateway-token、llm-api-key,以及每个聊天渠道的 bot token;gateway-token 至少 24 个字符,建议使用更长且随机的值。模板会创建最小权限策略,只允许工作负载读取这个 secret 和不含凭据的首次启动配置。注意,Gateway token 是完整管理员凭据,不要提交到仓库、Helm values 或安装命令中。

首次使用时,在终端显式登录 Control Plane MCP 服务。默认共享模式下,你登录一次后,获准的聊天联系人会通过你的账号执行操作,因此最好使用权限受限的专用 Control Plane 用户,或者将 cplnMcp.enabled 设为 false。登录完成后,智能体即可在聊天中调用 Control Plane API 工具,相关平台操作会进入审计轨迹;MCP 未登录前不会执行管理动作。
运行期间可观察内置日志、指标和平台审计记录。状态保存在 10 GiB 卷中,配置、会话、插件、工作区和记忆都在其中;每日 03:00 UTC 会生成快照,默认保留 7 天,快照计划与保留期均可调整。卷自动扩容默认关闭,若要长期保存大量会话或记忆,应提前启用并确认容量策略,避免磁盘写满导致 Gateway 中断。
需要轮换密钥时,先执行 cpln secret reveal SECRET_NAME -o yaml 导出,编辑后用 cpln apply -f 重新应用,并立即删除含明文密钥的导出文件,最后运行 cpln workload force-redeployment。重启会读取新值,但 OpenClaw 只有单个 Gateway,助手会短暂离线,文中给出的经验值约为 4 分钟;由于默认每 30 分钟运行一次 heartbeat,即使无人发消息也会消耗模型额度,因此应在低峰期操作并为模型账户设置消费上限。

常见坑包括把 Gateway token 当作普通 API key、过早开放公网入口、忘记 MCP 显式登录,以及误以为修改 secret 就能使已泄露 token 失效。若凭据外泄,除更新 secret 外,还要到对应提供商处撤销旧 token;启用公网访问时还要考虑智能体拥有 shell、浏览器和第三方技能,应按其消息来源和网页内容授予最小权限,并用快照与审计记录核对异常操作。
OpenClaw—AI研究