การกำหนดค่า

ตัวช่วยแบบไม่โต้ตอบสำหรับ openclaw.json: รับ/ตั้งค่า/แพตช์/ยกเลิกการตั้งค่าค่าตามพาธ แสดงสคีมา ตรวจสอบความถูกต้อง หรือแสดงพาธไฟล์ที่ใช้งานอยู่ เรียกใช้ openclaw config โดยไม่มีคำสั่งย่อยเพื่อเปิดวิซาร์ดแบบมีคำแนะนำเดียวกับ openclaw configure

ตัวเลือกระดับราก

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tc2VjdGlvbiA8c2VjdGlvbg " type="string"> ตัวกรองส่วนของการตั้งค่าแบบมีคำแนะนำที่ระบุซ้ำได้ เมื่อเรียกใช้ openclaw config โดยไม่มีคำสั่งย่อย

ส่วนที่มีคำแนะนำ: workspace, model, web, gateway, daemon, channels, plugins, skills, health

ตัวอย่าง

openclaw config fileopenclaw config --section modelopenclaw config --section gateway --section daemonopenclaw config schemaopenclaw config get browser.executablePathopenclaw config set browser.executablePath "/usr/bin/google-chrome"openclaw config set browser.profiles.work.executablePath "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"openclaw config set agents.defaults.heartbeat.every "2h"openclaw config set 'agents.list[0].tools.exec.node' "node-id-or-name"openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --mergeopenclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKENopenclaw config set secrets.providers.vaultfile --provider-source file --provider-path /etc/openclaw/secrets.json --provider-mode jsonopenclaw config patch --file ./openclaw.patch.json5 --dry-runopenclaw config unset plugins.entries.brave.config.webSearch.apiKeyopenclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN --dry-runopenclaw config validateopenclaw config validate --json

พาธ

ใช้รูปแบบจุดหรือวงเล็บเหลี่ยม ให้ใส่เครื่องหมายคำพูดครอบพาธแบบวงเล็บเหลี่ยมในตัวอย่างเชลล์ เพื่อไม่ให้ zsh ขยาย glob ของ [0]:

openclaw config get agents.defaults.workspaceopenclaw config get 'agents.list[0].id'openclaw config get agents.listopenclaw config set 'agents.list[1].tools.exec.node' "node-id-or-name"

config get

อ่านค่าจากสแนปช็อตการกำหนดค่าที่ปกปิดข้อมูลแล้ว (จะไม่แสดงข้อมูลลับ) --json จะแสดงค่าดิบเป็น JSON มิฉะนั้น สตริง/ตัวเลข/บูลีนจะแสดงโดยไม่มีการจัดรูปแบบ และออบเจ็กต์/อาร์เรย์จะแสดงเป็น JSON ที่จัดรูปแบบแล้ว

เมื่อไม่มีพาธดังกล่าว --json จะเขียน { "error": "Config path not found: <path>" } ไปยัง stdout และจบการทำงานด้วยสถานะ 1 หากไม่มี --json ข้อวินิจฉัยจะยังคงอยู่บน stderr

openclaw config get browser.executablePathopenclaw config get agents.defaults.model --json

config file

แสดงพาธไฟล์การกำหนดค่าที่ใช้งานอยู่ ซึ่งแปลงค่าจาก OPENCLAW_CONFIG_PATH หรือตำแหน่งเริ่มต้น พาธนี้ระบุไฟล์ปกติ ไม่ใช่ลิงก์สัญลักษณ์ โปรดดู ความปลอดภัยในการเขียน

config schema

แสดงสคีมา JSON ที่สร้างขึ้นสำหรับ openclaw.json ไปยัง stdout

openclaw config schemaopenclaw config schema > openclaw.schema.json

config validate

ตรวจสอบความถูกต้องของการกำหนดค่าปัจจุบันเทียบกับสคีมาที่ใช้งานอยู่ โดยไม่เริ่ม Gateway

openclaw config validateopenclaw config validate --json

ค่า

ระบบจะแยกวิเคราะห์ค่าเป็น JSON5 เมื่อทำได้ มิฉะนั้นจะถือว่าเป็นสตริงดิบ ใช้ --strict-json เพื่อบังคับให้ใช้ JSON มาตรฐานโดยไม่มีการย้อนกลับไปใช้สตริง (จากนั้นไวยากรณ์ที่มีเฉพาะใน JSON5 เช่น ความคิดเห็น เครื่องหมายจุลภาคท้ายรายการ หรือคีย์ที่ไม่มีเครื่องหมายคำพูดจะถูกปฏิเสธ) --json เป็นนามแฝงแบบเดิมของ --strict-json บน config set

openclaw config set agents.defaults.heartbeat.every "0m"openclaw config set gateway.port 19001 --strict-jsonopenclaw config set channels.whatsapp.groups '["*"]' --strict-json

config get <path> --json จะแสดงค่าดิบเป็น JSON แทนข้อความที่จัดรูปแบบสำหรับเทอร์มินัล

เมื่อการเขียนเปลี่ยน agents.defaults.model หรือ agents.list[].model ของแต่ละเอเจนต์ OpenClaw จะแก้ไขค่าโมเดลหลักหรือโมเดลสำรองแต่ละรายการที่เปลี่ยนแปลงผ่านแค็ตตาล็อกผู้ให้บริการที่กำหนดค่าไว้ก่อนเขียน การอ้างอิงโมเดลที่ไม่รู้จักจะถูกปฏิเสธโดยไม่เปลี่ยนการกำหนดค่าที่ใช้งานอยู่ เรียกใช้ openclaw models list เพื่อดูโมเดลที่พร้อมใช้งาน

ใช้ --merge เมื่อเพิ่มรายการลงในแมปเหล่านั้น:

openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --mergeopenclaw config set models.providers.ollama.models '[{"id":"llama3.2","name":"Llama 3.2"}]' --strict-json --merge

ใช้ --replace เฉพาะเมื่อต้องการให้ค่าที่ระบุกลายเป็นค่าเป้าหมายทั้งหมดโดยเจตนา

โหมด config set

openclaw config set <path> <value>

openclaw config set channels.discord.token \  --ref-provider default \  --ref-source env \  --ref-id DISCORD_BOT_TOKEN

openclaw config set secrets.providers.vault \  --provider-source exec \  --provider-command /usr/local/bin/openclaw-vault \  --provider-arg read \  --provider-arg openai/api-key \  --provider-timeout-ms 5000

openclaw config set --batch-json '[  {    "path": "secrets.providers.default",    "provider": { "source": "env" }  },  {    "path": "channels.discord.token",    "ref": { "source": "env", "provider": "default", "id": "DISCORD_BOT_TOKEN" }  }]'

openclaw config set --batch-file ./config-set.batch.json --dry-run

การแยกวิเคราะห์แบบแบตช์จะใช้เพย์โหลดแบตช์ (--batch-json/--batch-file) เป็นแหล่งข้อมูลจริงเสมอ --strict-json / --json จะไม่เปลี่ยนพฤติกรรมการแยกวิเคราะห์แบบแบตช์

โหมดพาธ/ค่า JSON ยังใช้กับ SecretRef และผู้ให้บริการโดยตรงได้ด้วย:

openclaw config set channels.discord.token \  '{"source":"env","provider":"default","id":"DISCORD_BOT_TOKEN"}' \  --strict-json openclaw config set secrets.providers.vaultfile \  '{"source":"file","path":"/etc/openclaw/secrets.json","mode":"json"}' \  --strict-json

แฟล็กตัวสร้างผู้ให้บริการ

เป้าหมายของตัวสร้างผู้ให้บริการต้องใช้ secrets.providers.<alias> เป็นพาธ

ตัวอย่างผู้ให้บริการการเรียกใช้คำสั่งที่เสริมความปลอดภัย:

openclaw config set secrets.providers.vault \  --provider-source exec \  --provider-command /usr/local/bin/openclaw-vault \  --provider-arg read \  --provider-arg openai/api-key \  --provider-json-only \  --provider-pass-env VAULT_TOKEN \  --provider-trusted-dir /usr/local/bin \  --provider-timeout-ms 5000

config patch

วางหรือส่งแพตช์ JSON5 ที่มีรูปทรงเหมือนการกำหนดค่าผ่านไปป์ แทนการเรียกใช้คำสั่ง config set แบบอิงพาธหลายครั้ง ออบเจ็กต์จะผสานแบบเวียนเกิด อาร์เรย์และค่าสเกลาร์จะแทนที่เป้าหมาย และ null จะลบพาธเป้าหมาย

