claw-cloud-run.md

部署到 Claw Cloud Run

本指南将帮助你在 Claw Cloud Run 上部署 canvas-to-api 服务。

📦 部署步骤

1. 登录：前往 https://us-west-1.run.claw.cloud 并登录你的账号。

2. 创建应用：进入 App Launchpad，点击右上角的 Create App 按钮。

3. 配置应用：填写以下参数：

   • Application Name：填写一个你喜欢的英文名称（例如 canvas-api）。
   • Image：选择 Public。
   • Image Name：ghcr.io/ibuhub/canvas-to-api:latest

   Usage:

   • CPU：0.5
   • Memory：1G

   Network:

   • Container Port：7861
   • Public Access：开启（Toggle On，后面的网址选项不用动）。

   环境变量（Environment Variables）:

   必填参数 API_KEYS。其他参数选填（参考主 README 中的 配置 部分）。

   Name	Value	Description
   API_KEYS	your-secret-key-123	必填。自定义你的访问密钥，多个密钥用逗号分隔。

4. 部署：点击 Create App 开始部署。

📡 访问服务

1. 等待应用运行起来后，在应用详情页点击 Network 标签页。
2. 复制 Public Address（公网地址）。
3. 在浏览器中访问该地址。输入你设置的 API_KEYS 即可进入管理页面。

🔑 账号管理

当前版本不再通过 VNC 或上传 Auth 文件来管理账号。部署完成后，请直接按主 README 的 浏览器会话连接 流程操作。

建立浏览器会话时，请在 Gemini 分享页中填写：

• Browser Identifier：浏览器标志，可自定义
• API Key：填写与你请求 API 时相同的 key
• Server WS Endpoint：如果你是通过 Claw Cloud 分配的公网 https:// 地址访问控制台，这里应填写 wss://你的公网地址/ws

填写示例：

• 如果控制台地址是 https://canvas-api-xxxx.claw.cloud 则 Server WS Endpoint 填 wss://canvas-api-xxxx.claw.cloud/ws
• 如果你后面又绑定了自己的 HTTPS 域名，例如 https://api.example.com 则填写 wss://api.example.com/ws

连接成功后，回到状态页确认 Browser Sessions 中已经出现在线会话，再开始发送 API 请求。

🔌 API 访问地址

部署完成后，使用 Public Address 配合以下 Base URL 访问 API：

• OpenAI 兼容 Base URL：https://<your-public-address>/v1
• OpenAI Responses 兼容 Base URL：https://<your-public-address>/v1
• Gemini 兼容 Base URL：https://<your-public-address>/v1beta
• Anthropic 兼容 Base URL：https://<your-public-address>/v1

更多详细信息，请参考主 README 中的 使用 API 章节。

🔄 版本更新

如需更新到最新版本，在应用详情页面点击右上角的 Update 按钮即可。