Εγκατάσταση του OpenClaw και ρύθμιση του OmniProxy

Το OpenClaw είναι ένας βοηθός AI που εγκαθίσταται στον δικό σας υπολογιστή. Μπορείτε να συνομιλείτε μαζί του απευθείας μέσω Telegram, Discord, WhatsApp ή Feishu χωρίς να διατηρείτε ανοιχτό άλλο παράθυρο συνομιλίας. Οι συνομιλίες και τα αρχεία παραμένουν σε αυτόν τον υπολογιστή και μπορεί να συνεχίσει να εκτελεί τα επόμενα βήματα τοπικά.

Πριν ξεκινήσετε

Το OpenClaw απαιτεί Node 24.16 ή μεταγενέστερη έκδοση. Μπορείτε επίσης να χρησιμοποιήσετε Node 26.1 ή μεταγενέστερη, με τη Node 26 να προτείνεται. Το Node παρέχει το περιβάλλον εκτέλεσης που απαιτείται από το OpenClaw.

Μπορεί να εγκατασταθεί σε macOS, Linux και Windows. Εάν ο υπολογιστής δεν διαθέτει κατάλληλη έκδοση του Node, το σενάριο εγκατάστασης θα προετοιμάσει μία αυτόματα: Node 26 σε macOS και Node 24 LTS σε Linux. Το pnpm απαιτείται μόνο κατά τη δημιουργία του OpenClaw από τον πηγαίο κώδικα.

Εάν είναι ήδη εγκατεστημένη μια παλαιότερη έκδοση του Node, δεν χρειάζεται να την απεγκαταστήσετε πρώτα. Κατά τη δοκιμή στις 09-10-2026, η έκδοση συστήματος του Node σε αυτόν τον υπολογιστή ήταν 24.2.0, κάτω από την απαιτούμενη 24.16, και το μη διαδραστικό σενάριο εγκατάστασης προετοίμασε αυτόματα το Node 24.21.0.

Θέλετε ένα παράθυρο

Συνοδευτική εφαρμογή επιφάνειας εργασίας

• Χρησιμοποιήστε το πρόγραμμα εγκατάστασης Hub στα Windows
• Χρησιμοποιήστε το GitHub DMG στο macOS
• Το τοπικό Gateway μπορεί να εγκατασταθεί κατά την αρχική ρύθμιση

Επίσημα προτεινόμενο

Σενάριο εγκατάστασης

• macOS Linux WSL2
• Χρησιμοποιήστε το PowerShell στα Windows
• Μπορείτε να προσθέσετε --no-onboard

Το Node είναι ήδη εγκατεστημένο

Διαχειριστής πακέτων

• npm pnpm ή bun
• Στη συνέχεια, εκτελέστε το onboard
• Δείτε τη σελίδα εγκατάστασης για την έκδοση του Node

Εγκατάσταση και πρώτη εκκίνηση

Μπορείτε να εγκαταστήσετε τη συνοδευτική εφαρμογή επιφάνειας εργασίας με ένα γραφικό παράθυρο ή να εγκαταστήσετε απευθείας μέσω του τερματικού. Το Gateway είναι η τοπική υπηρεσία που είναι υπεύθυνη για τη λήψη μηνυμάτων, την κλήση μοντέλων και την επιστροφή των αποτελεσμάτων. Μπορείτε να το ρυθμίσετε κατά το πρώτο άνοιγμα της συνοδευτικής εφαρμογής.

Αν θέλετε ένα παράθυρο

• Windows: Κατεβάστε και εκτελέστε OpenClawCompanion-Setup-x64.exe ή OpenClawCompanion-Setup-arm64.exe. Το πρόγραμμα εγκατάστασης είναι υπογεγραμμένο και περιλαμβάνει ρυθμίσεις, κατάσταση δίσκου, συνομιλία και λειτουργίες κόμβου.
• macOS: Κατεβάστε το OpenClaw .dmg από τις εκδόσεις GitHub του OpenClaw. Προτιμήστε το dmg, αν και μπορείτε επίσης να χρησιμοποιήσετε το .zip. Ανοίξτε το OpenClaw.app μετά την εγκατάσταση. Εάν αυτή η έκδοση δεν περιλαμβάνει αρχείο macOS, ακολουθήστε τη σελίδα εφαρμογής macOS.

Κατά το πρώτο άνοιγμα, μπορείτε να αφήσετε το OpenClaw να προετοιμάσει το Gateway σε αυτόν τον υπολογιστή ή να συνδεθείτε σε ένα υπάρχον απομακρυσμένο Gateway.

Εγκατάσταση μέσω τερματικού

Για macOS, Linux και WSL2, χρησιμοποιήστε:

curl -fsSL https://openclaw.ai/install.sh | bash

Για Windows PowerShell, χρησιμοποιήστε:

iwr -useb https://openclaw.ai/install.ps1 | iex

Το σενάριο ανιχνεύει το τρέχον σύστημα, εγκαθιστά το Node όταν χρειάζεται, εγκαθιστά το OpenClaw και στη συνέχεια ξεκινά τη διαδικασία αρχικής ενσωμάτωσης. Η ροή ενσωμάτωσης σας καθοδηγεί στην πρώτη ρύθμιση.

Εάν δεν θέλετε να ξεκινήσετε ακόμα την ενσωμάτωση, χρησιμοποιήστε τα παρακάτω σε macOS, Linux και WSL2:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Στα Windows, χρησιμοποιήστε την επίσημη -NoOnboard επιλογή:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Εάν διαχειρίζεστε ήδη το Node μόνοι σας, μπορείτε επίσης να χρησιμοποιήσετε npm, pnpm ή bun. Με npm 12 ή npm 11.16 και μεταγενέστερα, εκτελέστε:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Για npm 11.15 και παλαιότερα, αφαιρέστε το --allow-scripts=openclaw. Όταν χρησιμοποιείτε pnpm, προσθέστε το --allow-build=openclaw. Ανατρέξτε στη σελίδα εγκατάστασης για τις ακριβείς διαφορές.

Μετά την εγκατάσταση, εκτελέστε αυτές τις τρεις εντολές με τη σειρά:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version εμφανίζει την έκδοση, openclaw doctor ελέγχει για κοινά προβλήματα περιβάλλοντος και openclaw gateway status δείχνει αν το Gateway εκτελείται. Η βασική εγκατάσταση ολοκληρώνεται μόνο όταν και οι τρεις εντολές παράγουν κανονική έξοδο.

Εάν το τερματικό αναφέρει ότι δεν μπορεί να βρει το openclaw, ο κατάλογος npm global bin συνήθως λείπει από το PATH. Το PATH είναι η λίστα των τοποθεσιών όπου το τερματικό αναζητά προγράμματα. Συγκρίνετε την έξοδο του node -v, npm prefix -g, και echo "$PATH", προσθέστε τον αντίστοιχο κατάλογο bin στο PATH και στη συνέχεια ανοίξτε ξανά το τερματικό.

Εάν το ~/.openclaw περιέχει ήδη μια διαμόρφωση που χρησιμοποιείται τώρα, το προεπιλεγμένο σενάριο εγκατάστασης θα χρησιμοποιήσει αυτόν τον κατάλογο. Για να εγκαταστήσετε ένα ξεχωριστό αντίγραφο χωρίς να αλλάξετε την υπάρχουσα διαμόρφωση, εκτελέστε το μη διαδραστικό σενάριο και καθορίστε έναν νέο κατάλογο:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard είναι η προεπιλεγμένη συμπεριφορά αυτού του σεναρίου. Στις 09-10-2026, αυτή η εντολή εγκατέστησε το OpenClaw 2026.9.9. Μετά την εγκατάσταση, εκτελέστε το εκτελέσιμο αρχείο openclaw από τον φάκελο bin του καταλόγου.

Λήψη τιμών σύνδεσης από το OmniProxy

Πρώτα επιβεβαιώστε ότι το OmniProxy εκτελείται, στη συνέχεια ανοίξτε τη λίστα μοντέλων του και προετοιμάστε τις ακόλουθες τρεις τιμές:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl είναι η διεύθυνση στην οποία το OpenClaw στέλνει αιτήματα μοντέλων και πρέπει να τελειώνει με /v1. Κατά τη σύνδεση στο OmniProxy, χρησιμοποιήστε το openai-completions για το api. Αλλάξτε το σε openai-responses μόνο εάν το μοντέλο λειτουργεί πραγματικά μέσω /v1/responses.

Το Model ID είναι το πλήρες αναγνωριστικό του μοντέλου στη λίστα. Αντιγράψτε το ακριβώς όπως εμφανίζεται, συμπεριλαμβανομένων τυχόν καθέτων. Τα ακόλουθα δύο ονόματα είναι μόνο αναφορές από την τεκμηρίωση του παρόχου από τις 09-10-2026· μην τα χρησιμοποιήσετε εάν δεν εμφανίζονται στη λίστα: claude-sonnet-5-5, gpt-6-luna.

Ακόμα κι αν το gateway δεν επικυρώνει το κλειδί, apiKey πρέπει να περιέχει μια τιμή. Μπορείτε να χρησιμοποιήσετε μια συμβολοσειρά κράτησης θέσης (placeholder) που χρησιμοποιείται μόνο σε αυτόν τον υπολογιστή. Μην δεσμεύετε ένα πραγματικό κλειδί σε ένα αποθετήριο.

