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

OpenClaw என்பது உங்கள் சொந்த கணினியில் நிறுவப்பட்ட ஒரு AI உதவியாளர். நீங்கள் மற்றொரு அரட்டை சாளரத்தைத் திறக்காமலேயே Telegram, Discord, WhatsApp அல்லது Feishu மூலம் நேரடியாக அதனுடன் பேசலாம். உரையாடல்கள் மற்றும் பதிவுகள் இந்த கணினியிலேயே இருக்கும், மேலும் இது உள்ளூர் அளவில் அடுத்தடுத்த படிகளைத் தொடர்ந்து மேற்கொள்ள முடியும்.

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

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

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

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

சாளரம் வேண்டுமா

டெஸ்க்டாப் துணை நிரல்

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

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

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

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

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

தொகுப்பு மேலாளர் (Package manager)

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

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

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

உங்களுக்கு ஒரு சாளரம் தேவைப்பட்டால்

• Windows: OpenClawCompanion-Setup-x64.exe அல்லது OpenClawCompanion-Setup-arm64.exe-ஐப் பதிவிறக்கி இயக்கவும். நிறுவி கையொப்பமிடப்பட்டது மற்றும் அமைப்புகள், தட்டு நிலை (tray status), அரட்டை மற்றும் நோட் முறைகளை உள்ளடக்கியது.
• 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) நீங்கள் பயன்படுத்தலாம். உண்மையான விசையை களஞ்சியத்தில் (repository) சமர்ப்பிக்க வேண்டாம்.

கருவி உள்ளமைவை உள்ளிடுதல்

ஒரு வழங்குநரை (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

உள்ளமைவு (Configuration)

models.providers

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

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

provider/model

• முதன்மைக்கு இந்த குறிப்பைப் பயன்படுத்தவும்
• விசைக்கு ஒரு சூழல் மாறியை (environment variable) விரும்பவும்
• 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) வெளியீடு மட்டுமே மாடல் இணைப்பு முழுமையாக உள்ளமைக்கப்பட்டுள்ளது என்று அர்த்தமல்ல.

நிறுவல்

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

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

பணி

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

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

பதிவுகள் (Logs)

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-ல் செயல்பாட்டு அழைப்பு (function calling) 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 ↗