如何托管 Slack 机器人

​

简介

​

前置条件

• Square Cloud 账户：通过注册页面使用你的邮箱进行注册。
• 有效套餐：为你的应用提供专属资源和优化的性能。查看我们可用的套餐，选择最适合你需求的方案。

​

创建项目

​

在 Slack 上创建机器人应用

1. 前往 Slack API - Your Apps 并点击 “Create New App”。
2. 选择 “From scratch”，为应用命名，并选择你将要安装它的 workspace。
3. 在 “Socket Mode” 部分启用 Socket Mode，并生成一个带有 connections:write scope 的 app-level token。复制它（以 xapp- 开头）：这就是你的 SLACK_APP_TOKEN。
4. 在 “OAuth & Permissions” 部分添加机器人所需的 scope（例如 chat:write、app_mentions:read、commands），将应用安装到你的 workspace，并复制 Bot User OAuth Token（以 xoxb- 开头）：这就是你的 SLACK_BOT_TOKEN。
5. 在 “Event Subscriptions” 中启用事件并订阅 app_mention 机器人事件。在 “Slash Commands” 中创建 /hello 命令。启用 Socket Mode 后，这两处都不需要填写 Request URL。

​

开发项目

npm init -y
npm install @slack/bolt

const { App } = require('@slack/bolt');

const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  appToken: process.env.SLACK_APP_TOKEN,
  // Socket Mode: the bot connects to Slack, so no public URL is needed
  socketMode: true,
});

// Responds when mentioned
app.event('app_mention', async ({ event, say }) => {
  await say(`<@${event.user}> Thanks for mentioning me!`);
});

// Example slash command
app.command('/hello', async ({ ack, respond }) => {
  await ack();
  await respond('Hello from Square Cloud!');
});

(async () => {
  await app.start();
  console.log('⚡️ Slack Bolt app is running!');
})();

pip install slack_bolt

from slack_bolt import App
from slack_bolt.adapter.socket_mode import SocketModeHandler
import os

app = App(token=os.environ.get('SLACK_BOT_TOKEN'))

@app.event('app_mention')
def handle_mention(event, say):
    user = event.get('user')
    say(f'<@{user}> Thanks for mentioning me!')

@app.command('/hello')
def hello_command(ack, respond):
    ack()
    respond('Hello from Square Cloud!')

if __name__ == '__main__':
    # Socket Mode: the bot connects to Slack, so no public URL is needed
    SocketModeHandler(app, os.environ.get('SLACK_APP_TOKEN')).start()

slack_bolt

​

配置 Square Cloud

DISPLAY_NAME=My Slack Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Slack Bot
MAIN=app.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN 是 Square Cloud 运行的文件，MEMORY 是机器人的内存（单位 MB）。机器人至少需要 256 MB；512 MB 则留有增长空间。
• AUTORESTART=true 会在机器人崩溃时重新启动它。请参阅自动重启的工作方式。
• 没有 SUBDOMAIN：在 Socket Mode 下，机器人不需要公开 URL。

​

设置令牌

• 控制面板：在上传页面打开 Advanced configuration 并添加这两个变量。对于已部署的机器人，请在应用的 Environment Variables 页面添加它们，然后重启机器人。
• CLI：上传机器人后（参见部署），立即使用 squarecloud app env set 设置它们并重启机器人：

squarecloud app env set SLACK_BOT_TOKEN=xoxb-your-token SLACK_APP_TOKEN=xapp-your-token
squarecloud app restart

​

部署

​

通过控制面板

1

访问上传页面

访问上传页面并上传你的项目 zip 文件。

2

配置你的环境

上传 zip 后，你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目，请务必选择 “Web Publication” 并为项目设置子域名。

3

部署你的项目

最后，点击 “Deploy” 按钮，即可将项目托管到 Square Cloud。
部署完成后，你可以在控制面板中监控项目的状态和日志。

4

确认你的应用已上线

首次部署通常在一分钟内完成。在控制面板中，等待你的应用状态显示为运行中，并检查日志中是否有启动错误。
如果你部署的是网站或 API，请在浏览器中打开 https://<your-subdomain>.squareweb.app，你应该能看到应用正常响应。如果你部署的是机器人，发送一条命令确认它已上线。

应用无法启动？请参见故障排除指南，了解最常见的原因和解决方法。

​

通过 CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

测试机器人

1. 在 Slack 应用面板的 “OAuth & Permissions” 下，将应用安装到 workspace（如果你还没有安装）。
2. 在 Square Cloud 控制面板中检查应用日志，确认没有启动错误。使用 Socket Mode 时无需配置 Request URL：机器人一启动就会连接到 Slack。
3. 将机器人邀请到一个频道，然后提及它或运行 /hello 命令，以验证响应是否正常。

https://slack.com/oauth/v2/authorize?client_id=000000000000.000000000000&scope=commands,chat:write,app_mentions:read

​

使用 HTTP 模式代替 Socket Mode

1. 在 Slack 应用设置中禁用 Socket Mode，并将 Signing Secret（位于 “Basic Information” 下）复制到 SLACK_SIGNING_SECRET 环境变量中，设置方式与令牌相同。
2. 使用 signing secret 而不是 app-level token 创建应用，并监听 PORT 环境变量中的端口：

const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  signingSecret: process.env.SLACK_SIGNING_SECRET,
});

(async () => {
  // Square Cloud sets PORT=80
  await app.start(Number(process.env.PORT) || 80);
  console.log('⚡️ Slack Bolt app is running!');
})();

app = App(
    token=os.environ.get('SLACK_BOT_TOKEN'),
    signing_secret=os.environ.get('SLACK_SIGNING_SECRET')
)

if __name__ == '__main__':
    # Square Cloud sets PORT=80
    app.start(port=int(os.environ.get('PORT', 80)))

3. 在配置文件中添加 SUBDOMAIN（或者从控制面板上传时选择 “Web Publication” 并设置子域名），让机器人获得一个公共 URL。Web 应用至少需要 MEMORY=512：

DISPLAY_NAME=My Slack Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true
SUBDOMAIN=my-slack-bot

4. 在 “Event Subscriptions” 和 /hello 斜杠命令中，将 Request URL 设置为 https://<subdomain>.squareweb.app/slack/events。

​

更多资源

• Bolt for JavaScript
• Bolt for Python

​

后续步骤

​

联系我们