OpenClaw 設定速查表

所有 openclaw config set 指令一覽。基於 OpenClaw v2026.3.23。

---

必備指令

# 啟用/停用 Control UI
openclaw config set gateway.controlUi.enabled true | false

# 重啟 gateway
sudo systemctl restart openclaw

# 查看狀態
openclaw status

# 啟用進階模式（在對話中輸入）
/elevated full

---

1. 身份與 Agent

openclaw config set agents.list[0].identity.name "Nova"
openclaw config set agents.list[0].identity.emoji " "
openclaw config set agents.list[0].identity.theme "helpful assistant"
openclaw config set agents.defaults.model.primary "anthropic/claude-sonnet-4-6"
openclaw config set agents.defaults.model.fallbacks '["minimax/MiniMax-M2.7"]'
openclaw config set agents.defaults.thinkingDefault "high"
openclaw config set agents.defaults.reasoningDefault "on"
openclaw config set agents.defaults.timeoutSeconds 600
openclaw config set agents.defaults.mediaMaxMb 5
openclaw config set agents.defaults.maxConcurrent 3
openclaw config set agents.defaults.userTimezone "Asia/Taipei"  # 依你的時區調整
openclaw config set agents.defaults.timeFormat "auto"
openclaw config set agents.defaults.heartbeat.every "30m"
openclaw config set agents.defaults.heartbeat.target "last"
openclaw config set agents.defaults.workspace "~/.openclaw/workspace"

---

2. WhatsApp

openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.dmPolicy "pairing|allowlist|open|disabled"
openclaw config set channels.whatsapp.allowFrom '["+886XXXXXXXXX"]'  # 台灣國碼 +886
openclaw config set channels.whatsapp.groupPolicy "allowlist|open|disabled"
openclaw config set channels.whatsapp.groups."*".requireMention true
openclaw config set channels.whatsapp.mediaMaxMb 50
openclaw config set channels.whatsapp.sendReadReceipts true

---

3. Telegram

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.botToken "BOT_TOKEN"
openclaw config set channels.telegram.dmPolicy "pairing|allowlist|open|disabled"
openclaw config set channels.telegram.allowFrom '["tg:123456789"]'
openclaw config set channels.telegram.groups."*".requireMention true
openclaw config set channels.telegram.historyLimit 50
openclaw config set channels.telegram.streaming "off|partial|block|progress"
openclaw config set channels.telegram.linkPreview true

---

4. Discord

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.token "BOT_TOKEN"
openclaw config set channels.discord.dmPolicy "pairing|allowlist|open|disabled"
openclaw config set channels.discord.allowFrom '["123456789"]'
openclaw config set channels.discord.groupPolicy "open|allowlist|disabled"
openclaw config set channels.discord.dm.enabled true
openclaw config set channels.discord.historyLimit 20
openclaw config set channels.discord.streaming "off|partial|block|progress"
openclaw config set channels.discord.maxLinesPerMessage 17
openclaw config set channels.discord.ui.components.accentColor "#5865F2"

---

5. Slack

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.botToken "xoxb-..."
openclaw config set channels.slack.appToken "xapp-..."
openclaw config set channels.slack.dmPolicy "pairing|allowlist|open|disabled"
openclaw config set channels.slack.dm.enabled true
openclaw config set channels.slack.slashCommand.enabled true
openclaw config set channels.slack.slashCommand.name "openclaw"
openclaw config set channels.slack.typingReaction "hourglass_flowing_sand"
openclaw config set channels.slack.historyLimit 50

---

6. Signal

openclaw config set channels.signal.enabled true
openclaw config set channels.signal.account "+15555550123"
openclaw config set channels.signal.dmPolicy "pairing|allowlist|open|disabled"
openclaw config set channels.signal.allowFrom '["+15551234567"]'
openclaw config set channels.signal.reactionNotifications "off|own|all|allowlist"

---

7. Google Chat

openclaw config set channels.googlechat.enabled true
openclaw config set channels.googlechat.serviceAccountFile "/path/to.json"
openclaw config set channels.googlechat.webhookPath "/googlechat"
openclaw config set channels.googlechat.dm.policy "pairing|allowlist|open|disabled"

---

8. IRC

openclaw config set channels.irc.enabled true
openclaw config set channels.irc.dmPolicy "pairing|allowlist|open|disabled"
openclaw config set channels.irc.nickserv.enabled true
openclaw config set channels.irc.nickserv.password "${IRC_NICKSERV_PASSWORD}"

---

9. iMessage