Εισαγωγή της διαμόρφωσης εργαλείου

Ένας Πάροχος (Provider) μπορεί να γίνει κατανοητός ως ένα σύνολο ρυθμίσεων σύνδεσης που χρησιμοποιεί το OpenClaw για να εντοπίσει μια υπηρεσία μοντέλου. Εδώ, ο Πάροχος ονομάζεται omniproxy.

Εκτελέστε την ακόλουθη εντολή στο τερματικό, αντικαθιστώντας τη διεύθυνση, το κλειδί και τα δύο αναγνωριστικά μοντέλων με τις δικές σας τιμές:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

Αυτή η εντολή γράφει τον Πάροχο και τη λίστα μοντέλων στη διαμόρφωση. Δεν χρειάζεται να επανεκκινήσετε το Gateway μετά την επιτυχία της εντολής.

Στη συνέχεια, καθορίστε το προεπιλεγμένο μοντέλο. Η αναφορά μοντέλου αποτελείται από omniproxy/ ακολουθούμενο από το αναγνωριστικό μοντέλου. Διατηρήστε κάθε κάθετο που υπάρχει ήδη στο αναγνωριστικό. Εάν το αναγνωριστικό στη λίστα μοντέλων είναι μεγαλύτερο από το σύντομο όνομα παρακάτω, χρησιμοποιήστε την πλήρη τιμή από τη λίστα:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

reasoning, input, cost, contextWindow, και maxTokens μπορούν όλα να παραλειφθούν. Όταν δεν παρέχονται, τα μοντέλα κειμένου χειρίζονται χρησιμοποιώντας τις προεπιλογές.

Μπορείτε επίσης να γράψετε τις ίδιες ρυθμίσεις απευθείας στο αρχείο διαμόρφωσης. Στην κύρια διαμόρφωση, ο Πάροχος βρίσκεται κάτω από το models.providers. Κάθε πράκτορας (agent) μπορεί επίσης να έχει το δικό του models.json; ένας πράκτορας είναι μια παρουσία βοηθού που λαμβάνει πραγματικά εργασίες και καλεί μοντέλα. Το αρχείο βρίσκεται στο agent/models.json μέσα στον αντίστοιχο κατάλογο πράκτορα κάτω από το ~/.openclaw/agents/.

Εάν αυτό το models.json περιέχει ένα μη κενό baseUrl, παρακάμπτει τη διεύθυνση στην κύρια διαμόρφωση.

Έλεγχος εγκατάστασης

Τρεις εντολές

• openclaw --version
• openclaw doctor
• gateway status

Διαμόρφωση

models.providers

• baseUrl τελειώνει με /v1
• Ορισμός api σε completions
• Καθορίστε τουλάχιστον το model id

Επιλογή

provider/model

• Χρησιμοποιήστε αυτήν την αναφορά για την κύρια
• Προτιμήστε μια μεταβλητή περιβάλλοντος για το κλειδί
• Χρησιμοποιήστε τη λίστα gateway ως πηγή αλήθειας

Επαλήθευση μιας πραγματικής εργασίας

Εισαγάγετε έναν κανονικό κατάλογο έργου και στείλτε ένα πολύ σύντομο μήνυμα. Αντικαταστήστε την αναφορά μοντέλου στην εντολή με το πλήρες Model ID σας:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local εκτελεί αυτήν την εργασία πράκτορα τοπικά, --model καθορίζει το μοντέλο που θα χρησιμοποιηθεί για αυτήν την εκτέλεση και --timeout 300 ορίζει τον μέγιστο χρόνο αναμονής στα 300 δευτερόλεπτα.

Μια πραγματική απόκριση μοντέλου πρέπει να εμφανιστεί στο τερματικό. Στις 09-10-2026, το OpenClaw 2026.9.9 έλαβε μια απόκριση χρησιμοποιώντας αυτήν την εντολή. Η πρώτη κλήση μπορεί να διαρκέσει ένα ή δύο λεπτά.

Εάν εμφανιστεί το αρχικό σφάλμα Request timed out before a response was generated , αυξήστε το --timeout και στείλτε ξανά το αίτημα. Αυτό συνήθως σημαίνει ότι ο χρόνος αναμονής ήταν ανεπαρκής και δεν υποδηλώνει απαραίτητα ότι η διεύθυνση είναι λανθασμένη.

Αφού επιτύχει η σύντομη απόκριση, ζητήστε του να διαβάσει ένα τοπικό αρχείο που καθορίζετε. Στη συνέχεια, ανοίξτε τα αρχεία αιτημάτων του OmniProxy και επιβεβαιώστε την πηγή και το αναγνωριστικό μοντέλου που εμφανίζονται στο αρχείο. Η έξοδος μόνο από την εντολή έκδοσης ή το doctor δεν σημαίνει ότι η σύνδεση μοντέλου έχει ρυθμιστεί πλήρως.

Εγκατάσταση

Η εντολή αποκρίνεται

• Ο αριθμός έκδοσης εμφανίζεται
• Το doctor δεν αναφέρει εμπόδια
• Η κατάσταση του Gateway είναι αναγνώσιμη

Εργασία

Ολοκλήρωσε μια μικρή εργασία

• Για παράδειγμα, διαβάστε ένα τοπικό αρχείο
• Η απόκριση δεν είναι σφάλμα
• Η αναφορά μοντέλου είναι σωστή

Αρχεία καταγραφής (Logs)

Ορατό στο gateway

• Η πηγή είναι το OpenClaw
• Το Model ID ταιριάζει
• Το κλειδί δεν προστέθηκε στο αποθετήριο

Κοινά σφάλματα

• Δεν είναι δυνατή η εύρεση του openclaw: Προσθέστε τον κατάλογο npm global bin στο PATH, στη συνέχεια ανοίξτε ξανά το τερματικό. Εάν εγκαταστήσατε σε καθορισμένο κατάλογο, εκτελέστε το εκτελέσιμο από τον κατάλογο bin φάκελο.
• node -v είναι κάτω από 24.16: Δεν χρειάζεται να απεγκαταστήσετε πρώτα την παλιά έκδοση. Ελέγξτε την έκδοση του Node που προετοιμάστηκε από το σενάριο εγκατάστασης ή χρησιμοποιήστε 24.16+ ή 26.1+ όπως περιγράφεται στη σελίδα εγκατάστασης. Το Node 26 προτείνεται.
• Το μοντέλο δεν εμφανίζεται: Το μοντέλο πρέπει να περιλαμβάνεται στον πίνακα models κάτω από το models.providers και πρέπει τουλάχιστον να έχει το ίδιο id. Η ρύθμιση μόνο του agents.defaults.models δεν καταχωρεί από μόνη της ένα νέο μοντέλο.
• Μια απόκριση 400 αναφέρει τον ρόλο προγραμματιστή: Όταν ο κεντρικός υπολογιστής διεύθυνσης δεν είναι api.openai.com, διατηρήστε την προεπιλογή και μην ορίσετε το supportsDeveloperRole σε true. Ακόμα κι αν οριστεί σε true, θα παρακαμφθεί.
• Λήγει γρήγορα το χρονικό όριο: Αυξήστε το --timeout σε περισσότερα από 300 δευτερόλεπτα πριν αλλάξετε τη διεύθυνση.
• Οι κλήσεις εργαλείων αποτυγχάνουν μετά την επιλογή gpt-6-luna: Υποστηρίζει Chat Completions· η κλήση συναρτήσεων στο Chat Completions υποστηρίζεται μόνο όταν reasoning_effort είναι none. Εάν το αναγνωριστικό στη λίστα διαφέρει από αυτό, χρησιμοποιήστε το αναγνωριστικό που εμφανίζεται στη λίστα.
• Η διεύθυνση δεν είναι προσβάσιμη: Επιβεβαιώστε ότι το OmniProxy εκτελείται, ότι το baseUrl τελειώνει με /v1, και ότι η διεύθυνση που γράφτηκε στη διαμόρφωση είναι προσβάσιμη. Άλλες διευθύνσεις ιδιωτικού δικτύου πρέπει να επιτρέπονται ξεχωριστά.
• Τα αιτήματα εξακολουθούν να πηγαίνουν σε άλλη διεύθυνση μετά τη διαμόρφωση: Ελέγξτε αν το models.json του πράκτορα περιέχει ένα διαφορετικό baseUrl.

Επίσημες αναφορές

Για τα βήματα εγκατάστασης, δείτε OpenClaw install. Για προσαρμοσμένη διαμόρφωση Παρόχου, δείτε Custom providers και configuration fields. Για τα αναγνωριστικά μοντέλων που χρησιμοποιούνται στα παραδείγματα, συγκρίνετε με το Claude model overview και GPT-6 Luna.

Αντικαταστήστε κάθε θέση με τιμές από τη δική σας ρύθμιση OmniProxy. Ποτέ μην δημοσιεύετε πραγματικό κλειδί.

Ένα αποθηκευμένο αποτέλεσμα ή HTTP 200 μόνο του δεν αποδεικνύει πλήρη συμβατότητα Πράκτορα. Ελέγξτε την πηγή και το μοντέλο στην καταγραφή κλήσεων του OmniProxy.

Επίσημες πηγές · OpenClaw ↗