openclaw config patch --file ./openclaw.patch.json5 --dry-runopenclaw config patch --file ./openclaw.patch.json5

ไฟล์แพตช์จำกัดขนาดไว้ที่ 8 MiB แพตช์ --stdin ที่ส่งผ่านไปป์จำกัดขนาดไว้ที่ 1 MiB

ส่งแพตช์ผ่าน stdin สำหรับสคริปต์ตั้งค่าระยะไกล:

ssh user@gateway-host 'openclaw config patch --stdin --dry-run' < ./openclaw.patch.json5ssh user@gateway-host 'openclaw config patch --stdin' < ./openclaw.patch.json5

ตัวอย่างแพตช์:

{  channels: {    slack: {      enabled: true,      mode: "socket",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      groupPolicy: "open",      requireMention: false,    },    discord: {      enabled: true,      token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },      dmPolicy: "disabled",      dm: { enabled: false },      groupPolicy: "allowlist",    },  },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },      models: {        "openai/gpt-5.6-sol": { params: { fastMode: true } },      },    },  },}

ใช้ --replace-path <path> เมื่อออบเจ็กต์หรืออาร์เรย์หนึ่งรายการต้องกลายเป็นค่าที่ระบุอย่างตรงตัว แทนที่จะถูกแพตช์แบบเวียนเกิด:

openclaw config patch --file ./discord.patch.json5 --replace-path 'channels.discord.guilds["123"].channels'

--dry-run จะเรียกใช้การตรวจสอบสคีมาและความสามารถในการแก้ค่า SecretRef โดยไม่เขียนข้อมูล SecretRef ที่ใช้ exec จะถูกข้ามโดยค่าเริ่มต้นระหว่างการทดลองทำงาน ให้เพิ่ม --allow-exec เมื่อคุณตั้งใจให้การทดลองทำงานเรียกใช้คำสั่งของผู้ให้บริการ

การทดลองทำงาน

--dry-run จะตรวจสอบความถูกต้องของการเปลี่ยนแปลงโดยไม่เขียน openclaw.json ใช้ได้กับ config set, config patch และ config unset

openclaw config set channels.discord.token \  --ref-provider default \  --ref-source env \  --ref-id DISCORD_BOT_TOKEN \  --dry-run \  --json openclaw config set channels.discord.token \  --ref-provider vault \  --ref-source exec \  --ref-id discord/token \  --dry-run \  --allow-exec

รูปแบบเอาต์พุต JSON