openclaw config set channels.imessage.enabled true
openclaw config set channels.imessage.cliPath "imsg"
openclaw config set channels.imessage.dmPolicy "pairing|allowlist|open|disabled"
openclaw config set channels.imessage.allowFrom '["+15555550123"]'
openclaw config set channels.imessage.historyLimit 50
openclaw config set channels.imessage.includeAttachments false

---

10. Gateway 與網路

openclaw config set gateway.controlUi.enabled true|false
openclaw config set gateway.controlUi.basePath "/openclaw"
openclaw config set gateway.controlUi.allowedOrigins '["https://domain.com"]'
openclaw config set gateway.port 18789
openclaw config set gateway.bind "loopback|lan|tailnet|auto|custom"
openclaw config set gateway.auth.mode "none|token|password|trusted-proxy"
openclaw config set gateway.auth.token "your-token"
openclaw config set gateway.auth.password "your-password"
openclaw config set gateway.auth.allowTailscale true|false
openclaw config set gateway.auth.rateLimit.maxAttempts 10
openclaw config set gateway.auth.rateLimit.windowMs 60000
openclaw config set gateway.tailscale.mode "off|serve|funnel"
openclaw config set gateway.trustedProxies '["10.0.0.1"]'
openclaw config set gateway.allowRealIpFallback false
openclaw config set gateway.channelHealthCheckMinutes 5
openclaw config set gateway.channelStaleEventThresholdMinutes 30
openclaw config set gateway.channelMaxRestartsPerHour 10

---

11. 安全與存取控制

openclaw config set tools.elevated.enabled true
openclaw config set tools.elevated.allowFrom.whatsapp '["+15555550123"]'
openclaw config set tools.elevated.allowFrom.telegram '["123456789"]'
openclaw config set tools.elevated.allowFrom.discord '["123456789012345678"]'
openclaw config set tools.elevated.allowFrom.webchat '["session:name"]'
openclaw config set tools.profile "minimal|coding|messaging|full"
openclaw config set tools.deny '["browser", "canvas"]'
openclaw config set tools.allow '["exec", "process", "read", "write"]'
openclaw config set tools.exec.backgroundMs 10000
openclaw config set tools.exec.timeoutSec 1800
openclaw config set tools.exec.cleanupMs 1800000
openclaw config set tools.loopDetection.enabled true|false
openclaw config set tools.loopDetection.warningThreshold 10
openclaw config set tools.loopDetection.criticalThreshold 20
openclaw config set tools.sessions.visibility "self|tree|agent|all"
openclaw config set tools.agentToAgent.enabled false

---

12. 訊息與格式

openclaw config set messages.responsePrefix " "
openclaw config set messages.ackReaction "👀"
openclaw config set messages.ackReactionScope "group-mentions|group-all|direct|all"
openclaw config set messages.removeAckAfterReply false
openclaw config set messages.queue.mode "steer|followup|collect|steer-backlog|queue|interrupt"
openclaw config set messages.queue.debounceMs 1000
openclaw config set messages.queue.cap 20
openclaw config set messages.queue.drop "old|new|summarize"
openclaw config set messages.inbound.debounceMs 2000
openclaw config set messages.groupChat.historyLimit 50

---

13. Session 管理

openclaw config set session.scope "per-sender"
openclaw config set session.dmScope "main|per-peer|per-channel-peer|per-account-channel-peer"
openclaw config set session.reset.mode "daily|idle"
openclaw config set session.reset.atHour 4
openclaw config set session.reset.idleMinutes 60
openclaw config set session.resetTriggers '["/new", "/reset"]'
openclaw config set session.store "~/.openclaw/agents/{agentId}/sessions/sessions.json"
openclaw config set session.maintenance.mode "warn|enforce"
openclaw config set session.maintenance.pruneAfter "30d"
openclaw config set session.maintenance.maxEntries 500
openclaw config set session.maintenance.maxDiskBytes "500mb"
openclaw config set session.threadBindings.enabled true
openclaw config set session.threadBindings.idleHours 24
openclaw config set session.sendPolicy.default "allow|deny"

---

14. Agent 執行時

