OpenClaw ஐ நிறுவுதல் மற்றும் OmniProxy ஐ உள்ளமைத்தல்

OpenClaw என்பது உங்கள் சொந்த கணினியில் நிறுவப்பட்ட ஒரு AI உதவியாளர். மற்றொரு சாட் விண்டோவைத் திறக்காமலேயே டெலிகிராம், டிஸ்கார்ட், வாட்ஸ்அப் அல்லது ஃபீஷு (Feishu) மூலம் நீங்கள் நேரடியாக அதனுடன் பேசலாம். உரையாடல்கள் மற்றும் பதிவுகள் இந்த கணினியிலேயே இருக்கும், மேலும் இது உள்ளூர் அளவில் அடுத்தடுத்த படிகளைத் தொடர்ந்து மேற்கொள்ள முடியும்.

தொடங்குவதற்கு முன்

OpenClaw-க்கு Node 24.16 அல்லது அதற்குப் பிந்தைய பதிப்பு தேவை. நீங்கள் Node 26.1 அல்லது அதற்குப் பிந்தைய பதிப்பையும் பயன்படுத்தலாம், Node 26 பரிந்துரைக்கப்படுகிறது. OpenClaw-க்குத் தேவையான ரன்டைம் சூழலை Node வழங்குகிறது.

இதை macOS, Linux மற்றும் Windows-ல் நிறுவலாம். கணினியில் தகுந்த Node பதிப்பு இல்லையென்றால், நிறுவல் ஸ்கிரிப்ட் தானாகவே ஒன்றை தயார் செய்யும்: macOS-ல் Node 26 மற்றும் Linux-ல் Node 24 LTS. மூலத்திலிருந்து (source) OpenClaw-ஐ உருவாக்கும்போது மட்டுமே pnpm தேவைப்படும்.

ஏற்கனவே பழைய Node பதிப்பு நிறுவப்பட்டிருந்தால், முதலில் அதை நீக்க வேண்டிய அவசியமில்லை. 2026-10-09 அன்று நடந்த சோதனையில், இந்த கணினியில் இருந்த சிஸ்டம் Node பதிப்பு 24.2.0 (தேவையான 24.16-க்குக் கீழ்) இருந்தது, மேலும் இன்டராக்டிவ் அல்லாத நிறுவல் ஸ்கிரிப்ட் தானாகவே Node 24.21.0-ஐ தயார் செய்தது.

விண்டோ வேண்டுமா

டெஸ்க்டாப் துணையை (Desktop companion) பதிவிறக்கவும்

• Windows-ல் Hub இன்ஸ்டாலரைப் பயன்படுத்தவும்
• macOS-ல் GitHub DMG-ஐப் பயன்படுத்தவும்
• ஆரம்ப அமைப்பின் போது உள்ளூர் Gateway-ஐ நிறுவலாம்

அதிகாரப்பூர்வமாக பரிந்துரைக்கப்படுகிறது

நிறுவல் ஸ்கிரிப்ட்

• macOS Linux WSL2
• Windows-ல் PowerShell-ஐப் பயன்படுத்தவும்
• நீங்கள் --no-onboard-ஐச் சேர்க்கலாம்

Node ஏற்கனவே நிறுவப்பட்டுள்ளது

பேக்கேஜ் மேனேஜர்

• npm pnpm அல்லது bun
• பிறகு onboard-ஐ இயக்கவும்
• Node பதிப்பிற்கு நிறுவல் பக்கத்தைப் பார்க்கவும்

முதல் முறையாக நிறுவுதல் மற்றும் தொடங்குதல்

நீங்கள் கிராஃபிகல் விண்டோவுடன் கூடிய டெஸ்க்டாப் துணையை நிறுவலாம் அல்லது டெர்மினல் வழியாக நேரடியாக நிறுவலாம். Gateway என்பது செய்திகளைப் பெறுவதற்கும், மாடல்களை அழைப்பதற்கும் மற்றும் முடிவுகளைத் திருப்பித் தருவதற்கும் பொறுப்பான உள்ளூர் சேவையாகும். டெஸ்க்டாப் துணையை முதல்முறை திறக்கும்போது இதை நீங்கள் அமைக்கலாம்.

விண்டோ தேவைப்பட்டால்

• Windows: OpenClawCompanion-Setup-x64.exe அல்லது OpenClawCompanion-Setup-arm64.exe-ஐப் பதிவிறக்கி இயக்கவும். இன்ஸ்டாலர் கையொப்பமிடப்பட்டது மற்றும் அமைப்புகள், ட்ரே நிலை, சாட் மற்றும் நோட் மோடுகளை உள்ளடக்கியது.
• macOS: OpenClaw-ன் GitHub ரிலீஸ்களிலிருந்து OpenClaw .dmg-ஐப் பதிவிறக்கவும். 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 குளோபல் பின் (bin) டைரக்டரி பொதுவாக PATH-ல் இல்லை என்று அர்த்தம். PATH என்பது டெர்மினல் நிரல்களைத் தேடும் இடங்களின் பட்டியலாகும். node -v, npm prefix -g மற்றும் echo "$PATH" ஆகியவற்றின் வெளியீட்டை ஒப்பிட்டு, தொடர்புடைய பின் டைரக்டரியை PATH-ல் சேர்த்து, பின்னர் டெர்மினலை மீண்டும் திறக்கவும்.

