Einführung
Um einen Bot für X (Twitter) auf Square Cloud zu entwickeln und zu hosten, ist es wichtig, einer strukturierten Abfolge von Konfigurationen und Voraussetzungen zu folgen. Dieser technische Leitfaden deckt den gesamten Prozess ab, von der anfänglichen Einrichtung bis zum Produktions-Deployment.Voraussetzungen
- Square Cloud Konto: Registriere dich über die Registrierungsseite mit deiner E-Mail-Adresse.
- Aktiver Plan: Stellt dedizierte Ressourcen und optimierte Leistung für deine Anwendung sicher. Sieh dir unsere verfügbaren Pläne an und wähle den passendsten für deine Bedürfnisse.
Projekt erstellen
Ein aktives X (Twitter)-Konto ist für die Authentifizierung und den Betrieb des Bots erforderlich. Wenn du kein Konto hast, registriere dich auf der offiziellen X-Website.Ein X-Developer-Konto ist ebenfalls erforderlich, um auf die APIs zuzugreifen. Beantrage den Zugriff über das X Developer Portal.
Bot-Anwendung auf X
Developer Portal öffnen
- Gehe zum X Developer Portal.
- Melde dich mit deinem X (Twitter)-Konto an.
- Wenn dies dein erstes Mal ist, schließe den Antragsprozess für den Developer-Zugriff ab.
Projekt erstellen
- Klicke im Dashboard auf “Create Project”.
- Wähle einen Namen für dein Projekt (z. B. “Square Cloud Bot”).
- Wähle den am besten geeigneten Anwendungsfall (z. B. “Making a bot”).
- Gib eine detaillierte Beschreibung deines Bots an.
- Bestätige die Projekterstellung.
App erstellen
- Klicke innerhalb des erstellten Projekts auf “Create App”.
- Lege einen eindeutigen Namen für deine Anwendung fest.
- Bestätige die Erstellung der Anwendung.
- Notiere dir die generierte App ID für die spätere Verwendung.
API-Schlüssel generieren
- Navigiere zum Abschnitt “Keys and tokens” deiner Anwendung.
- Klicke im Abschnitt “Consumer Keys” auf “Regenerate”, um Folgendes zu generieren:
- API Key (Consumer Key)
- API Secret Key (Consumer Secret)
- Wichtig: Kopiere und speichere diese Schlüssel sofort, da du sie nicht erneut ansehen kannst.
App-Berechtigungen festlegen
- Gehe zum Abschnitt “App permissions”.
- Klicke auf “Edit”, um die Berechtigungen zu ändern.
- Wähle “Read and write”, damit dein Bot Tweets posten kann.
- Wähle bei Bedarf “Read and write and Direct message” für DM-Funktionalität.
- Speichere die Änderungen.
Access Tokens generieren
- Kehre zum Abschnitt “Keys and tokens” zurück.
- Klicke im Abschnitt “Access Token and Secret” auf “Generate”.
- Bestätige die Token-Generierung.
- Kopiere und speichere:
- Access Token
- Access Token Secret
- Warnung: Diese Tokens können nach dem Schließen der Seite nicht erneut angezeigt werden.
Zugangsdaten prüfen
- Stelle sicher, dass du alle 4 erforderlichen Anmeldedaten hast:
- API Key (Consumer Key)
- API Secret Key (Consumer Secret)
- Access Token
- Access Token Secret
- Bewahre diese Anmeldedaten an einem sicheren Ort auf
- Wichtig: Teile oder veröffentliche diese Anmeldedaten niemals öffentlich
Bot entwickeln
- Node.js-Prüfung: Stelle sicher, dass Node.js auf deinem System installiert ist. Andernfalls lade es von der offiziellen Node.js-Website herunter.
- Projektinitialisierung: Erstelle ein neues Node.js-Projekt, indem du Folgendes ausführst:
- Abhängigkeiten installieren: Installiere die für den Bot erforderlichen Bibliotheken:
- Zugangsdaten: Der Code liest die vier Zugangsdaten aus Umgebungsvariablen, daher landen sie nie in deinem Code. Um den Bot auf deinem Computer zu testen, lege sie in eine
.env-Datei und starte den Bot mitnode --env-file=.env index.js:
- Hauptdatei erstellen: Entwickle die Datei
index.jsmit der Grundstruktur des Bots:
Square Cloud konfigurieren
Erstelle im Stammverzeichnis deines Projekts, nebenindex.js, eine Datei squarecloud.app. Sie teilt Square Cloud mit, wie dein Bot ausgeführt wird:
MEMORYist der RAM des Bots in MB. Bots brauchen mindestens 256 MB; mit 512 MB hast du Luft zum Wachsen.AUTORESTART=truestartet den Bot nach einem Absturz neu. Lies dazu, wie der automatische Neustart funktioniert.- Es gibt keine
SUBDOMAIN: Der Bot ruft die X API auf und liefert keine Webseiten aus.
Zugangsdaten festlegen
API_KEY: Dein X-API-SchlüsselAPI_SECRET_KEY: Dein geheimer X-API-SchlüsselACCESS_TOKEN: Dein Access TokenACCESS_TOKEN_SECRET: Dein Access Token Secret
- Dashboard: Öffne auf der Upload-Seite Erweiterte Konfiguration und füge die vier Variablen hinzu. Bei einem bereits deployten Bot fügst du sie auf der Seite Umgebungsvariablen der Anwendung hinzu und startest den Bot neu.
- CLI: Lade sie direkt nach dem Upload des Bots (siehe Deployen und prüfen) mit
squarecloud app env setaus deiner lokalen.env-Datei und starte den Bot neu:
Was in die ZIP-Datei gehört
index.jsund deine anderen Quelldateien.package.json.squarecloud.app.
node_modules weg: Square Cloud installiert deine Abhängigkeiten, wenn der Bot startet. Lass auch deine .env-Datei weg: Wenn du mit der CLI hochlädst, füge deiner Datei squarecloud.ignore eine Zeile mit .env hinzu, damit die CLI sie überspringt.
Deployen und prüfen
Erstelle die oben beschriebene ZIP-Datei und lade sie dann hoch:Über das Dashboard
Upload-Seite aufrufen
Umgebung konfigurieren
Wenn du ein Web-Projekt hochlädst, achte darauf, “Web Publication” auszuwählen und deinem Projekt eine Subdomain zuzuweisen.
Projekt bereitstellen
Nach dem Deploy kannst du den Status und die Logs deines Projekts über das Dashboard überwachen.

Bestätige, dass deine App live ist
Wenn du eine Website oder API bereitgestellt hast, öffne
https://<deine-subdomain>.squareweb.app in deinem Browser: du solltest sehen, dass deine Anwendung reagiert. Wenn du einen Bot bereitgestellt hast, sende ihm einen Befehl, um zu bestätigen, dass er online ist.
Über die CLI
Um diese Methode zu nutzen, braucht dein Projekt eine Konfigurationsdatei mit dem Namensquarecloud.app im Stammverzeichnis. Sie teilt Square Cloud mit, wie deine Anwendung ausgeführt wird.
Leitfaden zur Konfigurationsdatei
squarecloud.app erstellst, die die Umgebung deiner Anwendung definiert.CLI installieren
Anmelden
Projekt hochladen
squarecloud.ignore steht, und lädt ihn hoch:--file:Bestätige, dass deine App live ist
https://<deine-subdomain>.squareweb.app in deinem Browser: du solltest sehen, dass deine Anwendung reagiert. Wenn du einen Bot bereitgestellt hast, sende ihm einen Befehl, um zu bestätigen, dass er online ist.
Bot testen
Prüfe nach dem Deployment die Anwendungslogs im Square Cloud Dashboard auf die MeldungBot successfully initialized!, um zu bestätigen, dass sich der Bot korrekt authentifiziert hat. Poste dann von einem anderen Konto aus einen Tweet, der den Bot mit !ping erwähnt (zum Beispiel @your_bot !ping), und bestätige, dass er innerhalb weniger Minuten auf X mit Pong! 🤖 X Bot working correctly! antwortet. Erwähnungen, die vor dem Start des Bots gepostet wurden, werden übersprungen.
Häufige Fehler
Request failed with code 401
Die Logs zeigenError verifying bot: gefolgt von diesem Fehler. Eine der vier Zugangsdaten ist falsch oder fehlt. Kopiere sie erneut aus dem Abschnitt “Keys and tokens”, lege die vier Variablen fest und starte den Bot neu.
Request failed with code 403 beim Antworten
Der Bot authentifiziert sich, kann aber nicht posten. Die Access Tokens wurden generiert, als die App nur Leseberechtigung hatte. Stelle in den App-Berechtigungen “Read and write” ein, generiere Access Token und Secret neu, aktualisiereACCESS_TOKEN und ACCESS_TOKEN_SECRET und starte den Bot neu.
Request failed with code 429
Der Bot hat ein Rate Limit der X API erreicht. Warte vor der nächsten Anfrage und verteile deine Aufrufe zeitlich wie unter Rate Limiting.Weiterführende Themen
Die folgenden Snippets erweiternindex.js: Füge sie der Datei hinzu und rufe sie dort auf, wo dein Bot sie braucht.

