人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载本指南以 docs/platforms/gcp.md 为主体讲解如何在 Google Cloud 的 Compute Engine 虚拟机上用 Docker 把一个生产级的 OpenClaw 中文版 Gateway 7×24 小时跑起来。读完你能够独立完成从「创建 GCP 项目 → 建 VM → 装 Docker → 构建镜像 → SSH 隧道访问控制台」的完整链路并掌握状态持久化、外部二进制烘焙、安全访问与故障升级等生产环境必备技能。方案目标与适用场景本方案要解决的核心问题是让 Gateway 稳定、持续地运行在云端虚拟机上而不是只在你的笔记本上偶尔开机。具体来说创建 GCP 项目并启用计费创建一个 Compute Engine 虚拟机在 VM 上安装 Docker隔离的应用运行时在 Docker 中启动 OpenClaw Gateway把~/.openclaw与~/clawd持久化到宿主机重启、重建都不丢失通过 SSH 隧道从笔记本访问 Control UI。如果你想要「每月约 $5–12 的 7×24 小时 Clawdbot」这是 Google Cloud 上一个可靠的落地方式。价格会随机器类型和区域浮动建议先选能满足负载的最小 VM出现 OOM 再升级。访问 Gateway 的两种方式从笔记本做 SSH 端口转发推荐安全性最高直接暴露端口前提是你自己管理好防火墙与令牌安全参考 网关安全。本指南以 GCP Compute Engine 上的Debian为例Ubuntu 同样可用把软件包名对应替换即可。通用的 Docker 流程可参考 Docker 部署文档。准备工作开始之前你需要GCP 账号e2-micro 机型可享受免费额度资格gcloudCLI或用 Cloud Console 网页控制台从笔记本到 VM 的 SSH 访问能力基本的 SSH 复制粘贴操作经验约 20–30 分钟时间Docker 与 Docker Compose模型认证凭据可选的渠道channel凭据WhatsApp 二维码Telegram Bot TokenGmail OAuth。第一步安装 gcloud CLI或使用 Cloud Console方式 Agcloud CLI推荐用于自动化从 Google Cloud SDK 官方安装说明安装 CLI 后初始化并认证gcloud init gcloud auth login方式 BCloud Console所有步骤都可以在 Google Cloud 网页控制台完成IAM、Compute Engine、APIs 等页面。第二步创建 GCP 项目CLI 方式gcloud projects create my-clawdbot-project --nameClawdbot Gateway gcloud config set project my-clawdbot-projectCompute Engine 必须启用计费在控制台 Billing 页面为项目绑定账单随后启用 Compute Engine APIgcloud services enable compute.googleapis.comConsole 方式进入 IAM Admin → Create Project命名并创建为项目启用计费进入 APIs Services → Enable APIs → 搜索 Compute Engine API → 启用。第三步创建虚拟机VM机器类型参考类型规格成本说明e2-small2 vCPU、2GB RAM约 $12/月推荐e2-micro2 vCPU共享、1GB RAM有免费额度资格高负载下可能 OOMCLI 方式gcloud compute instances create clawdbot-gateway \ --zoneus-central1-a \ --machine-typee2-small \ --boot-disk-size20GB \ --image-familydebian-12 \ --image-projectdebian-cloudConsole 方式进入 Compute Engine → VM instances → Create instance名称填clawdbot-gateway区域us-central1可用区us-central1-a机器类型e2-small启动盘选 Debian 1220GB创建。第四步SSH 登录 VMCLI 方式gcloud compute ssh clawdbot-gateway --zoneus-central1-aConsole 方式在 Compute Engine 控制台的实例列表里点击实例旁边的 SSH 按钮即可。注意VM 创建后 SSH 密钥传播可能需要 1–2 分钟如果连接被拒绝等一会再重试。第五步在 VM 上安装 Dockersudo apt-get update sudo apt-get install -y git curl ca-certificates curl -fsSL https://get.docker.com | sudo sh sudo usermod -aG docker $USER登出再登入让docker用户组生效exit然后重新 SSH 回来gcloud compute ssh clawdbot-gateway --zoneus-central1-a验证安装docker --version docker compose version仓库中的 docker-setup.sh 会额外检查docker与docker compose是否可用require_cmd docker、docker compose version缺一即退出所以先确认这两条命令都能通过。第六步克隆 OpenClaw 仓库git clone https://gitcode.com/gh_mirrors/op/openclaw-cn.git cd openclaw-cn本指南假设你将构建自定义镜像以保证二进制在镜像内持久存在详见第九步的「烘焙」。第七步创建持久化的宿主目录Docker 容器是易失的所有长期状态必须存放在宿主上mkdir -p ~/.openclaw mkdir -p ~/clawd这与仓库中 docker-compose.yml 的默认挂载约定一致${OPENCLAW_CONFIG_DIR:-./data/.openclaw}:/home/node/.openclaw、${OPENCLAW_WORKSPACE_DIR:-./data/clawd}:/home/node/clawd容器内以node用户UID 1000访问这些目录。第八步配置环境变量在仓库根目录创建.envOPENCLAW_IMAGEclawdbot:latest OPENCLAW_GATEWAY_TOKENchange-me-now OPENCLAW_GATEWAY_BINDlan OPENCLAW_GATEWAY_PORT18789 OPENCLAW_CONFIG_DIR/home/$USER/.openclaw OPENCLAW_WORKSPACE_DIR/home/$USER/clawd GOG_KEYRING_PASSWORDchange-me-now XDG_CONFIG_HOME/home/node/.openclaw生成强随机密钥openssl rand -hex 32绝对不要提交这个文件到版本库。仓库的 docker-setup.sh 也体现了同样的约定若环境里没有OPENCLAW_GATEWAY_TOKEN脚本会用openssl rand -hex 32无 openssl 时回退到 Pythonsecrets.token_hex(32)自动生成并把默认端口、绑定、配置目录等导出给 Compose 使用。各变量含义与 Docker 部署文档 的环境变量表对齐OPENCLAW_IMAGE镜像名默认openclaw-cn:local可改为预构建镜像OPENCLAW_GATEWAY_TOKEN网关认证令牌控制台访问与远程调用都需要OPENCLAW_GATEWAY_BIND网关绑定模式容器场景默认lan监听0.0.0.0也可用loopback、tailnet、auto、customOPENCLAW_GATEWAY_PORT网关监听端口默认18789OPENCLAW_CONFIG_DIR/OPENCLAW_WORKSPACE_DIR宿主上配置与工作区目录GOG_KEYRING_PASSWORDGmail 密钥环口令见 skills/gog/SKILL.mdXDG_CONFIG_HOME容器内指向/home/node/.openclaw保证状态路径一致。从源码看--bind的取值会被严格校验src/cli/gateway-cli/run.ts中只接受loopback、lan、tailnet、auto、custom五种非法值会直接报错退出并且当绑定模式不是loopback时必须配置令牌或密码认证否则 Gateway 会拒绝启动Refusing to bind gateway to ... without auth。第九步Docker Compose 配置创建或更新docker-compose.ymlservices: clawdbot-gateway: image: ${OPENCLAW_IMAGE} build: . restart: unless-stopped env_file: - .env environment: - HOME/home/node - NODE_ENVproduction - TERMxterm-256color - OPENCLAW_GATEWAY_BIND${OPENCLAW_GATEWAY_BIND} - OPENCLAW_GATEWAY_PORT${OPENCLAW_GATEWAY_PORT} - OPENCLAW_GATEWAY_TOKEN${OPENCLAW_GATEWAY_TOKEN} - GOG_KEYRING_PASSWORD${GOG_KEYRING_PASSWORD} - XDG_CONFIG_HOME${XDG_CONFIG_HOME} - PATH/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin volumes: - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw - ${OPENCLAW_WORKSPACE_DIR}:/home/node/clawd ports: # 推荐Gateway 只在 VM 上回环监听通过 SSH 隧道访问。 # 如需公网暴露去掉 127.0.0.1: 前缀并按需配置防火墙。 - 127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789 # 可选只有当你在此 VM 上运行 iOS/Android 节点、需要 Canvas host 时开启。 # 若公网暴露请先阅读 /gateway/security 并配置好防火墙。 # - 18793:18793 command: [ node, dist/index.js, gateway, --bind, ${OPENCLAW_GATEWAY_BIND}, --port, ${OPENCLAW_GATEWAY_PORT} ]要点解析restart: unless-stopped保证 VM 重启或容器异常退出后自动拉起这是 7×24 运行的核心端口映射默认只把18789绑定到127.0.0.1从外部无法直连只能通过 SSH 隧道访问——这是「安全默认值」command与仓库 Compose 一致仓库的 docker-compose.yml 中网关服务的启动命令同样是node dist/index.js gateway --bind ... --port ...端口默认18789桥接端口默认18790认证令牌OPENCLAW_GATEWAY_TOKEN会透传进容器对应配置里的gateway.auth.token详见 网关配置令牌缺失时网关同样无法以非 loopback 模式启动。第十步把外部二进制「烘焙」进镜像关键步骤在运行中的容器里安装二进制是个陷阱——任何运行时安装的东西重启后都会丢失。所有技能依赖的外部二进制必须在镜像构建时安装。下面只展示三个常见二进制示例gogGmail 访问见 skills/gog/SKILL.md元数据声明requires.bins: [gog]goplacesGoogle Places 地点搜索见 skills/goplaces/SKILL.md额外要求环境变量GOOGLE_PLACES_API_KEYwacliWhatsApp 命令行工具见 skills/wacli/SKILL.md。这些只是示例而非完整清单你可以用同样的模式安装任意数量的二进制。仓库中每个技能skills/*/SKILL.md的 frontmatter 都通过metadata.clawdbot.requires.bins声明了它需要的命令部署前应把你要用的技能对应的二进制全部烘焙进镜像。如果以后新增依赖额外二进制的技能必须更新 Dockerfile重新构建镜像重启容器。示例 DockerfileFROM node:22-bookworm RUN apt-get update apt-get install -y socat rm -rf /var/lib/apt/lists/* # 示例二进制 1Gmail CLI RUN curl -L https://github.com/steipete/gog/releases/latest/download/gog_Linux_x86_64.tar.gz \ | tar -xz -C /usr/local/bin chmod x /usr/local/bin/gog # 示例二进制 2Google Places CLI RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_Linux_x86_64.tar.gz \ | tar -xz -C /usr/local/bin chmod x /usr/local/bin/goplaces # 示例二进制 3WhatsApp CLI RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli_Linux_x86_64.tar.gz \ | tar -xz -C /usr/local/bin chmod x /usr/local/bin/wacli # 用同样的模式添加更多二进制 WORKDIR /app COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./ COPY ui/package.json ./ui/package.json COPY scripts ./scripts RUN corepack enable RUN pnpm install --frozen-lockfile COPY . . RUN pnpm build RUN pnpm ui:install RUN pnpm ui:build ENV NODE_ENVproduction CMD [node,dist/index.js]与仓库根目录 Dockerfile 对比本项目官方镜像采用 node:22-bookworm 多阶段构建构建阶段安装 BunARM 上强制 pnpm、配置 GitHub HTTPS 替代 SSH、pnpm install --frozen-lockfile后构建主程序与 UI运行时阶段仅复制dist、extensions、docs等产物并安装生产依赖最后以非 root 的node用户UID 1000启动降低容器逃逸攻击面。如果你要自定义镜像建议在官方多阶段结构之上叠加二进制层并注意保持CMD [node,dist/index.js]。第十一步构建并启动docker compose build docker compose up -d clawdbot-gateway验证二进制是否已就位docker compose exec clawdbot-gateway which gog docker compose exec clawdbot-gateway which goplaces docker compose exec clawdbot-gateway which wacli预期输出/usr/local/bin/gog /usr/local/bin/goplaces /usr/local/bin/wacli第十二步验证 Gatewaydocker compose logs -f clawdbot-gateway成功标志[gateway] listening on ws://0.0.0.0:18789这一行日志与源码实现吻合src/gateway/server-startup-log.ts会打印listening on ${scheme}://${host}:${port}TLS 启用时 scheme 为wss否则为ws并同时输出agent model: ...与日志文件路径可作为网关健康启动的判据。第十三步从笔记本访问控制台创建 SSH 隧道把网关端口转发到本地gcloud compute ssh clawdbot-gateway --zoneus-central1-a -- -L 18789:127.0.0.1:18789浏览器打开http://127.0.0.1:18789/粘贴你的网关令牌即可进入 Control UI。小贴士在 Docker 模式下即使浏览器访问的是 127.0.0.1连接也会经过容器网络栈而被视为网络连接。若控制台出现disconnected (1008): pairing required可执行docker compose run --rm openclaw-cn-cli config set gateway.controlUi.allowInsecureAuth true并重启网关详见 Docker 部署文档 的 FAQ 与 配对要求故障排查。不过按本指南的推荐做法隧道访问配合 loopback 绑定已足够安全。数据持久化清单source of truthOpenClaw 跑在 Docker 里但Docker 不是数据权威。所有长期状态都必须能扛过重启、重建与断电组件位置持久化机制说明网关配置/home/node/.openclaw/宿主卷挂载包含openclaw.json、令牌模型认证档案/home/node/.openclaw/宿主卷挂载OAuth 令牌、API 密钥技能配置/home/node/.openclaw/skills/宿主卷挂载技能级状态Agent 工作区/home/node/clawd/宿主卷挂载代码与 Agent 产物WhatsApp 会话/home/node/.openclaw/宿主卷挂载保留二维码登录状态Gmail 密钥环/home/node/.openclaw/宿主卷 口令依赖GOG_KEYRING_PASSWORD外部二进制/usr/local/bin/Docker 镜像必须在构建时烘焙Node 运行时容器文件系统Docker 镜像每次构建镜像重建操作系统包容器文件系统Docker 镜像不要在运行时安装Docker 容器易失可重启可随时销毁说明原指南持久化表中 Agent 工作区写作clawwork而本仓库 Compose 与.env约定统一为/home/node/clawd对应宿主~/clawd请以clawd为准避免卷挂载落空导致状态丢失。更新 OpenClaw在 VM 上更新cd ~/openclaw-cn git pull docker compose build docker compose up -drestart: unless-stopped会让新容器接管旧容器被安全替换宿主卷上的状态原样保留。故障排查SSH 连接被拒绝VM 创建后 SSH 密钥传播需要 1–2 分钟。等待后重试。OS Login 问题检查你的 OS Login 配置gcloud compute os-login describe-profile确保账号具备所需 IAM 权限Compute OS Login 或 Compute OS Admin Login。内存不足OOM如果使用 e2-micro 遇到 OOM升级到 e2-small 或 e2-medium# 先停止 VM gcloud compute instances stop clawdbot-gateway --zoneus-central1-a # 变更机器类型 gcloud compute instances set-machine-type clawdbot-gateway \ --zoneus-central1-a \ --machine-typee2-small # 启动 VM gcloud compute instances start clawdbot-gateway --zoneus-central1-a服务账号安全最佳实践个人使用场景下默认用户账号就够了。如果要做自动化或 CI/CD 流水线创建一个最小权限的专用服务账号创建服务账号gcloud iam service-accounts create clawdbot-deploy \ --display-nameClawdbot Deployment授予 Compute Instance Admin 角色或更窄的自定义角色gcloud projects add-iam-policy-binding my-clawdbot-project \ --memberserviceAccount:clawdbot-deploymy-clawdbot-project.iam.gserviceaccount.com \ --roleroles/compute.instanceAdmin.v1自动化场景避免使用 Owner 角色遵循最小权限原则。部署完成后也建议跑一次openclaw-cn security audit见 网关安全检查网关认证暴露、文件系统权限等常见问题。下一步配置消息渠道Channels本项目内置钉钉、企业微信、飞书、QQ、微信等渠道支持把本地设备配对为节点NodesNodes深入配置 Gateway网关配置。赞分享人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载相关推荐OpenClaw 在 GCP Compute Engine 上 7×24 常驻部署Docker 生产级 VPS 实战指南OpenClaw 在 GCP Compute Engine 上 7×24 常驻部署Docker 生产级 VPS 实战指南 本文基于 docs/install/人工智能大模型LLM 网关AI Agent即时通讯OpenClaw 多租户托管基于 openclaw fleet 的按租户隔离 Cell 部署实战OpenClaw 多租户托管基于 openclaw fleet 的按租户隔离 Cell 部署实战 OpenClaw 的默认安全模型是每个 Gateway 一AI 应用AI Agent交互助手后端即时通讯网关文档变可编辑PPT只要十几分钟开源AI演示工具 PPT Master 上手文档变可编辑PPT只要十几分钟开源AI演示工具 PPT Master 上手 周四晚上九点你手里压着一份 20 页的 PDF 报告明早八点要上会。以前这种场AI 技能人工智能AI 应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考