~/.openclaw ஏற்கனவே பயன்பாட்டில் உள்ள உள்ளமைவைக் கொண்டிருந்தால், இயல்புநிலை நிறுவல் ஸ்கிரிப்ட் அந்த டைரக்டரியைப் பயன்படுத்தும். ஏற்கனவே உள்ள உள்ளமைவை மாற்றாமல் தனி நகலை நிறுவ, இன்டராக்டிவ் அல்லாத ஸ்கிரிப்டை இயக்கி புதிய டைரக்டரியைக் குறிப்பிடவும்:

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

--no-onboard என்பது இந்த ஸ்கிரிப்ட்டின் இயல்புநிலை நடத்தையாகும். 2026-10-09 அன்று, இந்த கட்டளை OpenClaw 2026.9.9-ஐ நிறுவியது. நிறுவிய பின், டைரக்டரியின் bin ஃபோல்டரிலிருந்து openclaw எக்ஸிகியூட்டபிளை இயக்கவும்.

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-உடன் இணைக்கும்போது, api-க்கு openai-completions-ஐப் பயன்படுத்தவும். மாடல் உண்மையில் /v1/responses வழியாக வேலை செய்தால் மட்டுமே அதை openai-responses-க்கு மாற்றவும்.

மாடல் ஐடி (Model ID) என்பது பட்டியலில் உள்ள மாடலின் முழுமையான அடையாளங்காட்டியாகும். ஸ்லாஷ்கள் (slashes) உட்பட, காட்டப்பட்டுள்ளபடி அதை அப்படியே நகலெடுக்கவும். பின்வரும் இரண்டு பெயர்கள் 2026-10-09 நிலவரப்படி வழங்குநர் ஆவணங்களிலிருந்து பெறப்பட்ட குறிப்புகள் மட்டுமே; அவை பட்டியலில் இல்லை என்றால் அவற்றைப் பயன்படுத்த வேண்டாம்: claude-sonnet-5-5, gpt-6-luna.

Gateway கீயைச் சரிபார்க்கவில்லை என்றாலும், apiKey-ல் ஒரு மதிப்பு இருக்க வேண்டும். இந்த கணினியில் மட்டுமே பயன்படுத்தப்படும் ஒரு பிளேஸ்ஹோல்டர் சரத்தைப் (placeholder string) பயன்படுத்தலாம். உண்மையான கீயை ரெபோசிட்டரியில் கமிட் செய்ய வேண்டாம்.

டூல் உள்ளமைவை உள்ளிடுதல்

