עריכת הגדרות OpenClaw: מדריך הגדרה מלא (2026)
מדריך מלא לעריכת הגדרות OpenClaw עבור WhatsApp, Discord, Telegram ו-Ollama. פקודות העתק-הדבק להגדרת ערוצים, מודלים וספקים. תיקון שגיאות הגדרה נפוצות.
TL;DR
התייחסות מהירה לפקודות הגדרת OpenClaw הנפוצות ביותר:
# פתח את עורך ההגדרות
openclaw config edit
# קבע ערך ספציפי
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
# הצג את ההגדרות הנוכחיות
openclaw config show
# אימות ותיקון בעיות הגדרה
openclaw doctor
openclaw doctor --fix
# איפוס לברירת מחדל
openclaw config reset
מה זה OpenClaw?
OpenClaw הוא פריימוורק בקוד פתוח עבור עוזרי AI, המחבר מודלי שפה גדולים לערוצי הודעות כמו WhatsApp, Discord, Telegram ו-Slack. הוא תומך במספר ספקי מודלים — OpenAI, Anthropic, Ollama (מודלים מקומיים), Google ועוד — וניתן להרחיבו עם כישורים (skills) ופלאגינים מותאמים אישית.
הלב של OpenClaw הוא מערכת ההגדרות שלה. כמעט הכל — אילו ערוצים פעילים, באיזה מודל להשתמש ואילו כישורים נטענים — נשלט דרך קבצי הגדרה. שליטה ב-openclaw config edit היא המפתח להפעלת OpenClaw בדיוק כפי שאתם רוצים.
openclaw config edit: היסודות
פתיחת עורך ההגדרות
הפקודה העיקרית להגדרת OpenClaw היא:
openclaw config edit
פקודה זו פותחת את קובץ ההגדרות שלכם בעורך הטרמינל המוגדר כברירת מחדל (בדרך כלל nano, vim, או מה שמוגדר ב-$EDITOR). קובץ ההגדרות ממוקם בדרך כלל ב-~/.openclaw/config.yaml או ב-~/.config/openclaw/config.yaml, תלוי בהתקנה שלכם.
מבנה קובץ ההגדרות
קובץ ההגדרות של OpenClaw הוא בפורמט YAML ומאורגן לפי סעיפים:
# הגדרות מודל
model:
provider: openai # openai, anthropic, ollama, google
name: gpt-4o # מחרוזת מזהה של המודל
temperature: 0.7
max_tokens: 4096
# הגדרות ערוצים
channels:
whatsapp:
enabled: false
phone_number_id: ""
access_token: ""
discord:
enabled: false
bot_token: ""
telegram:
enabled: false
bot_token: ""
slack:
enabled: false
bot_token: ""
app_token: ""
# כישורים ופלאגינים
skills:
- web_search
- calculator
- weather
# המרת דיבור לטקסט (Speech-to-text)
stt:
provider: whisper
model: whisper-1
# הנחיית מערכת (System prompt)
system_prompt: "You are a helpful assistant."
הגדרת ערכים בודדים
במקום לערוך את הקובץ המלא, ניתן להגדיר ערכי הגדרה בודדים משורת הפקודה:
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5
זה שימושי עבור סקריפטים או שינויים מהירים מבלי לפתוח עורך טקסט.
הגדרת ערוצים
אינטגרציה עם WhatsApp דורשת חשבון Meta Business וגישה ל-WhatsApp Business API.
# הפעלת ערוץ WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"
# הגדרת כתובת ה-webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"
Discord
הגדרת Discord פשוטה יותר — אתם רק צריכים bot token מפורטל המפתחים של Discord.
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"
Telegram
Telegram דורש bot token מ-@BotFather:
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"
Telegram תומך הן במצב polling והן במצב webhook. מצב Polling קל יותר לפיתוח (אין צורך בכתובת URL ציבורית):
openclaw config set channels.telegram.mode polling
עבור סביבת ייצור (production), השתמשו במצב webhook:
openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"
Slack
אינטגרציה עם Slack משתמשת ב-Socket Mode (מומלץ) או ב-Events API:
openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"
Socket Mode מומלץ מכיוון שהוא אינו דורש כתובת URL ציבורית.
הגדרת ספקי מודלים
OpenAI
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
הגדירו את ה-API key שלכם כמשתנה סביבה (אל תשימו אותו בקובץ ההגדרות):
export OPENAI_API_KEY="sk-..."
Anthropic (Claude)
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
export ANTHROPIC_API_KEY="sk-ant-..."
Ollama (מודלים מקומיים)
כאן OpenClaw מצטיינת עבור משתמשים המודעים לפרטיות. Ollama מאפשרת להריץ מודלים באופן מקומי ללא צורך ב-API keys ומבלי שהנתונים יעזבו את המחשב שלכם.
# התקינו תחילה את Ollama
# https://ollama.ai
# משכו מודל (Pull)
ollama pull llama3.3
# הגדירו את OpenClaw להשתמש ב-Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"
ollama serve) ושכתובת ה-base URL תואמת. פורט ברירת המחדל של Ollama הוא 11434.
Google (Gemini)
openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro
export GOOGLE_API_KEY="..."
xAI (Grok)
openclaw config set model.provider openai # xAI משתמש ב-API תואם OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"
export OPENAI_API_KEY="xai-..." # השתמשו במפתח xAI עם ספק openai
שגיאות הגדרה נפוצות ותיקונן
שגיאה: "Unknown config key"
Error: Unknown config key 'chanels.whatsapp.enabled'
זה בדרך כלל אומר שיש טעות הקלדה (typo) במפתח ההגדרה. בדקו את האיות. טעויות נפוצות:
chanels←channelsprovidr←providertelgram←telegram
הריצו
openclaw config show כדי לראות את כל המפתחות התקינים.
שגיאה: "Channel auto-enabled without credentials"
גרסאות מסוימות של OpenClaw מפעילות ערוצים אוטומטית כשמגדירים אישורי גישה, גם אם לא הפעלתם אותם במפורש. זה עלול לגרום לכשלים בעת ההפעלה אם אישורי הגישה אינם מלאים.
תיקון:# נטרלו במפורש ערוצים שאינכם משתמשים בהם
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false
שגיאה: "Model provider not configured"
Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY
עליכם להגדיר את משתנה הסביבה המתאים. OpenClaw במכוון אינה שומרת API keys בקובץ ההגדרות מטעמי אבטחה.
תיקון: הוסיפו את ה-API key לפרופיל ה-shell שלכם (~/.bashrc, ~/.zshrc) או השתמשו בקובץ .env:
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc
שימוש ב-openclaw doctor
הפקודה openclaw doctor מאמתת את כל ההגדרות שלכם ומדווחת על בעיות:
openclaw doctor
דוגמה לפלט:
Checking configuration...
✓ Config file found
✓ Model provider configured
✗ WhatsApp: enabled but missing access_token
✗ Discord: bot token invalid format
✓ Telegram: configured correctly
✓ Ollama: connection successful
2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.
הדגל --fix מנסה לפתור בעיות באופן אוטומטי:
openclaw doctor --fix
זה ינטרל ערוצים עם אישורי גישה חסרים, יתקן בעיות פורמט מוכרות ויציע תיקונים ידניים לבעיות שאינן ניתנות לפתרון אוטומטי.
הגדרות מתקדמות
כישורים (Skills) מותאמים אישית
OpenClaw תומכת בכישורים מותאמים אישית (פלאגינים) המרחיבים את יכולות העוזר:
skills:
- web_search
- calculator
- weather
- custom_skill:
path: ./my-skills/custom_tool.py
config:
api_key_env: CUSTOM_API_KEY
או דרך שורת הפקודה:
openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator
הגדרת המרת דיבור לטקסט (STT)
עבור תמיכה בהודעות קוליות ב-WhatsApp וב-Telegram:
stt:
provider: whisper # whisper, deepgram, google
model: whisper-1
language: auto # זיהוי אוטומטי או ציינו "he", "en" וכו'.
openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1
אינטגרציה עם Tuya Smart Home
OpenClaw יכולה לשלוט במכשירי בית חכם תואמי Tuya:
tuya:
enabled: true
access_id: "YOUR_TUYA_ACCESS_ID"
access_key: "YOUR_TUYA_ACCESS_KEY"
endpoint: "https://openapi.tuyaus.com"
זה מאפשר לכם לשלוט באורות, מתגים, תרמוסטטים ומכשירי Tuya אחרים באמצעות פקודות בשפה טבעית בכל ערוץ מחובר.
הגדרות של מספר מודלים
ניתן להגדיר מודלים קבועים מראש (presets) ולעבור ביניהם:
models:
default:
provider: openai
name: gpt-4o
fast:
provider: ollama
name: llama3.3
reasoning:
provider: anthropic
name: claude-opus-4-6
openclaw config set model.active default
# או החלפה בזמן ריצה
openclaw --model fast
שאלות נפוצות
איפה נשמר קובץ ההגדרות של OpenClaw?
המיקום המוגדר כברירת מחדל הוא ~/.openclaw/config.yaml. בהתקנות מסוימות הוא עשוי להיות ב-~/.config/openclaw/config.yaml. הריצו openclaw config show --path כדי לראות את המיקום המדויק.
האם אני יכול להשתמש ב-OpenClaw ללא API בענן?
כן. הגדירו את Ollama כספק המודל שלכם והשתמשו ב-Telegram במצב polling. זה ייתן לכם עוזר AI פרטי ומקומי לחלוטין מבלי שהנתונים שלכם יעזבו את המחשב.
איך מעדכנים את OpenClaw?
pip install --upgrade openclaw
# או
npm update -g openclaw
לאחר העדכון, הריצו openclaw doctor כדי לבדוק אם חלו שינויים בפורמט ההגדרות.
האם ניתן להריץ מספר ערוצים בו-זמנית?
כן. הפעילו כמה ערוצים שתרצו — OpenClaw מטפלת בהם במקביל. כל ערוץ משתמש באותן הגדרות מודל וכישורים.
איך מאפסים את ההגדרות לברירת המחדל?
openclaw config reset
זה ידרוס את קובץ ההגדרות שלכם עם התבנית המקורית. גבו את ההגדרות הקיימות שלכם תחילה אם יש צורך.
רוצים משהו פשוט יותר?
OpenClaw עוצמתית אך דורשת נוחות בעבודה עם הטרמינל והגדרות ידניות. אם אתם רוצים לבנות ולהשיק מוצרי AI מבלי לנהל קבצי הגדרה, ספקי מודלים ואינטגרציות של ערוצים בעצמכם:
Y Build מטפלת בכל המערך (full stack) — פריסה (deployment), סרטוני מוצר, AI SEO ואנליטיקה. ללא קבצי הגדרה. ללא טרמינל. פשוט בונים ומשיקים. התחילו בחינם ←מקורות: