简介
要在 Square Cloud 上开发和托管 ,遵循一套结构化的配置和前置条件流程至关重要。本技术指南将涵盖整个过程,从初始设置到生产环境部署。前置条件
创建项目
要创建 Slack 机器人,你需要一个账户以及在 Slack 上创建应用的权限。在按照后续步骤操作之前,请在 https://slack.com/ 创建或登录你的账户。在 Slack 上创建机器人应用
- 前往 Slack API - Your Apps 并点击 “Create New App”。
- 选择 “From scratch”,为应用命名,并选择你将要安装它的 workspace。
- 记下 Signing Secret(位于 “Basic Information” 下),并在 “OAuth & Permissions” 部分创建一个 Bot Token,为你的机器人添加合适的 scope(例如
chat:write、channels:read、commands、app_mentions:read)。
开发项目
请根据你选择的语言使用下面对应的部分。两个示例都演示了一个响应提及或简单命令的机器人。- Node.js - @slack/bolt
- Python - slack_bolt
Node.js 环境搭建注意:在 Square Cloud 上,请在应用面板中设置环境变量
- 确认已安装 Node.js。
- 初始化项目并安装依赖:
Terminal
- 创建一个
index.js文件,内容如下:
index.js
SLACK_SIGNING_SECRET 和 SLACK_BOT_TOKEN。部署
准备好项目文件后,你现在可以将它们上传到 Square Cloud 并托管你的项目。 为此,请创建一个包含所有项目文件的 ZIP 文件。通过控制面板
1
访问上传页面
访问上传页面并上传你的项目 zip 文件。
2
配置你的环境
上传 zip 后,你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目,请务必选择 “Web Publication” 并为项目设置子域名。
如果你上传的是 Web 项目,请务必选择 “Web Publication” 并为项目设置子域名。
3
部署你的项目
最后,点击 “Deploy” 按钮,即可将项目托管到 Square Cloud。
部署完成后,你可以在控制面板中监控项目的状态和日志。
部署完成后,你可以在控制面板中监控项目的状态和日志。

4
确认你的应用已上线
首次部署通常在一分钟内完成。在控制面板中,等待你的应用状态显示为运行中,并检查日志中是否有启动错误。
如果你部署的是网站或 API,请在浏览器中打开
如果你部署的是网站或 API,请在浏览器中打开
https://<your-subdomain>.squareweb.app,你应该能看到应用正常响应。如果你部署的是机器人,发送一条命令确认它已上线。
通过 CLI
要使用此方法,你需要在项目根目录中创建一个名为squarecloud.app 的配置文件。该文件将包含项目所需的配置。
配置文件指南
了解如何创建定义你应用环境的
squarecloud.app 配置文件。1
安装 CLI
首先,你的环境中需要已安装 CLI。如果尚未安装,请在终端中运行以下命令:如果你已经安装,我们建议对其进行更新。为此,请在终端中运行以下命令:
- Windows
- Linux、macOS 和 WSL
2
进行身份验证
现在,要进行身份验证并使用其他 CLI 命令,你可以在此处点击 “Request API Key” 找到你的授权密钥。获取授权密钥后,运行以下命令:
3
上传你的项目
最后,要使用 CLI 将应用部署到 Square Cloud,你需要运行以下命令:或者,如果你手动创建了 zip 文件,可以使用:
4
确认你的应用已上线
首次部署通常在一分钟内完成。直接在终端中检查你的应用状态和日志:如果你部署的是网站或 API,请在浏览器中打开
https://<your-subdomain>.squareweb.app,你应该能看到应用正常响应。如果你部署的是机器人,发送一条命令确认它已上线。
测试机器人
- 在 Slack 应用面板的 “OAuth & Permissions” 下,将应用安装到 workspace。
- 如果机器人暴露了 endpoint(用于事件或命令),请在 “Event Subscriptions” 和 “Slash Commands” 中配置 Request URL,指向你应用的公共 URL(Square Cloud 会在部署后提供域名)。
- 在频道中测试提及功能或
/hello命令,以验证响应是否正常。
更多资源
如需进一步阅读,请查阅 Slack 官方文档:- Bolt for JavaScript: https://docs.slack.dev/tools/bolt-js/
- Bolt for Python: https://docs.slack.dev/tools/bolt-python/