ஒரு வழங்குநரை (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-ன் கீழ் அமைந்துள்ளது. ஒவ்வொரு ஏஜென்ட்டும் அதன் சொந்த models.json-ஐயும் கொண்டிருக்கலாம்; ஏஜென்ட் என்பது பணிகளைப் பெற்று மாடல்களை அழைக்கும் ஒரு உதவியாளர் நிகழ்வாகும். கோப்பு ~/.openclaw/agents/-ன் கீழ் தொடர்புடைய ஏஜென்ட் டைரக்டரியில் agent/models.json-ல் அமைந்துள்ளது.

இந்த models.json காலியாக இல்லாத baseUrl-ஐக் கொண்டிருந்தால், அது பிரதான உள்ளமைவில் உள்ள முகவரியை மீறுகிறது (overrides).

நிறுவலைச் சரிபார்க்கவும்

மூன்று கட்டளைகள்

• openclaw --version
• openclaw doctor
• gateway status

உள்ளமைவு

models.providers

• baseUrl /v1-ல் முடிவடைகிறது
• api-ஐ completions-க்கு அமைக்கவும்
• குறைந்தது மாடல் ஐடியையாவது குறிப்பிடவும்

தேர்ந்தெடுக்கவும்

provider/model

• முதன்மைக்கு இந்த குறிப்பைப் பயன்படுத்தவும்
• கீ-க்கு என்விரான்மென்ட் வேரியபிளை விரும்பவும்
• Gateway பட்டியலை ஆதாரமாகப் பயன்படுத்தவும்

உண்மையான பணியைச் சரிபார்க்கவும்

ஒரு சாதாரண புராஜெக்ட் டைரக்டரியை உள்ளிட்டு மிகச் சிறிய செய்தியை அனுப்பவும். கட்டளையில் உள்ள மாடல் குறிப்பை உங்கள் முழுமையான மாடல் ஐடியுடன் மாற்றவும்:

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

--local இந்த ஏஜென்ட் பணியை உள்ளூர் அளவில் இயக்குகிறது, --model இந்த இயக்கத்திற்குப் பயன்படுத்த வேண்டிய மாடலைக் குறிப்பிடுகிறது, மற்றும் --timeout 300 அதிகபட்ச காத்திருப்பு நேரத்தை 300 வினாடிகளாக அமைக்கிறது.

உண்மையான மாடல் பதில் டெர்மினலில் தோன்ற வேண்டும். 2026-10-09 அன்று, OpenClaw 2026.9.9 இந்த கட்டளையைப் பயன்படுத்தி ஒரு பதிலைப் பெற்றது. முதல் அழைப்பிற்கு ஒன்று அல்லது இரண்டு நிமிடங்கள் ஆகலாம்.

அசல் பிழை Request timed out before a response was generated தோன்றினால், --timeout-ஐ அதிகரித்து கோரிக்கையை மீண்டும் அனுப்பவும். இது பொதுவாக காத்திருப்பு நேரம் போதாது என்று அர்த்தம், முகவரி தவறானது என்று அர்த்தமல்ல.

குறுகிய பதில் வெற்றிபெற்ற பிறகு, நீங்கள் குறிப்பிடும் உள்ளூர் கோப்பை வாசிக்குமாறு அதைக் கேட்கவும். பின்னர் OmniProxy-ன் கோரிக்கை பதிவுகளைத் திறந்து, பதிவில் காட்டப்பட்டுள்ள ஆதாரம் மற்றும் மாடல் ஐடியை உறுதிப்படுத்தவும். பதிப்பு கட்டளை அல்லது டாக்டர் கட்டளையின் வெளியீடு மட்டுமே மாடல் இணைப்பு முழுமையாக உள்ளமைக்கப்பட்டுள்ளது என்று அர்த்தமல்ல.

நிறுவல்

கட்டளை பதிலளிக்கிறது

• பதிப்பு எண் காட்டப்படுகிறது
• doctor கட்டளை எந்தத் தடைகளையும் தெரிவிக்கவில்லை
• Gateway நிலை படிக்கக்கூடியதாக உள்ளது

பணி

இது ஒரு சிறிய பணியை முடித்தது

• உதாரணத்திற்கு, உள்ளூர் கோப்பை வாசிக்கவும்
• பதில் பிழையாக இல்லை
• மாடல் குறிப்பு சரியானது

பதிவுகள்

Gateway-ல் தெரியும்

• ஆதாரம் OpenClaw
• மாடல் ஐடி பொருந்துகிறது
• கீ ரெபோசிட்டரியில் சேர்க்கப்படவில்லை

பொதுவான பிழைகள்

• openclaw-ஐக் கண்டறிய முடியவில்லை: npm குளோபல் பின் டைரக்டரியை PATH-ல் சேர்த்து, பின்னர் டெர்மினலை மீண்டும் திறக்கவும். நீங்கள் குறிப்பிட்ட டைரக்டரியில் நிறுவியிருந்தால், அந்த டைரக்டரியின் bin ஃபோல்டரிலிருந்து எக்ஸிகியூட்டபிளை இயக்கவும்.
• node -v 24.16-க்குக் கீழே உள்ளது: பழைய பதிப்பை முதலில் நீக்க வேண்டிய அவசியமில்லை. நிறுவல் ஸ்கிரிப்ட் தயார் செய்த Node பதிப்பைச் சரிபார்க்கவும் அல்லது நிறுவல் பக்கத்தில் விவரிக்கப்பட்டுள்ளபடி 24.16+ அல்லது 26.1+-ஐப் பயன்படுத்தவும். Node 26 பரிந்துரைக்கப்படுகிறது.
• மாடல் தோன்றவில்லை: மாடல் models.providers-ன் கீழ் உள்ள models வரிசையில் சேர்க்கப்பட வேண்டும் மற்றும் குறைந்தபட்சம் அதே id-ஐக் கொண்டிருக்க வேண்டும். agents.defaults.models-ஐ மட்டும் அமைப்பது புதிய மாடலைத் தானாகவே பதிவு செய்யாது.
• 400 பதில் டெவலப்பர் ரோலைக் குறிப்பிடுகிறது: முகவரி ஹோஸ்ட் api.openai.com ஆக இல்லாதபோது, இயல்புநிலையை வைத்துக்கொள்ளுங்கள் மற்றும் supportsDeveloperRole-ஐ true என்று அமைக்க வேண்டாம். அது true என்று அமைக்கப்பட்டாலும், அது இன்னும் மீறப்படும்.
• இது விரைவாக காலாவதியாகிறது (times out): முகவரியை மாற்றுவதற்கு முன் --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 ↗