Instal·lació d'OpenClaw i configuració d'OmniProxy

OpenClaw és un assistent d’IA instal·lat al teu propi ordinador. Pots parlar-hi directament a través de Telegram, Discord, WhatsApp o Feishu sense haver de mantenir una altra finestra de xat oberta. Les converses i els registres romanen en aquest ordinador, i pot continuar duent a terme els passos següents de manera local.

Abans de començar

OpenClaw requereix Node 24.16 o posterior. També pots utilitzar Node 26.1 o posterior, sent recomanable Node 26. Node proporciona l’entorn d’execució necessari per a OpenClaw.

Es pot instal·lar en macOS, Linux i Windows. Si l’ordinador no té una versió adequada de Node, l’script d’instal·lació en prepararà una automàticament: Node 26 en macOS i Node 24 LTS en Linux. pnpm només és necessari quan es compila OpenClaw des del codi font.

Si ja tens instal·lada una versió antiga de Node, no cal que la desinstal·lis primer. Durant les proves realitzades el 09-10-2026, la versió de Node del sistema en aquest ordinador era la 24.2.0, per sota de la 24.16 requerida, i l’script d’instal·lació no interactiva va preparar la Node 24.21.0 automàticament.

Vols una finestra

Company d'escriptori

• Utilitza l'instal·lador Hub a Windows
• Utilitza el DMG de GitHub a macOS
• La Gateway local es pot instal·lar durant la configuració inicial

Recomanat oficialment

Script d'instal·lació

• macOS Linux WSL2
• Utilitza PowerShell a Windows
• Pots afegir --no-onboard

Node ja instal·lat

Gestor de paquets

• npm pnpm o bun
• Després executa onboard
• Consulta la pàgina d'instal·lació per a la versió de Node

Instal·lació i llançament per primera vegada

Pots instal·lar el company d’escriptori amb una finestra gràfica, o instal·lar-lo directament a través del terminal. Gateway és el servei local responsable de rebre missatges, cridar models i retornar els resultats. Pots configurar-lo quan obris el company d’escriptori per primera vegada.

Si vols una finestra

• Windows: Descarrega i executa OpenClawCompanion-Setup-x64.exe o OpenClawCompanion-Setup-arm64.exe. L’instal·lador està signat i inclou configuració, estat a la safata del sistema, xat i modes de node.
• macOS: Descarrega el OpenClaw .dmg des dels llançaments de GitHub d’OpenClaw. Prefereix el dmg, tot i que també pots utilitzar el .zip. Obre OpenClaw.app després de la instal·lació. Si aquesta versió no inclou un fitxer per a macOS, segueix la pàgina de l’aplicació per a macOS.

Quan l’obris per primera vegada, pots deixar que OpenClaw prepari la Gateway en aquest ordinador o connectar-te a una Gateway remota existent.

Instal·lació a través del terminal

Per a macOS, Linux i WSL2, utilitza:

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

Per a Windows PowerShell, utilitza:

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

L’script detecta el sistema actual, instal·la Node quan és necessari, instal·la OpenClaw i després inicia el procés d’incorporació inicial. El flux d’incorporació et guia a través de la configuració per primera vegada.

Si encara no vols iniciar la incorporació, utilitza el següent en el seu lloc a macOS, Linux i WSL2:

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

A Windows, utilitza l’opció oficial -NoOnboard :

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

Si ja gestiones Node tu mateix, també pots utilitzar npm, pnpm o bun. Amb npm 12 o npm 11.16 i posteriors, executa:

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

Per a npm 11.15 i anteriors, elimina --allow-scripts=openclaw. Quan utilitzis pnpm, afegeix --allow-build=openclaw. Consulta la pàgina d’instal·lació per a les diferències exactes.

Després de la instal·lació, executa aquestes tres ordres en ordre:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version mostra la versió, openclaw doctor comprova problemes comuns de l’entorn, i openclaw gateway status mostra si la Gateway s’està executant. La instal·lació bàsica només es completa quan les tres ordres produeixen una sortida normal.

Si el terminal informa que no pot trobar openclaw, normalment falta el directori bin global de npm al PATH. PATH és la llista d’ubicacions on el terminal busca programes. Compara la sortida de node -v, npm prefix -g, i echo "$PATH", afegeix el directori bin corresponent al PATH i, a continuació, torna a obrir el terminal.

Si ~/.openclaw ja conté una configuració actualment en ús, l’script d’instal·lació per defecte utilitzarà aquest directori. Per instal·lar una còpia separada sense canviar la configuració existent, executa l’script no interactiu i especifica un directori nou:

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

--no-onboard és el comportament per defecte d’aquest script. El 09-10-2026, aquesta ordre va instal·lar OpenClaw 2026.9.9. Després de la instal·lació, executa l’executable openclaw des de la carpeta bin del directori.

Obtenir valors de connexió d’OmniProxy

Primer confirma que OmniProxy s’està executant, després obre la seva llista de models i prepara els tres valors següents:

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 és l’adreça a la qual OpenClaw envia les sol·licituds de model, i ha d’acabar amb /v1. Quan et connectis a OmniProxy, utilitza openai-completions per a api. Canvia-ho a openai-responses només si el model funciona realment a través de /v1/responses.

L’ID del model és l’identificador complet del model a la llista. Copia’l exactament com es mostra, incloent-hi qualsevol barra inclinada. Els dos noms següents són només referències de la documentació del proveïdor a data de 09-10-2026; no els utilitzis si no apareixen a la llista: claude-sonnet-5-5, gpt-6-luna.

Fins i tot si la gateway no valida la clau, apiKey ha de contenir un valor. Pots utilitzar una cadena de text de marcatge (placeholder) que només s’utilitzi en aquest ordinador. No enviïs una clau real a un repositori.