openclaw config set agents.defaults.thinkingDefault "high|xhigh|medium|low|minimal|off|adaptive"
openclaw config set agents.defaults.reasoningDefault "on|off|stream"
openclaw config set agents.defaults.fastModeDefault false|true
openclaw config set agents.defaults.timeoutSeconds 600
openclaw config set agents.defaults.contextTokens 200000
openclaw config set agents.defaults.maxConcurrent 3
openclaw config set agents.defaults.model.primary "provider/model"
openclaw config set agents.defaults.model.fallbacks '["model1", "model2"]'
openclaw config set agents.defaults.imageModel.primary "provider/model"
openclaw config set agents.defaults.pdfModel.primary "provider/model"
openclaw config set agents.defaults.imageMaxDimensionPx 1200
openclaw config set agents.defaults.contextPruning.mode "off|cache-ttl"
openclaw config set agents.defaults.contextPruning.ttl "1h"
openclaw config set agents.defaults.contextPruning.keepLastAssistants 3
openclaw config set agents.defaults.compaction.mode "default|safeguard"
openclaw config set agents.defaults.compaction.timeoutSeconds 900
openclaw config set agents.defaults.compaction.memoryFlush.enabled true

---

15. 沙盒

openclaw config set agents.defaults.sandbox.mode "off|non-main|all"
openclaw config set agents.defaults.sandbox.backend "docker|ssh|openshell"
openclaw config set agents.defaults.sandbox.scope "session|agent|shared"
openclaw config set agents.defaults.sandbox.workspaceAccess "none|ro|rw"
openclaw config set agents.defaults.sandbox.workspaceRoot "~/.openclaw/sandboxes"
openclaw config set agents.defaults.sandbox.docker.image "openclaw-sandbox:bookworm-slim"
openclaw config set agents.defaults.sandbox.docker.memory "1g"
openclaw config set agents.defaults.sandbox.docker.cpus 1
openclaw config set agents.defaults.sandbox.docker.network "none|bridge"
openclaw config set agents.defaults.sandbox.browser.enabled false
openclaw config set agents.defaults.sandbox.prune.idleHours 24
openclaw config set agents.defaults.sandbox.prune.maxAgeDays 7

---

16. 工具設定

openclaw config set tools.web.search.enabled true
openclaw config set tools.web.search.apiKey "BRAVE_API_KEY"
openclaw config set tools.web.search.maxResults 5
openclaw config set tools.web.search.timeoutSeconds 30
openclaw config set tools.web.fetch.enabled true
openclaw config set tools.web.fetch.maxChars 50000
openclaw config set tools.web.fetch.timeoutSeconds 30
openclaw config set tools.media.audio.enabled true
openclaw config set tools.media.audio.maxBytes 20971520
openclaw config set tools.media.video.enabled true
openclaw config set tools.media.video.maxBytes 52428800
openclaw config set tools.media.concurrency 2

---

17. 瀏覽器

openclaw config set browser.enabled true|false
openclaw config set browser.evaluateEnabled true|false
openclaw config set browser.defaultProfile "user|openclaw|work"
openclaw config set browser.ssrfPolicy.dangerouslyAllowPrivateNetwork true|false
openclaw config set browser.extraArgs '["--disable-gpu"]'
openclaw config set browser.headless false|true
openclaw config set browser.noSandbox false|true
openclaw config set browser.color "#FF4500"

---

18. Skills 與 Plugins

openclaw config set skills.allowBundled '["gemini", "peekaboo"]'
openclaw config set skills.load.extraDirs '["~/path/to/skills"]'
openclaw config set skills.install.nodeManager "npm|pnpm|yarn"
openclaw config set skills.install.preferBrew true
openclaw config set skills.entries.skill-name.enabled true|false
openclaw config set plugins.enabled true|false
openclaw config set plugins.allow '["voice-call"]'
openclaw config set plugins.load.paths '["~/path/to/plugins"]'
openclaw config set plugins.slots.memory "memory-core|none"

---

19. Cron 排程

openclaw config set cron.enabled true
openclaw config set cron.maxConcurrentRuns 2
openclaw config set cron.sessionRetention "24h|false"
openclaw config set cron.webhookToken "token"
openclaw config set cron.runLog.maxBytes "2mb"
openclaw config set cron.runLog.keepLines 2000

---

20. Logging

openclaw config set logging.level "debug|info|warn|error"
openclaw config set logging.file "/path/to/log"
openclaw config set logging.consoleLevel "debug|info|warn|error"
openclaw config set logging.consoleStyle "pretty|compact|json"
openclaw config set logging.redactSensitive "off|tools"

---

21. TTS 語音合成

openclaw config set messages.tts.auto "off|always|inbound|tagged"
openclaw config set messages.tts.mode "final|all"
openclaw config set messages.tts.provider "elevenlabs|openai"
openclaw config set messages.tts.elevenlabs.apiKey "KEY"
openclaw config set messages.tts.elevenlabs.voiceId "voice_id"
openclaw config set messages.tts.openai.voice "alloy|echo|..."
openclaw config set messages.tts.maxTextLength 4000
openclaw config set messages.tts.timeoutMs 30000
openclaw config set messages.tts.summaryModel "openai/gpt-4.1-mini"