{  ok: boolean,  operations: number,  configPath: string,  inputModes: ["value" | "json" | "builder" | "unset", ...],  checks: {    schema: boolean,    resolvability: boolean,    resolvabilityComplete: boolean,  },  refsChecked: number,  skippedExecRefs: number,  errors?: [    {      kind: "missing-path" | "schema" | "resolvability" | "model",      message: string,      ref?: string, // มีอยู่สำหรับข้อผิดพลาดด้านความสามารถในการแก้ค่า    },  ],}

{  "ok": true,  "operations": 1,  "configPath": "~/.openclaw/openclaw.json",  "inputModes": ["builder"],  "checks": {    "schema": false,    "resolvability": true,    "resolvabilityComplete": true  },  "refsChecked": 1,  "skippedExecRefs": 0}

{  "ok": false,  "operations": 1,  "configPath": "~/.openclaw/openclaw.json",  "inputModes": ["builder"],  "checks": {    "schema": false,    "resolvability": true,    "resolvabilityComplete": true  },  "refsChecked": 1,  "skippedExecRefs": 0,  "errors": [    {      "kind": "resolvability",      "message": "ข้อผิดพลาด: ไม่ได้ตั้งค่าตัวแปรสภาพแวดล้อม \"MISSING_TEST_SECRET\"",      "ref": "env:default:MISSING_TEST_SECRET"    }  ]}

การนำการเปลี่ยนแปลงไปใช้

หลังจาก config set / config patch / config unset สำเร็จแต่ละครั้ง CLI จะแสดงคำแนะนำหนึ่งในสามแบบ เพื่อให้ทราบว่า Gateway จำเป็นต้องเริ่มใหม่หรือไม่:

การเขียนไปยัง plugins.entries (หรือพาธย่อยใดๆ) จำเป็นต้องเริ่มระบบใหม่เสมอ เนื่องจาก CLI ไม่สามารถยืนยันได้ว่าโหลดข้อมูลเมตาการโหลดใหม่ของ Plugin ทุกตัวแล้ว

ความปลอดภัยในการเขียน

openclaw config set และตัวเขียนการกำหนดค่าอื่นๆ ที่ OpenClaw เป็นเจ้าของจะตรวจสอบการกำหนดค่าทั้งหมดหลังการเปลี่ยนแปลงก่อนบันทึกลงดิสก์ หากเพย์โหลดใหม่ไม่ผ่านการตรวจสอบสคีมาหรือดูเหมือนเป็นการเขียนทับแบบทำลายข้อมูล การกำหนดค่าที่ใช้งานอยู่จะไม่ถูกแก้ไข และเพย์โหลดที่ถูกปฏิเสธจะถูกบันทึกไว้ข้างกันในชื่อ openclaw.json.rejected.*

การเขียนที่ OpenClaw เป็นเจ้าของจะแปลง JSON5 เป็น JSON มาตรฐานอีกครั้ง เมื่อแหล่งข้อมูลมีความคิดเห็น ตัวเขียนจะแจ้งเตือนทันทีก่อนนำความคิดเห็นออก หากจำเป็นต้องเก็บความคิดเห็นไว้ ให้ใช้โปรแกรมแก้ไขโดยตรง

ควรใช้การเขียนผ่าน CLI สำหรับการแก้ไขเล็กน้อย:

openclaw config set gateway.reload.mode hybrid --dry-runopenclaw config set gateway.reload.mode hybridopenclaw config validate

หากการเขียนถูกปฏิเสธ ให้ตรวจสอบเพย์โหลดที่บันทึกไว้และแก้ไขรูปแบบการกำหนดค่าทั้งหมด:

CONFIG="$(openclaw config file)"ls -lt "$CONFIG".rejected.* 2>/dev/null | headopenclaw config validate

ยังคงสามารถเขียนด้วยโปรแกรมแก้ไขโดยตรงได้ แต่ Gateway ที่กำลังทำงานจะถือว่าการเขียนดังกล่าวไม่น่าเชื่อถือจนกว่าจะผ่านการตรวจสอบ การแก้ไขโดยตรงที่ไม่ถูกต้องจะทำให้การเริ่มต้นล้มเหลวหรือถูกข้ามระหว่างการโหลดใหม่แบบทันที โดย Gateway จะไม่เขียน openclaw.json ใหม่ เรียกใช้ openclaw doctor --fix เพื่อซ่อมแซมการกำหนดค่าที่มีคำนำหน้า/ถูกเขียนทับ หรือกู้คืนสำเนาล่าสุดที่ทราบว่าใช้งานได้ โปรดดู การแก้ไขปัญหา Gateway

การกู้คืนทั้งไฟล์สงวนไว้สำหรับการซ่อมแซมด้วย doctor การเปลี่ยนแปลงสคีมาของ Plugin หรือความคลาดเคลื่อนของ minHostVersion จะยังคงแสดงข้อผิดพลาดอย่างชัดเจนแทนที่จะย้อนกลับการตั้งค่าผู้ใช้ที่ไม่เกี่ยวข้อง เช่น การกำหนดค่าโมเดล ผู้ให้บริการ โปรไฟล์การยืนยันตัวตน ช่องทาง การเปิดเผย Gateway เครื่องมือ หน่วยความจำ เบราว์เซอร์ หรือ Cron

วงจรการซ่อมแซม

หลังจาก openclaw config validate ผ่านแล้ว ให้ใช้ TUI ภายในเครื่องเพื่อให้เอเจนต์แบบฝังเปรียบเทียบการกำหนดค่าที่ใช้งานอยู่กับเอกสาร ขณะที่คุณตรวจสอบการเปลี่ยนแปลงแต่ละรายการจากเทอร์มินัลเดียวกัน:

openclaw chat

ภายใน TUI เครื่องหมาย ! ที่อยู่ด้านหน้าจะเรียกใช้คำสั่งเชลล์ภายในเครื่องตามตัวอักษร (หลังจากมีพรอมต์ยืนยันหนึ่งครั้งต่อเซสชัน):

!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor

เนื้อหาที่เกี่ยวข้อง

• ข้อมูลอ้างอิง CLI
• การกำหนดค่า