Introduir la configuració de l’eina

Un proveïdor (Provider) es pot entendre com un conjunt de paràmetres de connexió que OpenClaw utilitza per localitzar un servei de model. Aquí, el proveïdor s’anomena omniproxy.

Executa l’ordre següent al terminal, substituint l’adreça, la clau i els dos IDs de model pels teus propis valors:

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

Aquesta ordre escriu el proveïdor i la llista de models a la configuració. No cal reiniciar la Gateway després que l’ordre s’executi correctament.

Seguidament, especifica el model per defecte. La referència del model consisteix en omniproxy/ seguit de l’ID del model. Conserva totes les barres inclinades que ja estiguin presents a l’ID. Si l’ID a la llista de models és més llarg que el nom curt de sota, utilitza el valor complet de la llista:

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

reasoning, input, cost, contextWindow, i maxTokens es poden ometre. Quan no es proporcionen, els models de text es gestionen utilitzant els valors per defecte.

Pots escriure els mateixos paràmetres directament al fitxer de configuració. A la configuració principal, el proveïdor es troba sota models.providers. Cada agent també pot tenir el seu propi models.json; un agent és una instància d’assistent que rep tasques i crida models. El fitxer es troba a agent/models.json dins del directori de l’agent corresponent sota ~/.openclaw/agents/.

Si aquest models.json conté un baseUrlno buit, substitueix l’adreça de la configuració principal.

Comprova la instal·lació

Tres ordres

• openclaw --version
• openclaw doctor
• gateway status

Configuració

models.providers

• baseUrl acaba amb /v1
• Estableix api a completions
• Especifica almenys l'id del model

Selecciona

provider/model

• Utilitza aquesta referència per a la principal
• Prefereix una variable d'entorn per a la clau
• Utilitza la llista de la gateway com a font de veritat

Verificar una tasca real

Entra en un directori de projecte normal i envia un missatge molt curt. Substitueix la referència del model a l’ordre pel teu ID de model complet:

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

--local executa aquesta tasca d’agent localment, --model especifica el model a utilitzar per a aquesta execució, i --timeout 300 estableix el temps d’espera màxim a 300 segons.

Ha d’aparèixer una resposta real del model al terminal. El 09-10-2026, OpenClaw 2026.9.9 va rebre una resposta utilitzant aquesta ordre. La primera crida pot trigar un o dos minuts.

Si apareix l’error original Request timed out before a response was generated , augmenta --timeout i torna a enviar la sol·licitud. Això normalment significa que el temps d’espera era insuficient i no indica necessàriament que l’adreça sigui incorrecta.

Després que la resposta curta tingui èxit, demana-li que llegeixi un fitxer local que especifiquis. Després, obre els registres de sol·licituds d’OmniProxy i confirma la font i l’ID del model que es mostren al registre. La sortida només de l’ordre de versió o del doctor no significa que la connexió del model s’hagi configurat completament.

Instal·lació

L'ordre respon

• Es mostra el número de versió
• El doctor no informa de bloquejos
• L'estat de la Gateway és llegible

Tasca

Ha completat una petita tasca

• Per exemple, llegir un fitxer local
• La resposta no és un error
• La referència del model és correcta

Registres

Visible a la gateway

• La font és OpenClaw
• L'ID del model coincideix
• La clau no s'ha afegit al repositori

Errors comuns

• No es pot trobar openclaw: Afegeix el directori bin global de npm al PATH, després torna a obrir el terminal. Si has instal·lat en un directori especificat, executa l’executable des de la carpeta bin del directori.
• node -v està per sota de 24.16: No cal desinstal·lar la versió antiga primer. Comprova la versió de Node preparada per l’script d’instal·lació, o utilitza 24.16+ o 26.1+ tal com es descriu a la pàgina d’instal·lació. Es recomana Node 26.
• El model no apareix: El model ha d’estar inclòs a la matriu models sota models.providers i ha de tenir almenys el mateix id. Establir només agents.defaults.models no registra un model nou per si mateix.
• Una resposta 400 esmenta el rol de desenvolupador: Quan l’amfitrió de l’adreça no és api.openai.com, mantingues el valor per defecte i no estableixis supportsDeveloperRole a true. Fins i tot si s’estableix a true, serà substituït.
• S’esgota el temps d’espera ràpidament: Augmenta --timeout a més de 300 segons abans de canviar l’adreça.
• Les crides a eines fallen després de seleccionar gpt-6-luna: Admet Chat Completions; la crida a funcions en Chat Completions només s’admet quan reasoning_effort és none. Si l’ID a la llista difereix d’aquest, utilitza l’ID que es mostra a la llista.
• No es pot arribar a l’adreça: Confirma que OmniProxy s’està executant, que baseUrl acaba amb /v1, i que l’adreça escrita a la configuració és accessible. Altres adreces de xarxa privada s’han d’autoritzar per separat.
• Les sol·licituds encara van a una altra adreça després de la configuració: Comprova si el models.json d’aquest agent conté un baseUrl diferent.

Referències oficials

Per als passos d’instal·lació, consulta OpenClaw install. Per a la configuració personalitzada del proveïdor, consulta Custom providers i configuration fields. Per als IDs de model utilitzats als exemples, compara amb Claude model overview i GPT-6 Luna.

Substitueix cada marcador de posició amb valors de la teva pròpia configuració d'OmniProxy. No publiquis mai una clau real.

Un resultat guardat o HTTP 200 sols no demostra compatibilitat completa de l'Agent. Comprova la font i el model al registre de crides d'OmniProxy.

Fonts oficials · OpenClaw ↗