---

22. Talk Mode 語音模式

openclaw config set talk.voiceId "elevenlabs_voice_id"
openclaw config set talk.modelId "eleven_v3"
openclaw config set talk.outputFormat "mp3_44100_128"
openclaw config set talk.apiKey "KEY"
openclaw config set talk.silenceTimeoutMs 1500
openclaw config set talk.interruptOnSpeech true|false

---

23. Discovery

openclaw config set discovery.mdns.mode "off|minimal|full"
openclaw config set discovery.wideArea.enabled true|false

---

24. Canvas

openclaw config set canvasHost.root "~/path/to/canvas"
openclaw config set canvasHost.liveReload true|false
openclaw config set canvasHost.enabled true|false

---

25. Memory 與 Compaction

openclaw config set agents.defaults.memorySearch.enabled true
openclaw config set agents.defaults.memorySearch.provider "openai|gemini"
openclaw config set agents.defaults.memorySearch.model "text-embedding-3-large"
openclaw config set agents.defaults.compaction.mode "default|safeguard"
openclaw config set agents.defaults.compaction.memoryFlush.enabled true

---

26. Block Streaming 與 Human Delay

openclaw config set agents.defaults.blockStreamingDefault "on|off"
openclaw config set agents.defaults.blockStreamingBreak "text_end|message_end"
openclaw config set agents.defaults.blockStreamingChunk.minChars 800
openclaw config set agents.defaults.blockStreamingChunk.maxChars 1200
openclaw config set agents.defaults.humanDelay.mode "off|natural|custom"
openclaw config set agents.defaults.typingMode "never|instant|thinking|message"
openclaw config set agents.defaults.typingIntervalSeconds 6

---

27. Commands

openclaw config set commands.native "auto|true|false"
openclaw config set commands.text true|false
openclaw config set commands.bash true|false
openclaw config set commands.config true|false
openclaw config set commands.restart true|false
openclaw config set commands.debug true|false
openclaw config set commands.bashForegroundMs 2000

---

28. Subagents

openclaw config set agents.defaults.subagents.model "model"
openclaw config set agents.defaults.subagents.maxConcurrent 1
openclaw config set agents.defaults.subagents.runTimeoutSeconds 900
openclaw config set agents.defaults.subagents.archiveAfterMinutes 60

---

29. 頻道模型覆蓋

openclaw config set channels.modelByChannel.discord '{"123456": "anthropic/claude-opus-4-6"}'
openclaw config set channels.modelByChannel.telegram '{"-100123": "openai/gpt-4.1-mini"}'
openclaw config set channels.modelByChannel.slack '{"C123": "openai/gpt-4.1"}'

---

30. 頻道預設值

openclaw config set channels.defaults.groupPolicy "allowlist|open|disabled"
openclaw config set channels.defaults.heartbeat.showOk true|false
openclaw config set channels.defaults.heartbeat.showAlerts true|false
openclaw config set channels.defaults.heartbeat.useIndicator true|false

---

31. Auth Profiles

openclaw config set models.mode "merge|replace"
openclaw config set auth.profiles '"provider:id": {"provider": "...", "mode": "..."}'
openclaw config set auth.order '{"anthropic": ["id1", "id2"]}'

---

32. 環境變數與密鑰

openclaw config set env.OPENROUTER_API_KEY "sk-or-..."
openclaw config set env.vars.VAR_NAME "value"
openclaw config set env.shellEnv.enabled true
openclaw config set env.shellEnv.timeoutMs 15000

---

33. CLI 設定

openclaw config set cli.banner.taglineMode "random|default|off"

---

34. Node 設定

openclaw config set gateway.nodes.denyCommands '["camera.snap", "screen.record"]'

---

35. Webhooks

openclaw config set hooks.enabled true
openclaw config set hooks.token "shared-secret"
openclaw config set hooks.path "/hooks"
openclaw config set hooks.maxBodyBytes 262144
openclaw config set hooks.allowRequestSessionKey true|false
openclaw config set hooks.allowedAgentIds '["hooks", "main"]'
openclaw config set hooks.allowedSessionKeyPrefixes '["hook:"]'

---

基於 OpenClaw v2026.3.23。原始資料由 Adarsh Sojitra（ServerAvatar.com）整理。