​

help/faq.md

​

目錄

• [快速開始與首次執行設定]
  • 我卡住了，最快脫困的方法是什麼？
  • 安裝與設定 OpenClaw 的建議方式是什麼？
  • 完成入門引導後，如何開啟儀表板？
  • 在 localhost 與遠端時，如何驗證儀表板（權杖）？
  • 需要什麼執行環境？
  • 可以在 Raspberry Pi 上執行嗎？
  • Raspberry Pi 安裝有什麼建議？
  • [It is stuck on “wake up my friend” / onboarding will not hatch. 19. 我無法存取 docs.openclaw.ai（SSL 錯誤）。 20. 接下來該怎麼做？
  • 可以在不重做入門引導的情況下，遷移到新機器（Mac mini）嗎？
  • 在哪裡查看最新版本的新內容？
  • I can’t access docs.openclaw.ai (SSL error). 現在該怎麼辦？
  • stable 與 beta 的差異是什麼？
  • 如何安裝 beta 版？beta 與 dev 有何不同？
  • 如何試用最新版本？
  • 安裝與入門引導通常需要多久？
  • 安裝程式卡住？ How do I get more feedback?
  • Windows 安裝顯示找不到 git 或無法辨識 openclaw
  • 文件沒有回答我的問題，如何取得更好的答案？
  • 如何在 Linux 上安裝 OpenClaw？
  • 如何在 VPS 上安裝 OpenClaw？
  • 雲端 / VPS 安裝指南在哪裡？
  • 可以請 OpenClaw 自行更新嗎？
  • 入門引導精靈實際上做了什麼？
  • 需要 Claude 或 OpenAI 的訂閱才能執行嗎？
  • 可以在沒有 API 金鑰的情況下使用 Claude Max 訂閱嗎
  • Anthropic 的「setup-token」驗證如何運作？
  • 在哪裡取得 Anthropic setup-token？
  • 是否支援 Claude 訂閱驗證（Claude Pro 或 Max）？
  • 為什麼我會看到來自 Anthropic 的 HTTP 429: rate_limit_error？
  • 是否支援 AWS Bedrock？
  • Codex 驗證如何運作？
  • 是否支援 OpenAI 訂閱驗證（Codex OAuth）？
  • 如何設定 Gemini CLI OAuth
  • 本機模型適合輕鬆聊天嗎？
  • 如何讓託管模型流量留在特定區域？
  • 一定要買 Mac Mini 才能安裝嗎？
  • iMessage 支援一定需要 Mac mini 嗎？
  • 如果我買 Mac mini 來執行 OpenClaw，可以連接我的 MacBook Pro 嗎？
  • 可以使用 Bun 嗎？
  • Telegram：allowFrom 要填什麼？
  • 是否可以讓多人使用同一個 WhatsApp 號碼搭配不同的 OpenClaw 實例？
  • 可以同時執行「快速聊天」代理與「用 Opus 進行程式開發」的代理嗎？
  • Homebrew 可以在 Linux 上運作嗎？
  • hackable（git）安裝與 npm 安裝有什麼不同？
  • 之後可以在 npm 與 git 安裝之間切換嗎？
  • 應該在筆電或 VPS 上執行 Gateway 閘道器？
  • 在專用機器上執行 OpenClaw 有多重要？
  • VPS 的最低需求與建議的作業系統是什麼？
  • 可以在 VM 中執行 OpenClaw 嗎？需求是什麼？
• 什麼是 OpenClaw？
  • 用一段話介紹 OpenClaw
  • 價值主張是什麼？
  • 剛設定好，第一步該做什麼？
  • OpenClaw 的五大日常使用情境是什麼？
  • OpenClaw 能協助 SaaS 的潛在客戶開發、廣告與部落格嗎？
  • 與 Claude Code 相比，做網頁開發的優勢是什麼？
• Skills 與自動化
  • How do I customize skills without keeping the repo dirty?
  • Can I load skills from a custom folder?
  • 我如何為不同任務使用不同模型？
  • The bot freezes while doing heavy work. How do I offload that?
  • Cron 或提醒未觸發。 我該檢查什麼？
  • 35. 是否有專門的沙箱文件？
  • OpenClaw 可以排程或在背景中持續執行任務嗎？
  • 我可以在 Linux 上執行僅限 Apple macOS 的技能嗎？
  • 是否有 Notion 或 HeyGen 的整合？
  • How do I install the Chrome extension for browser takeover?
• 沙箱與記憶
  • Is there a dedicated sandboxing doc?
  • How do I bind a host folder into the sandbox?
  • 記憶體是如何運作的？
  • 記憶體一直忘記事情。 我該如何讓它記住？
  • 記憶體會永久保存嗎？ 限制是什麼？
  • 語意記憶搜尋需要 OpenAI API 金鑰嗎？
• 磁碟上的資料位置
  • 3. 所有在 OpenClaw 中使用的資料都是本機儲存嗎？
  • Where does OpenClaw store its data?
  • AGENTS.md / SOUL.md / USER.md / MEMORY.md 應該放在哪裡？
  • 建議的備份策略是什麼？
  • 如何完全解除安裝 OpenClaw？
  • 代理可以在工作區之外運作嗎？
  • 我在遠端模式中——工作階段儲存在哪裡？
• 設定基礎
  • 設定檔是什麼格式？在哪裡？ 我設定了 gateway.bind: "lan"（或 "tailnet"），現在卻沒有任何服務在監聽／UI 顯示未授權
  • 為什麼現在在 localhost 也需要權杖（token）？
  • 修改設定後需要重新啟動嗎？
  • 如何啟用網頁搜尋（以及網頁抓取）？
  • config.apply 把我的設定清空了。我要如何復原並避免再次發生？
  • 如何在多個裝置上執行一個中央 Gateway，並搭配專用的工作節點？ OpenClaw 瀏覽器可以以無頭（headless）模式執行嗎？
  • 如何使用 Brave 來進行瀏覽器控制？
  • 指令是如何在 Telegram、Gateway 與節點之間傳遞的？
  • How do I use Brave for browser control?
• 遠端 Gateway 閘道器與節點
  • Tailscale 已連線，但我沒有收到任何回應。接下來該怎麼辦？
  • 兩個 OpenClaw 實例可以彼此通訊嗎（本地 + VPS）？
  • 多個代理需要各自獨立的 VPS 嗎？ 在個人筆電上執行一個節點，相較於從 VPS 透過 SSH，有什麼好處嗎？
  • 節點會執行 Gateway 服務嗎？
  • Do I need separate VPSes for multiple agents
  • 29. 第一次安裝時，有沒有一個最小但「合理」的設定範例？
  • 30. 我要如何在 VPS 上設定 Tailscale，並從我的 Mac 連線？
  • 如何將 Mac 節點連接到遠端 Gateway（Tailscale Serve）？
  • 我應該在第二台筆電上安裝，還是只新增一個節點？
  • OpenClaw 是如何載入環境變數的？
  • 「我透過服務啟動了 Gateway，結果環境變數不見了。」現在該怎麼辦？
  • 36. [我設定了 COPILOT_GITHUB_TOKEN，但模型狀態顯示「Shell env: off」。
    37. 為什麼？](#i-set-copilotgithubtoken-but-models-status-shows-shell-env-off-why)
• 環境變數與 .env 載入
  • OpenClaw 是如何載入環境變數的？
  • 「我透過服務啟動了 Gateway，但我的環境變數消失了。」 7. 現在該怎麼辦？ 是否有辦法讓一組 OpenClaw 實例形成「一個 CEO、多個代理」的架構？
  • 為什麼在任務進行到一半時脈絡被截斷？我要如何避免？ 如何在保留安裝的情況下，完全重置 OpenClaw？
• 工作階段與多重聊天
  • 我遇到「context too large」錯誤——要如何重置或壓縮？
  • 為什麼我會看到「LLM request rejected: messages.N.content.X.tool_use.input: Field required」？
  • 為什麼我每 30 分鐘會收到一次心跳訊息？
  • 我需要把「機器人帳號」加入 WhatsApp 群組嗎？ 如何取得 WhatsApp 群組的 JID？
  • 為什麼我每 30 分鐘會收到一次心跳訊息？
  • 我需要把一個「機器人帳號」加入 WhatsApp 群組嗎？
  • 我可以建立多少個工作區與代理？
  • 為什麼 OpenClaw 在群組中不回覆？
  • 群組／執行緒會和私訊共享上下文嗎？
  • 你建議使用哪個模型？
  • 我可以同時執行多個機器人或聊天（Slack）嗎？以及該如何設定？
  • Do groups/threads share context with DMs?
  • 你推薦使用什麼模型？
  • 我要如何在不清除設定的情況下切換模型？
• 模型：預設、選擇、別名與切換
  • 我可以使用自架模型（llama.cpp、vLLM、Ollama）嗎？
  • What model do you recommend?
  • How do I switch models without wiping my config?
  • 我可以在日常任務中使用 GPT 5.2，在程式開發時使用 Codex 5.3 嗎？
  • 3. OpenClaw、Flawd 與 Krill 使用的是哪些模型？
  • 4. 如何在執行中即時切換模型（不需重新啟動）？
  • 我可以把 MiniMax 作為預設，並在複雜任務時使用 OpenAI 嗎？
  • 6. 為什麼我會看到「Model … is not allowed” and then no reply?
  • 我要如何新增來自其他供應商（如 OpenRouter 或 Z.AI）的模型？
  • Can I use MiniMax as my default and OpenAI for complex tasks?
  • 這個錯誤代表什麼意思？
  • 修復清單：No credentials found for profile "anthropic:default"
  • How do I add models from other providers like OpenRouter or Z.AI?
• 模型容錯與「All models failed」
  • 什麼是驗證設定檔（auth profile）？
  • 常見的設定檔 ID 有哪些？
  • Fix checklist for No credentials found for profile "anthropic:default"
  • Why did it also try Google Gemini and fail?
• 驗證設定檔：是什麼以及如何管理
  • Gateway 使用的是哪個連接埠？
  • 為什麼 openclaw gateway status 顯示 Runtime: running，但 RPC probe: failed？
  • Can I control which auth profile is tried first?
  • 20. OAuth 與 API 金鑰：有什麼差別？
• Gateway：連接埠、「already running」與遠端模式
  • 21. Gateway 使用的是哪個連接埠？
  • Why does openclaw gateway status say Runtime: running but RPC probe: failed?
  • 23. 為什麼 openclaw gateway status 會顯示 Config (cli) 與 Config (service) 不一致？
  • What does “another gateway instance is already listening” mean?
  • How do I run OpenClaw in remote mode (client connects to a Gateway elsewhere)?
  • The Control UI says “unauthorized” (or keeps reconnecting). 27. 接下來該怎麼辦？
  • 2. 我設定了 gateway.bind: "tailnet"，但無法綁定／沒有任何服務在監聽
  • 29. 我可以在同一台主機上執行多個 Gateway 嗎？
  • 4. 「invalid handshake」／代碼 1008 是什麼意思？
• 記錄與除錯
  • 5. 日誌在哪裡？
  • 6. 我要如何啟動／停止／重新啟動 Gateway 服務？
  • 7. 我在 Windows 上關閉了終端機——要如何重新啟動 OpenClaw？
  • 8. Gateway 已啟動，但回覆一直沒有到達。 9. 我該檢查什麼？
  • 10. 「Disconnected from gateway: no reason」——現在怎麼辦？
  • 11. Telegram 的 setMyCommands 因網路錯誤而失敗。 38. 我應該檢查什麼？
  • 13. TUI 沒有顯示任何輸出。 14. 我該檢查什麼？
  • 15. 我要如何完全停止後再啟動 Gateway？
  • 16. ELI5：openclaw gateway restart 與 openclaw gateway
  • 17. 當發生失敗時，取得更多細節的最快方式是什麼？
• 媒體與附件
  • 44. 我的技能產生了圖片／PDF，但沒有任何內容被送出
• 安全性與存取控制
  • 45. 將 OpenClaw 暴露給外部私訊是否安全？
  • 20. 提示注入只會是公開機器人的問題嗎？
  • 47. 我的機器人是否應該有自己的電子郵件、GitHub 帳號或電話號碼
  • 48. 我可以讓它自主處理我的簡訊嗎？這樣安全嗎
  • 49. 我可以在個人助理任務中使用較便宜的模型嗎？
  • 24. 我在 Telegram 執行了 /start，但沒有收到配對碼
  • 25. WhatsApp：它會傳訊給我的聯絡人嗎？ How does pairing work?
• 聊天指令、終止任務與「停不下來」
  • 27. 我要如何阻止內部系統訊息顯示在聊天中
  • How do I stop/cancel a running task?
  • 29. 我要如何從 Telegram 傳送 Discord 訊息？ (“Cross-context messaging denied”)
  • 31. 為什麼感覺機器人會「忽略」連續快速傳送的訊息？

​

32. 若有問題時的前 60 秒

1. Quick status (first check)
   openclaw status
   
   34. 快速本機摘要：OS 與更新、gateway／服務可達性、agents／sessions、供應商設定與執行期問題（當 gateway 可達時）。
2. Pasteable report (safe to share)
   openclaw status --all
   
   37. 含日誌尾端的唯讀診斷（權杖已遮蔽）。
3. 38. Daemon 與連接埠狀態
   openclaw gateway status
   
   39. 顯示監督器的執行期與 RPC 可達性、探測目標 URL，以及服務可能使用的設定。
4. 40. 深度探測
   openclaw status --deep
   
   Runs gateway health checks + provider probes (requires a reachable gateway). See Health.
5. Tail the latest log
   openclaw logs --follow
   
   If RPC is down, fall back to:
   tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
   
   File logs are separate from service logs; see Logging and Troubleshooting.
6. Run the doctor (repairs)
   openclaw doctor
   
   修復/遷移設定與狀態，並執行健康檢查。 See Doctor.
7. Gateway snapshot
   openclaw health --json
   openclaw health --verbose   # shows the target URL + config path on errors
   
   Asks the running gateway for a full snapshot (WS-only). See Health.

​

快速開始與首次執行設定

​

Im stuck whats the fastest way to get unstuck

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

openclaw status
openclaw models status
openclaw doctor

• openclaw status: quick snapshot of gateway/agent health + basic config.
• openclaw models status: checks provider auth + model availability.
• openclaw doctor: validates and repairs common config/state issues.

​

What’s the recommended way to install and set up OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw onboard

​

How do I open the dashboard after onboarding

​

How do I authenticate the dashboard token on localhost vs remote

• Open http://127.0.0.1:18789/.
• If it asks for auth, paste the token from gateway.auth.token (or OPENCLAW_GATEWAY_TOKEN) into Control UI settings.
• 從 gateway 主機取得：openclaw config get gateway.auth.token（或產生一個：openclaw doctor --generate-gateway-token）。

• Tailscale Serve (recommended): keep bind loopback, run openclaw gateway --tailscale serve, open https://<magicdns>/. 如果 gateway.auth.allowTailscale 為 true，身分識別標頭即可滿足驗證（不需要權杖）。
• Tailnet bind: run openclaw gateway --bind tailnet --token "<token>", open http://<tailscale-ip>:18789/, paste token in dashboard settings.
• SSH tunnel: ssh -N -L 18789:127.0.0.1:18789 user@host then open http://127.0.0.1:18789/ and paste the token in Control UI settings.

​

What runtime do I need

​

它能在 Raspberry Pi 上執行嗎

​

Any tips for Raspberry Pi installs

• Use a 64-bit OS and keep Node >= 22.
• Prefer the hackable (git) install so you can see logs and update fast.
• Start without channels/skills, then add them one by one.
• If you hit weird binary issues, it is usually an ARM compatibility problem.

​

卡在「wake up my friend」/ 入門引導無法孵化，該怎麼辦？

1. Restart the Gateway:

openclaw gateway restart

2. Check status + auth:

openclaw status
openclaw models status
openclaw logs --follow

3. If it still hangs, run:

openclaw doctor

​

Can I migrate my setup to a new machine Mac mini without redoing onboarding

1. Install OpenClaw on the new machine.
2. Copy $OPENCLAW_STATE_DIR (default: ~/.openclaw) from the old machine.
3. Copy your workspace (default: ~/.openclaw/workspace).
4. Run openclaw doctor and restart the Gateway service.

​

Where do I see what is new in the latest version

​

無法存取 docs.openclaw.ai（SSL 錯誤），該怎麼辦？

​

What’s the difference between stable and beta

• latest = stable
• beta = early build for testing

​

How do I install the beta version and whats the difference between beta and dev

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

​

How long does install and onboarding usually take

• Install: 2-5 minutes
• Onboarding: 5-15 minutes depending on how many channels/models you configure

​

How do I try the latest bits

1. Dev channel (git checkout):

openclaw update --channel dev

2. Hackable install (from the installer site):

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

​

安裝程式卡住了？如何取得更多回饋？

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

​

Windows install says git not found or openclaw not recognized

• Install Git for Windows and make sure git is on your PATH.
• Close and reopen PowerShell, then re-run the installer.

• Your npm global bin folder is not on PATH.
• Check the path:
  npm config get prefix
  
• Ensure <prefix>\\bin is on PATH (on most systems it is %AppData%\\npm).
• Close and reopen PowerShell after updating PATH.

​

The docs didnt answer my question how do I get a better answer

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

​

How do I install OpenClaw on Linux

• Linux quick path + service install: Linux.
• Full walkthrough: Getting Started.
• Installer + updates: Install & updates.

​

How do I install OpenClaw on a VPS

​

Where are the cloudVPS install guides

• VPS hosting (all providers in one place)
• Fly.io
• Hetzner
• exe.dev

18. Hub：Platforms。 Remote access: Gateway remote. Nodes: Nodes, Nodes CLI.

​

Can I ask OpenClaw to update itself

22. 簡短回答：可以，但不建議。 The update flow can restart the Gateway (which drops the active session), may need a clean git checkout, and can prompt for confirmation. Safer: run updates from a shell as the operator.
23. 使用 CLI：

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart

openclaw update --yes --no-restart
openclaw gateway restart

​

What does the onboarding wizard actually do

• 33. 模型／驗證設定（Claude 訂閱建議使用 Anthropic setup-token，支援 OpenAI Codex OAuth，API 金鑰為選用，支援 LM Studio 本機模型）
• Workspace location + bootstrap files
• Gateway settings (bind/port/auth/tailscale)
• 36. Providers（WhatsApp、Telegram、Discord、Mattermost（外掛）、Signal、iMessage）
• 37. 常駐程式安裝（macOS 為 LaunchAgent；Linux/WSL2 為 systemd 使用者單元）
• 38. 健康檢查 與 skills 選擇

​

Do I need a Claude or OpenAI subscription to run this

​

Can I use Claude Max subscription without an API key

​

How does Anthropic setuptoken auth work

15. claude setup-token 會透過 Claude Code CLI 產生一個 權杖字串（它不在網頁主控台中提供）。 16. 你可以在 任何機器 上執行它。 Choose Anthropic token (paste setup-token) in the wizard or paste it with openclaw models auth paste-token --provider anthropic. 18. 該權杖會以 anthropic 供應商的驗證設定檔儲存，並像 API 金鑰一樣使用（不會自動重新整理）。 More detail: OAuth.

​

Where do I find an Anthropic setuptoken

claude setup-token

​

Do you support Claude subscription auth (Claude Pro or Max)

32. 注意：Claude 訂閱存取受 Anthropic 條款所規範。 For production or multi-user workloads, API keys are usually the safer choice.

​

34. 為什麼我會看到來自 Anthropic 的 HTTP 429 ratelimiterror

35. 這表示你在目前時間窗口內的 Anthropic 配額／速率限制 已用盡。 If you use a Claude subscription (setup-token or Claude Code OAuth), wait for the window to reset or upgrade your plan. If you use an Anthropic API key, check the Anthropic Console for usage/billing and raise limits as needed.

​

Is AWS Bedrock supported

41. 是的 —— 透過 pi-ai 的 Amazon Bedrock（Converse） 供應商，並使用 手動設定。 You must supply AWS credentials/region on the gateway host and add a Bedrock provider entry in your models config. 43. 請參閱 Amazon Bedrock 與 Model providers。 44. 如果你偏好受管理的金鑰流程，在 Bedrock 前方使用 OpenAI 相容的代理仍然是可行的選項。

​

Codex 的驗證是如何運作的

​

Do you support OpenAI subscription auth Codex OAuth

​

How do I set up Gemini CLI OAuth

11. 步驟：
12. 6. 啟用外掛：openclaw plugins enable google-gemini-cli-auth
13. 登入：openclaw models auth login --provider google-gemini-cli --set-default

​

Is a local model OK for casual chats

16. 通常不適合。 OpenClaw needs large context + strong safety; small cards truncate and leak. If you must, run the largest MiniMax M2.1 build you can locally (LM Studio) and see /gateway/local-models. Smaller/quantized models increase prompt-injection risk - see Security.

​

How do I keep hosted model traffic in a specific region

21. 選擇區域鎖定的端點。 16. OpenRouter 提供 MiniMax、Kimi 與 GLM 的美國託管選項；選擇美國託管的變體即可讓資料留在該地區。 23. 你仍可透過設定 models.mode: "merge" 同時列出 Anthropic/OpenAI，讓備援模型可用，同時遵守你選擇的區域化供應商。

​

4. 我一定要買一台 Mac Mini 才能安裝這個嗎

7. 只有在需要 僅限 macOS 的工具 時，你才需要一台 Mac。 28. iMessage 請使用 BlueBubbles（推薦）——BlueBubbles 伺服器在任何 Mac 上執行，而 Gateway 可在 Linux 或其他地方執行。 如果你需要其他僅限 macOS 的工具，請在 Mac 上執行 Gateway，或配對一個 macOS 節點。
8. 文件：BlueBubbles、Nodes、Mac remote mode。

​

25. 我需要 Mac mini 才能支援 iMessage 嗎

12. 你需要 某一台已登入 Messages 的 macOS 裝置。 27. 它 不一定 要是 Mac mini——任何 Mac 都可以。 28. 使用 BlueBubbles（推薦）來支援 iMessage——BlueBubbles 伺服器在 macOS 上執行，而 Gateway 可在 Linux 或其他地方執行。
13. 常見架構：

• 30. 在 Linux/VPS 上執行 Gateway，並在任何已登入 Messages 的 Mac 上執行 BlueBubbles 伺服器。
• 17. 如果你想要最簡單的單機設定，也可以把所有東西都跑在同一台 Mac 上。

32. 文件：BlueBubbles、Nodes、 Mac remote mode。

​

33. 如果我買 Mac mini 來執行 OpenClaw，可以連接到我的 MacBook Pro 嗎

22. 常見模式：

• 37. Gateway 跑在 Mac mini（全天候運作）。
• 24. MacBook Pro 執行 macOS App 或節點主機，並配對到 Gateway。
• 25. 使用 openclaw nodes status / openclaw nodes list 來查看狀態。

​

26. 我可以使用 Bun 嗎

41. 不建議 使用 Bun。 28. 我們觀察到執行期錯誤，特別是在 WhatsApp 與 Telegram 上。
42. 請使用 Node 以獲得穩定的 Gateway。

​

45. Telegram 的 allowFrom 要填什麼

46. channels.telegram.allowFrom 是 人類發送者的 Telegram 使用者 ID（數字，建議）或 @username。 47. 這不是機器人的使用者名稱。

• 私訊你的機器人，然後執行 openclaw logs --follow 並讀取 from.id。

49. 官方 Bot API：

• 50. 私訊你的機器人，接著呼叫 https://api.telegram.org/bot<bot_token>/getUpdates 並讀取 message.from.id。

• DM @userinfobot or @getidsbot.

38. 請參閱 /channels/telegram。

​

Can multiple people use one WhatsApp number with different OpenClaw instances

​

44. 我可以同時跑一個快速聊天代理，以及一個用於寫程式的 Opus 代理嗎

​

48. Homebrew 能在 Linux 上使用嗎

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install <formula>

​

What’s the difference between the hackable git install and npm install

• 可駭（git）安裝： 完整原始碼檢出、可編輯，最適合貢獻者。 You run builds locally and can patch code/docs.
• npm install: global CLI install, no repo, best for “just run it.” Updates come from npm dist-tags.

​

之後可以在 npm 與 git 安裝之間切換嗎

3. 從 npm → git：

4. git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart

npm install -g openclaw@latest
openclaw doctor
openclaw gateway restart

7. Doctor 會偵測到 gateway 服務進入點不一致，並提供重新寫入服務設定以符合目前安裝（在自動化中使用 --repair）。

​

Should I run the Gateway on my laptop or a VPS

• Pros: no server cost, direct access to local files, live browser window.
• Cons: sleep/network drops = disconnects, OS updates/reboots interrupt, must stay awake.

15. VPS / 雲端

• Pros: always-on, stable network, no laptop sleep issues, easier to keep running.
• Cons: often run headless (use screenshots), remote file access only, you must SSH for updates.

​

How important is it to run OpenClaw on a dedicated machine

• Dedicated host (VPS/Mac mini/Pi): always-on, fewer sleep/reboot interruptions, cleaner permissions, easier to keep running.
• Shared laptop/desktop: totally fine for testing and active use, but expect pauses when the machine sleeps or updates.

​

What are the minimum VPS requirements and recommended OS

• Absolute minimum: 1 vCPU, 1GB RAM, ~500MB disk.
• Recommended: 1-2 vCPU, 2GB RAM or more for headroom (logs, media, multiple channels). Node tools and browser automation can be resource hungry.

​

Can I run OpenClaw in a VM and what are the requirements

• Absolute minimum: 1 vCPU, 1GB RAM.
• Recommended: 2GB RAM or more if you run multiple channels, browser automation, or media tools.
• OS: Ubuntu LTS or another modern Debian/Ubuntu.

5. 如果你使用 Windows，WSL2 是最容易的 VM 風格設定，且具備最佳的工具相容性。 6. 請參閱 Windows、VPS hosting。 If you are running macOS in a VM, see macOS VM.

​

What is OpenClaw?

​

What is OpenClaw in one paragraph

​

12. 價值主張是什麼

13. OpenClaw 不是「只是 Claude 的包裝器」。 It’s a local-first control plane that lets you run a capable assistant on your own hardware, reachable from the chat apps you already use, with stateful sessions, memory, and tools - without handing control of your workflows to a hosted SaaS.
14. 重點特色：

• 16. 你的裝置，你的資料： 在任何你想要的地方（Mac、Linux、VPS）執行 Gateway，並將工作區與會話歷史保留在本地。
• Real channels, not a web sandbox: WhatsApp/Telegram/Slack/Discord/Signal/iMessage/etc, plus mobile voice and Canvas on supported platforms.
• Model-agnostic: use Anthropic, OpenAI, MiniMax, OpenRouter, etc., with per-agent routing and failover.
• Local-only option: run local models so all data can stay on your device if you want.
• 20. 多代理路由： 依頻道、帳號或任務分離不同代理，每個都有自己的工作區與預設值。
• Open source and hackable: inspect, extend, and self-host without vendor lock-in.

​

I just set it up what should I do first

• Build a website (WordPress, Shopify, or a simple static site).
• Prototype a mobile app (outline, screens, API plan).
• Organize files and folders (cleanup, naming, tagging).
• 28. 連接 Gmail，並自動化摘要或後續跟進。

29. 它可以處理大型任務，但在你將任務拆分成多個階段，並使用子代理進行平行工作時，效果最佳。

​

30. OpenClaw 的五大日常使用情境是什麼

• 32. 個人簡報： 你關心的收件匣、行事曆與新聞摘要。
• Research and drafting: quick research, summaries, and first drafts for emails or docs.
• Reminders and follow ups: cron or heartbeat driven nudges and checklists.
• Browser automation: filling forms, collecting data, and repeating web tasks.
• 36. 跨裝置協作： 從手機送出任務，讓 Gateway 在伺服器上執行，並在聊天中取回結果。

​

37. OpenClaw 能協助 SaaS 的名單開發、外聯、廣告與部落格嗎

38. 可以，用於研究、資格篩選與撰寫草稿。 39. 它可以掃描網站、建立候選清單、整理潛在客戶摘要，並撰寫外聯或廣告文案草稿。
39. 對於外聯或廣告投放，請保留人工審核。 Avoid spam, follow local laws and platform policies, and review anything before it is sent. The safest pattern is to let OpenClaw draft and you approve.
40. 文件：Security。

​

What are the advantages vs Claude Code for web development

45. OpenClaw 是一個個人助理與協調層，而不是 IDE 的替代品。 46. 在儲存庫內進行最快的直接寫碼循環，請使用 Claude Code 或 Codex。 47. 當你需要持久記憶、跨裝置存取，以及工具編排時，使用 OpenClaw。

• Persistent memory + workspace across sessions
• 50. 多平台存取（WhatsApp、Telegram、TUI、WebChat）
• Tool orchestration (browser, files, scheduling, hooks)
• Always-on Gateway (run on a VPS, interact from anywhere)
• Nodes for local browser/screen/camera/exec

​

Skills and automation

​

How do I customize skills without keeping the repo dirty

​

Can I load skills from a custom folder

​

How can I use different models for different tasks

• Cron jobs: isolated jobs can set a model override per job.
• Sub-agents: route tasks to separate agents with different default models.
• On-demand switch: use /model to switch the current session model at any time.

​

The bot freezes while doing heavy work How do I offload that

​

Cron or reminders do not fire What should I check

• Confirm cron is enabled (cron.enabled) and OPENCLAW_SKIP_CRON is not set.
• Check the Gateway is running 24/7 (no sleep/restarts).
• Verify timezone settings for the job (--tz vs host timezone).

openclaw cron run <jobId> --force
openclaw cron runs --id <jobId> --limit 50

​

How do I install skills on Linux

npm i -g clawhub

pnpm add -g clawhub

​

Can OpenClaw run tasks on a schedule or continuously in the background

• Cron jobs for scheduled or recurring tasks (persist across restarts).
• Heartbeat for “main session” periodic checks.
• Isolated jobs for autonomous agents that post summaries or deliver to chats.

​

Can I run Apple macOS-only skills from Linux?

1. Create an SSH wrapper for the binary (example: memo for Apple Notes):
   #!/usr/bin/env bash
   set -euo pipefail
   exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"
   
2. Put the wrapper on PATH on the Linux host (for example ~/bin/memo).
3. Override the skill metadata (workspace or ~/.openclaw/skills) to allow Linux:
   ---
   name: apple-notes
   description: Manage Apple Notes via the memo CLI on macOS.
   metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] } } }
   ---
   
4. Start a new session so the skills snapshot refreshes.

​

Do you have a Notion or HeyGen integration

• Custom skill / plugin: best for reliable API access (Notion/HeyGen both have APIs).
• Browser automation: works without code but is slower and more fragile.

• 自訂技能／外掛： 最適合需要穩定 API 存取的情境（Notion／HeyGen 皆提供 API）。
• 瀏覽器自動化： 無需寫程式即可運作，但速度較慢且較不穩定。

clawhub install <skill-slug>
clawhub update --all

​

How do I install the Chrome extension for browser takeover

openclaw browser extension install
openclaw browser extension path

​

Sandboxing and memory

​

如果 Gateway 與 Chrome 在同一台機器上執行（預設設定），通常不需要任何額外設定。

​

是否有專門的沙箱文件？

3. 預設映像以安全為優先，並以 node 使用者身分執行，因此不包含系統套件、Homebrew 或內建瀏覽器。 4. 若要更完整的設定：

• Docker 感覺受限，我要如何啟用完整功能？
• 6. 使用 OPENCLAW_DOCKER_APT_PACKAGES 將系統相依套件烘焙進映像。
• 7. 透過隨附的 CLI 安裝 Playwright 瀏覽器： node /app/node_modules/playwright-core/cli.js install chromium
• 8. 設定 PLAYWRIGHT_BROWSERS_PATH 並確保該路徑會被持久化。

9. 文件：Docker, Browser。
10. 我可以讓私訊（DMs）保持私密，同時用一個 agent 讓群組公開並在沙盒中執行嗎
11. 可以——只要你的私有流量是 DMs，而公開流量是 groups。

​

我要如何將主機資料夾綁定到沙箱中

17. 將 agents.defaults.sandbox.docker.binds 設為 ["host:path:mode"]（例如："/home/user/src:/src:ro"）。 18. 全域與每個 agent 的 bind 會合併；當 scope: "shared" 時，會忽略每個 agent 的 bind。 19. 對任何敏感內容使用 :ro，並記得 bind 會繞過沙盒的檔案系統隔離牆。 範例與安全注意事項請參考 Sandboxing 與 Sandbox vs Tool Policy vs Elevated。

​

記憶體是如何運作的

22. OpenClaw 的記憶體其實就是 agent 工作區中的 Markdown 檔案：

• 每日筆記位於 memory/YYYY-MM-DD.md
• 24. 精選的長期筆記位於 MEMORY.md（僅主／私有工作階段）

25. OpenClaw 也會執行 靜默的預先壓縮記憶體刷新，提醒模型在自動壓縮前寫下可持久保存的筆記。 這只會在工作區可寫入時執行（唯讀沙箱會跳過）。 請參閱 Memory。

​

記憶體一直忘記事情，我要怎麼讓它記住

33. 文件：Memory, Agent workspace。

​

語意記憶搜尋是否需要 OpenAI API 金鑰

38. 若未明確設定 provider，OpenClaw 會在能解析到 API 金鑰時自動選擇 provider（驗證設定檔、models.providers.*.apiKey 或環境變數）。
39. 若解析到 OpenAI 金鑰則優先使用 OpenAI，否則若解析到 Gemini 金鑰則使用 Gemini。 40. 如果兩者都沒有可用的金鑰，記憶搜尋會保持停用，直到你完成設定。 41. 如果你已設定且存在本地模型路徑，OpenClaw 會優先使用 local。
40. 如果你想完全使用本地，請設定 memorySearch.provider = "local"（並可選擇設定 memorySearch.fallback = "none"）。 如果你想使用 Gemini embeddings，請設定 memorySearch.provider = "gemini" 並提供 GEMINI_API_KEY（或 memorySearch.remote.apiKey）。 44. 我們支援 OpenAI、Gemini 或 local 的 embedding 模型——設定細節請參考 Memory。

​

45. 記憶會永久保存嗎？有什麼限制？

46. 記憶檔案存放在磁碟上，除非你刪除，否則會一直保留。 47. 限制來自你的儲存空間，而不是模型。 工作階段情境 仍受模型的情境視窗限制，因此長對話可能會被壓縮或截斷。 這就是為什麼需要記憶體搜尋——它只會將相關部分拉回到情境中。
47. 文件：Memory, Context。

​

Where things live on disk

​

Is all data used with OpenClaw saved locally

• Local by default: sessions, memory files, config, and workspace live on the Gateway host (~/.openclaw + your workspace directory).
• Remote by necessity: messages you send to model providers (Anthropic/OpenAI/etc.) go to their APIs, and chat platforms (WhatsApp/Telegram/Slack/etc.) store message data on their servers.
• You control the footprint: using local models keeps prompts on your machine, but channel traffic still goes through the channel’s servers.

​

Where does OpenClaw store its data

1. 一切都位於 $OPENCLAW_STATE_DIR 之下（預設：~/.openclaw）：

​

Where should AGENTSmd SOULmd USERmd MEMORYmd live

21. 這些檔案位於 代理工作區，而不是 ~/.openclaw。

• Workspace (per agent): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md (or memory.md), memory/YYYY-MM-DD.md, optional HEARTBEAT.md.
• State dir (~/.openclaw): config, credentials, auth profiles, sessions, logs, and shared skills (~/.openclaw/skills).

24. 預設工作區是 ~/.openclaw/workspace，可透過以下方式設定：

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

26. 提示：如果你想要持久的行為或偏好，請要求機器人 將其寫入 AGENTS.md 或 MEMORY.md，而不是依賴聊天記錄。
27. 請參閱 Agent workspace 與 Memory。

​

28. 建議的備份策略是什麼

​

How do I completely uninstall OpenClaw

​

Can agents work outside the workspace

{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo",
    },
  },
}

​

Im in remote mode where is the session store

​

Config basics

​

What format is the config Where is it

$OPENCLAW_CONFIG_PATH

​

I set gatewaybind lan or tailnet and now nothing listens the UI says unauthorized

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me",
    },
  },
}

• gateway.remote.token is for remote CLI calls only; it does not enable local gateway auth.
• The Control UI authenticates via connect.params.auth.token (stored in app/UI settings). Avoid putting tokens in URLs.

​

Why do I need a token on localhost now

​

Do I have to restart after changing config

• gateway.reload.mode: "hybrid" (default): hot-apply safe changes, restart for critical ones
• hot, restart, off are also supported

​

How do I enable web search and web fetch

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
      },
      fetch: {
        enabled: true,
      },
    },
  },
}

• If you use allowlists, add web_search/web_fetch or group:web.
• web_fetch 預設為啟用（除非明確停用）。
• Daemons read env vars from ~/.openclaw/.env (or the service environment).

​

How do I run a central Gateway with specialized workers across devices

• Gateway (central): owns channels (Signal/WhatsApp), routing, and sessions.
• Nodes (devices): Macs/iOS/Android connect as peripherals and expose local tools (system.run, canvas, camera).
• Agents (workers): separate brains/workspaces for special roles (e.g. “Hetzner ops”, “Personal data”).
• Sub-agents: spawn background work from a main agent when you want parallelism.
• TUI: connect to the Gateway and switch agents/sessions.

​

Can the OpenClaw browser run headless

{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } },
    },
  },
}

• 15. 沒有可見的瀏覽器視窗（若需要視覺畫面請使用截圖）。
• 16. 某些網站在無頭模式下對自動化更嚴格（CAPTCHA、反機器人）。
  17. 例如，X/Twitter 經常封鎖無頭工作階段。

​

How do I use Brave for browser control

​

11. 遠端 Gateway 與節點

​

22. 指令如何在 Telegram、gateway 與 nodes 之間傳遞

13. Telegram 訊息由 gateway 處理。 24. gateway 會執行 agent， 然後只有在需要 node 工具時，才透過 Gateway WebSocket 呼叫 nodes：
14. Telegram → Gateway → Agent → node.* → Node → Gateway → Telegram
15. Nodes 不會看到進來的供應商流量；它們只會接收 node RPC 呼叫。

​

27. 如果 Gateway 託管在遠端，我的 agent 要如何存取我的電腦

18. 簡短答案：將你的電腦配對為一個節點。 19. Gateway 在其他地方執行，但它可以透過 Gateway WebSocket 在你的本機上呼叫 node.* 工具（螢幕、相機、系統）。
19. 典型設定：
20. 21. 在永遠在線的主機（VPS／家用伺服器）上執行 Gateway。
21. 22. 將 Gateway 主機與你的電腦放在同一個 tailnet 中。
22. 23. 確保 Gateway WS 可達（tailnet 綁定或 SSH 通道）。
23. 24. 在本機開啟 macOS App，並以 Remote over SSH 模式（或直接 tailnet）連線， 以便註冊為一個節點。
24. 25. 在 Gateway 上核准該節點：
    openclaw nodes pending
    openclaw nodes approve <requestId>
    

36. 不需要另外的 TCP 橋接；nodes 透過 Gateway WebSocket 連線。

37. 安全提醒：配對 macOS node 會允許在該機器上執行 system.run。 28. 僅 配對你信任的裝置，並檢視 Security。
38. 文件：Nodes、Gateway protocol、macOS remote mode、Security。

​

30. Tailscale 已連線，但我沒有收到回覆，接下來怎麼辦

• Gateway is running: openclaw gateway status
• Gateway health: openclaw status
• Channel health: openclaw channels status

35. 接著驗證驗證與路由：

• 36. 如果你使用 Tailscale Serve，請確保 gateway.auth.allowTailscale 設定正確。
• If you connect via SSH tunnel, confirm the local tunnel is up and points at the right port.
• Confirm your allowlists (DM or group) include your account.

​

40. 兩個 OpenClaw 實例可以在本機或 VPS 上彼此通訊嗎

42. 最簡單： 使用兩個機器人都能存取的一般聊天通道（Telegram／Slack／WhatsApp）。
43. 讓 Bot A 傳送訊息給 Bot B，然後讓 Bot B 如常回覆。
44. CLI 橋接（通用）： 執行一個腳本，呼叫另一個 Gateway： openclaw agent --message ... 45. --deliver，目標指向另一個機器人 正在監聽的聊天。 46. 如果其中一個機器人在遠端 VPS 上，請透過 SSH／Tailscale 將你的 CLI 指向該遠端 Gateway（請見 Remote access）。

48. openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to <chat-id>

50. 文件：Remote access、Agent CLI、Agent send。

​

Do I need separate VPSes for multiple agents

​

Is there a benefit to using a node on my personal laptop instead of SSH from a VPS

• No inbound SSH required. Nodes connect out to the Gateway WebSocket and use device pairing.
• Safer execution controls. system.run is gated by node allowlists/approvals on that laptop.
• More device tools. Nodes expose canvas, camera, and screen in addition to system.run.
• Local browser automation. Keep the Gateway on a VPS, but run Chrome locally and relay control with the Chrome extension + a node host on the laptop.

​

Should I install on a second laptop or just add a node

​

Do nodes run a gateway service

​

Is there an API RPC way to apply config

​

configapply wiped my config How do I recover and avoid this

• Restore from backup (git or a copied ~/.openclaw/openclaw.json).
• If you have no backup, re-run openclaw doctor and reconfigure channels/models.
• If this was unexpected, file a bug and include your last known config or any backup.
• A local coding agent can often reconstruct a working config from logs or history.

• Use openclaw config set for small changes.
• Use openclaw configure for interactive edits.

​

What’s a minimal sane config for a first install

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

How do I set up Tailscale on a VPS and connect from my Mac

1. Install + login on the VPS
   curl -fsSL https://tailscale.com/install.sh | sh
   sudo tailscale up
   
2. Install + login on your Mac
   • Use the Tailscale app and sign in to the same tailnet.
3. Enable MagicDNS (recommended)
   • In the Tailscale admin console, enable MagicDNS so the VPS has a stable name.
4. Use the tailnet hostname
   • SSH: ssh [email protected]
   • 2. Gateway WS：ws://your-vps.tailnet-xxxx.ts.net:18789

openclaw gateway --tailscale serve

4. 這會讓 gateway 綁定在 loopback，並透過 Tailscale 對外提供 HTTPS。 5. 請參閱 Tailscale。

​

6. 我要如何將 Mac 節點連線到遠端的 Gateway Tailscale Serve

7. Serve 會暴露 Gateway Control UI + WS。 8. 節點會透過同一個 Gateway WS 端點連線。
8. 建議的設定：
9. 10. 請確保 VPS + Mac 位於同一個 tailnet。
10. 11. 使用 macOS App 的 Remote 模式（SSH 目標可以是 tailnet 主機名稱）。
    12. 該 App 會建立 Gateway 連接埠的通道，並以節點身分連線。
11. Approve the node on the gateway:
    openclaw nodes pending
    openclaw nodes approve <requestId>
    

​

15. 環境變數與 .env 載入

​

How does OpenClaw load environment variables

• 18. 目前工作目錄中的 .env
• a global fallback .env from ~/.openclaw/.env (aka $OPENCLAW_STATE_DIR/.env)

19. 你也可以在設定中定義行內環境變數（僅在程序環境中不存在時才會套用）：

20. {
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}

​

21. 我是透過服務啟動 Gateway，但我的環境變數不見了，該怎麼辦

1. 23. 將缺少的金鑰放到 ~/.openclaw/.env，這樣即使服務沒有繼承你的 shell 環境也能讀取到。
2. Enable shell import (opt-in convenience):

{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

​

I set COPILOTGITHUBTOKEN but models status shows Shell env off Why

30. 如果 Gateway 以服務方式執行（launchd/systemd），它不會繼承你的 shell 環境。 31. 請用以下其中一種方式修正：
31. Put the token in ~/.openclaw/.env:
    33. COPILOT_GITHUB_TOKEN=...
    
32. 34. 或啟用 shell 匯入（env.shellEnv.enabled: true）。
33. Or add it to your config env block (applies only if missing).

openclaw models status

37. Copilot token 會從 COPILOT_GITHUB_TOKEN 讀取（也支援 GH_TOKEN / GITHUB_TOKEN）。
38. 請參閱 /concepts/model-providers 與 /environment。

​

8. 工作階段與多重聊天

​

How do I start a fresh conversation

10. 以獨立訊息傳送 /new 或 /reset。 11. 請參閱 Session management。

​

12. 如果我從不傳送新的訊息，工作階段會自動重置嗎

{
  session: {
    idleMinutes: 240,
  },
}

​

48. 是否有方法讓一組 OpenClaw 執行個體形成一個 CEO 與多個代理

18. 可以，透過 多代理路由 與 子代理。 19. 你可以建立一個協調代理 以及多個具有各自工作區與模型的工作代理。
19. 不過，這最適合被視為一個 有趣的實驗。 21. 它非常耗權杖，而且通常 比使用一個機器人搭配多個工作階段效率更低。 我們所設想的典型模型是： 你只和一個機器人對話，但用不同的工作階段來進行平行工作。 That bot can also spawn sub-agents when needed.
20. 文件：Multi-agent routing、Sub-agents、Agents CLI。

​

25. 為什麼在任務進行到一半時脈絡被截斷？我要如何避免

26. 工作階段的脈絡受限於模型的視窗大小。 27. 冗長的聊天、大量的工具輸出，或許多 檔案都可能觸發壓縮或截斷。
27. 有哪些方法有幫助：

• 29. 要求機器人總結目前狀態並將其寫入檔案。
• 30. 在長任務前使用 /compact，切換主題時使用 /new。
• Keep important context in the workspace and ask the bot to read it back.
• 對於長時間或平行的工作使用子代理，讓主聊天保持較小。
• 33. 如果經常發生，選擇具有更大脈絡視窗的模型。

​

我要如何在保留安裝的情況下，完全重置 OpenClaw？

openclaw reset

openclaw reset --scope full --yes --non-interactive

openclaw onboard --install-daemon

• The onboarding wizard also offers Reset if it sees an existing config. See Wizard.
• 41. 如果你使用了設定檔（--profile / OPENCLAW_PROFILE），請重置每個狀態目錄（預設為 ~/.openclaw-<profile>）。
• Dev reset: openclaw gateway --dev --reset (dev-only; wipes dev config + credentials + sessions + workspace).

​

Im getting context too large errors how do I reset or compact

• 44. 壓縮（保留對話，但總結較舊的回合）：
  /compact
  
  46. 或使用 /compact <instructions> 來引導摘要。
• 重置（為相同的聊天鍵建立全新的工作階段 ID）：
  /new
  /reset
  

49. 如果持續發生：

• 啟用或調整 工作階段修剪（agents.defaults.contextPruning），以修剪舊的工具輸出。
• Use a model with a larger context window.

​

Why am I seeing LLM request rejected messagesNcontentXtooluseinput Field required

​

為什麼我每 30 分鐘會收到一次心跳訊息？

{
  agents: {
    defaults: {
      heartbeat: {
        every: "2h", // or "0m" to disable
      },
    },
  },
}

​

Do I need to add a bot account to a WhatsApp group

{
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

​

How do I get the JID of a WhatsApp group

openclaw logs --follow --json

openclaw directory groups list --channel whatsapp

​

為什麼 OpenClaw 在群組中不回覆

• Mention gating is on (default). You must @mention the bot (or match mentionPatterns).
• You configured channels.whatsapp.groups without "*" and the group isn’t allowlisted.

​

Do groupsthreads share context with DMs

​

How many workspaces and agents can I create

• Disk growth: sessions + transcripts live under ~/.openclaw/agents/<agentId>/sessions/.
• Token cost: more agents means more concurrent model usage.
• Ops overhead: per-agent auth profiles, workspaces, and channel routing.

• Keep one active workspace per agent (agents.defaults.workspace).
• Prune old sessions (delete JSONL or store entries) if disk grows.
• Use openclaw doctor to spot stray workspaces and profile mismatches.

​

Can I run multiple bots or chats at the same time Slack and how should I set that up

• 常駐的 Gateway 主機（VPS／Mac mini）。
• 每個角色一個代理（綁定）。
• Slack channel(s) bound to those agents.
• Local browser via extension relay (or a node) when needed.

​

Models: defaults, selection, aliases, switching

​

What is the default model

agents.defaults.model.primary

​

What model do you recommend

​

Can I use selfhosted models llamacpp vLLM Ollama

​

How do I switch models without wiping my config

• /model in chat (quick, per-session)
• openclaw models set ... (updates just model config)
• openclaw configure --section model (interactive)
• edit agents.defaults.model in ~/.openclaw/openclaw.json

​

What do OpenClaw, Flawd, and Krill use for models

• OpenClaw + Flawd: Anthropic Opus (anthropic/claude-opus-4-6) - see Anthropic.
• Krill: MiniMax M2.1 (minimax/MiniMax-M2.1) - see MiniMax.

​

How do I switch models on the fly without restarting

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

/model 3

/model opus@anthropic:default
/model opus@anthropic:work

/model anthropic/claude-opus-4-6

​

Can I use GPT 5.2 for daily tasks and Codex 5.3 for coding

• Quick switch (per session): /model gpt-5.2 for daily tasks, /model gpt-5.3-codex for coding.
• Default + switch: set agents.defaults.model.primary to openai/gpt-5.2, then switch to openai-codex/gpt-5.3-codex when coding (or the other way around).
• Sub-agents: route coding tasks to sub-agents with a different default model.

​

Why do I see Model is not allowed and then no reply

Model "provider/model" is not allowed. Use /model to list available models.

​

1. 為什麼我會看到 Unknown model minimaxMiniMaxM21

4. 修正檢查清單：
5. 5. 升級到 2026.1.12（或從原始碼 main 分支執行），然後重新啟動 gateway。
6. 6. 確認 MiniMax 已設定（精靈或 JSON），或在 env/auth profiles 中存在 MiniMax API key，讓提供者能被注入。
7. 7. 使用精確的模型 ID（區分大小寫）：minimax/MiniMax-M2.1 或 minimax/MiniMax-M2.1-lightning。
8. Run:
   openclaw models list
   
   8. 並從清單中選擇（或在聊天中使用 /model list）。

9. 請參閱 MiniMax 與 Models。

​

Can I use MiniMax as my default and OpenAI for complex tasks

13. 選項 A：依工作階段切換

14. {
  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "minimax/MiniMax-M2.1" },
      models: {
        "minimax/MiniMax-M2.1": { alias: "minimax" },
        "openai/gpt-5.2": { alias: "gpt" },
      },
    },
  },
}

15. /model gpt

• Agent A default: MiniMax
• Agent B default: OpenAI
• 19. 依 agent 路由，或使用 /agent 來切換

20. 文件：Models、Multi-Agent Routing、MiniMax、OpenAI。

​

21. opus、sonnet、gpt 是內建捷徑嗎

• opus → anthropic/claude-opus-4-6
• 24. sonnet → anthropic/claude-sonnet-4-5
• 25. gpt → openai/gpt-5.2
• gpt-mini → openai/gpt-5-mini
• gemini → google/gemini-3-pro-preview
• 28. gemini-flash → google/gemini-3-flash-preview

29. 如果你設定了同名的自訂別名，將以你的設定為準。

​

30. 我要如何定義／覆寫模型捷徑別名

33. {
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-haiku-4-5": { alias: "haiku" },
      },
    },
  },
}

34. 接著 /model sonnet（或在支援時使用 /<alias>）會解析為該模型 ID。

​

35. 我要如何新增來自 OpenRouter 或 ZAI 等其他提供者的模型

36. OpenRouter（按 token 計費；多種模型）：

37. {
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      models: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
  env: { OPENROUTER_API_KEY: "sk-or-..." },
}

38. Z.AI（GLM 模型）：

39. {
  agents: {
    defaults: {
      model: { primary: "zai/glm-4.7" },
      models: { "zai/glm-4.7": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}

41. 新增 agent 後找不到提供者的 API key
42. 這通常表示 新的 agent 有空的驗證儲存。 43. 驗證是以 agent 為單位，並 儲存在：

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

• 44. 執行 openclaw agents add <id>，並在精靈中設定驗證。
• 45. 或將主要 agent 的 agentDir 中的 auth-profiles.json 複製到新 agent 的 agentDir。

46. 不要 在不同 agent 之間重用 agentDir；這會造成驗證／工作階段衝突。

​

47. 模型失敗切換與「All models failed」

​

48. 失敗切換如何運作

49. 失敗切換分兩個階段進行：
50. 50. 同一提供者內的驗證設定檔輪替。
51. 模型後備切換 到 agents.defaults.model.fallbacks 中的下一個模型。

​

這個錯誤代表什麼意思

找不到設定檔 "anthropic:default" 的憑證

​

Fix checklist for No credentials found for profile anthropicdefault

• Confirm where auth profiles live (new vs legacy paths)
  • Current: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Legacy: ~/.openclaw/agent/* (migrated by openclaw doctor)
• Confirm your env var is loaded by the Gateway
  • If you set ANTHROPIC_API_KEY in your shell but run the Gateway via systemd/launchd, it may not inherit it. Put it in ~/.openclaw/.env or enable env.shellEnv.
• Make sure you’re editing the correct agent
  • Multi-agent setups mean there can be multiple auth-profiles.json files.
• Sanity-check model/auth status
  • Use openclaw models status to see configured models and whether providers are authenticated.

• Use a setup-token
  • Run claude setup-token, then paste it with openclaw models auth setup-token --provider anthropic.
  • If the token was created on another machine, use openclaw models auth paste-token --provider anthropic.
• If you want to use an API key instead
  • Put ANTHROPIC_API_KEY in ~/.openclaw/.env on the gateway host.
  • Clear any pinned order that forces a missing profile:
    openclaw models auth order clear --provider anthropic
    
• Confirm you’re running commands on the gateway host
  • In remote mode, auth profiles live on the gateway machine, not your laptop.

​

Why did it also try Google Gemini and fail

​

Auth profiles: what they are and how to manage them

​

What is an auth profile

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

​

What are typical profile IDs

• anthropic:default (common when no email identity exists)
• anthropic:<email> for OAuth identities
• custom IDs you choose (e.g. anthropic:work)

​

Can I control which auth profile is tried first

# Defaults to the configured default agent (omit --agent)
openclaw models auth order get --provider anthropic

# Lock rotation to a single profile (only try this one)
openclaw models auth order set --provider anthropic anthropic:default

# Or set an explicit order (fallback within provider)
openclaw models auth order set --provider anthropic anthropic:work anthropic:default

# Clear override (fall back to config auth.order / round-robin)
openclaw models auth order clear --provider anthropic

1. 要鎖定特定代理：

openclaw models auth order set --provider anthropic --agent main anthropic:default

​

3. OAuth 與 API 金鑰有什麼差別

• OAuth often leverages subscription access (where applicable).
• API keys use pay-per-token billing.

​

Gateway: ports, “already running”, and remote mode

​

What port does the Gateway use

11. --port > OPENCLAW_GATEWAY_PORT > gateway.port > 預設 18789

​

12. 為什麼 openclaw gateway status 顯示 Runtime running 但 RPC probe failed

15. 使用 openclaw gateway status，並信任以下這些行：

• 16. Probe target:（探測實際使用的 URL）
• 17. Listening:（實際綁定在該連接埠上的內容）
• Last gateway error: (common root cause when the process is alive but the port isn’t listening)

​

Why does openclaw gateway status show Config cli and Config service different

21. openclaw gateway install --force

22. 從你希望服務使用的相同 --profile / 環境執行它。

​

What does another gateway instance is already listening mean

24. OpenClaw 會在啟動時立即透過綁定 WebSocket 監聽器來強制執行執行期鎖（預設 ws://127.0.0.1:18789）。 If the bind fails with EADDRINUSE, it throws GatewayLockError indicating another instance is already listening.

​

27. 我要如何以遠端模式執行 OpenClaw，讓客戶端連線到其他地方的 Gateway

28. 設定 gateway.mode: "remote" 並指向遠端 WebSocket URL，可選擇性設定 token/密碼：

29. {
  gateway: {
    mode: "remote",
    remote: {
      url: "ws://gateway.tailnet:18789",
      token: "your-token",
      password: "your-password",
    },
  },
}

• 30. 只有在 gateway.mode 為 local（或你傳入覆寫旗標）時，openclaw gateway 才會啟動。
• macOS 應用程式會監看設定檔，當這些值變更時即時切換模式。

​

Control UI 顯示未授權或一直重新連線，現在該怎麼辦

33. 你的 gateway 啟用了驗證（gateway.auth.*），但 UI 沒有送出相符的 token/密碼。
34. 事實（來自程式碼）：

• 35. Control UI 會將 token 儲存在瀏覽器 localStorage 的鍵 openclaw.control.settings.v1。

• 最快方式：openclaw dashboard（會輸出並複製儀表板 URL，嘗試開啟；若為無頭環境會顯示 SSH 提示）。
• 37. 如果你還沒有 token：openclaw doctor --generate-gateway-token。
• 38. 若為遠端，先建立通道：ssh -N -L 18789:127.0.0.1:18789 user@host，然後開啟 http://127.0.0.1:18789/。
• 39. 在 gateway 主機上設定 gateway.auth.token（或 OPENCLAW_GATEWAY_TOKEN）。
• 40. 在 Control UI 設定中貼上相同的 token。
• 14. 還是卡住？ 42. 執行 openclaw status --all，並依照 Troubleshooting。 43. 請參閱 Dashboard 以了解驗證細節。

​

17. 我把 gateway bind 設為 tailnet，但無法綁定，什麼都沒有在監聽

45. tailnet 綁定會從你的網路介面中選擇一個 Tailscale IP（100.64.0.0/10）。 19. 如果該機器未加入 Tailscale（或介面已停用），就沒有可綁定的位址。

• 47. 在該主機上啟動 Tailscale（使其擁有 100.x 位址），或
• 48. 切換為 gateway.bind: "loopback" / "lan"。

49. 注意：tailnet 是明確指定的。 23. auto 會偏好 loopback；當你想要僅限 tailnet 綁定時，請使用 gateway.bind: "tailnet"。

​

Can I run multiple Gateways on the same host

25. 通常不行——一個 Gateway 就能執行多個訊息通道與代理。 Use multiple Gateways only when you need redundancy (ex: rescue bot) or hard isolation.
26. 可以，但你必須做隔離：

• OPENCLAW_CONFIG_PATH (per-instance config)
• OPENCLAW_STATE_DIR (per-instance state)
• agents.defaults.workspace (workspace isolation)
• gateway.port (unique ports)

• 33. 每個實例使用 openclaw --profile <name> …（會自動建立 ~/.openclaw-<name>）。
• Set a unique gateway.port in each profile config (or pass --port for manual runs).
• 35. 安裝每個設定檔的服務：openclaw --profile <name> gateway install。

​

What does invalid handshake code 1008 mean

42. 常見原因：

• You opened the HTTP URL in a browser (http://...) instead of a WS client.
• 44. 你使用了錯誤的連接埠或路徑。
• A proxy or tunnel stripped auth headers or sent a non-Gateway request.

46. 快速修正：
47. Use the WS URL: ws://<host>:18789 (or wss://... if HTTPS).
48. Don’t open the WS port in a normal browser tab.
49. 49. 若啟用了驗證，請在 connect frame 中包含 token/密碼。

openclaw tui --url ws://<host>:18789 --token <token>

​

Logging and debugging

​

Where are logs

/tmp/openclaw/openclaw-YYYY-MM-DD.log

openclaw logs --follow

• macOS: $OPENCLAW_STATE_DIR/logs/gateway.log and gateway.err.log (default: ~/.openclaw/logs/...; profiles use ~/.openclaw-<profile>/logs/...)
• Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
• Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST

​

How do I startstoprestart the Gateway service

openclaw gateway status
openclaw gateway restart

​

I closed my terminal on Windows how do I restart OpenClaw

wsl
openclaw gateway status
openclaw gateway restart

openclaw gateway run

openclaw gateway status
openclaw gateway restart

openclaw gateway run

​

The Gateway is up but replies never arrive What should I check

openclaw status
openclaw models status
openclaw channels status
openclaw logs --follow

• 模型驗證未在 gateway 主機 上載入（檢查 models status）。
• Channel 配對 / 允許清單阻擋回覆（檢查 channel 設定與日誌）。
• WebChat / Dashboard 在沒有正確 token 的情況下開啟。

​

無故與 gateway 斷線 現在該怎麼辦

1. Is the Gateway running? openclaw gateway status
2. Gateway 是否健康？ openclaw status
3. UI 是否使用正確的 token？ openclaw dashboard
4. 如果是遠端連線，tunnel / Tailscale 連結是否正常？

openclaw logs --follow

​

Telegram setMyCommands fails with network errors What should I check

openclaw channels status
openclaw channels logs --channel telegram

​

TUI 沒有顯示任何輸出 我該檢查什麼

openclaw status
openclaw models status
openclaw logs --follow

​

我要如何完全停止再啟動 Gateway

openclaw gateway stop
openclaw gateway start

openclaw gateway run

​

ELI5 openclaw gateway restart 與 openclaw gateway 的差別

• openclaw gateway restart：重新啟動 背景服務（launchd／systemd）。
• openclaw gateway：在此終端機工作階段 以前景模式 執行 gateway。

​

當某些事情失敗時，最快取得更多詳細資訊的方法是什麼

1. 使用 --verbose 啟動 Gateway 以取得更多主控台細節。 Then inspect the log file for channel auth, model routing, and RPC errors.

​

3. 媒體與附件

​

4. 我的技能產生了一個 imagePDF，但什麼都沒有送出

5. 代理程式送出的外部附件必須包含一行 MEDIA:<path-or-url>（需獨立成行）。 6. 請參閱 OpenClaw assistant setup 與 Agent send。
6. CLI 傳送：

openclaw message send --target +15555550123 --message "Here you go" --media /path/to/file.png

• 10. 目標頻道支援外傳媒體，且未被允許清單（allowlists）封鎖。
• 11. 檔案大小在供應商的限制內（圖片會被調整至最大 2048px）。

12. 請參閱 Images。

​

安全性與存取控制

​

將 OpenClaw 暴露於外部私訊是否安全？

15. 將入站私訊視為不受信任的輸入。 16. 預設值的設計是為了降低風險：

• 在支援私訊的通道上，預設行為是配對（pairing）：
  • 未知的傳送者會收到一組配對碼；機器人不會處理其訊息。
  • 19. 透過以下指令核准：openclaw pairing approve <channel> <code>
  • 20. 待處理的請求每個頻道上限為 3 個；若未收到代碼，請檢查 openclaw pairing list <channel>。
• 21. 公開開放私訊需要明確的選擇加入（dmPolicy: "open" 並設定允許清單 "*"）。

22. 執行 openclaw doctor 以揭示有風險的私訊政策。

​

23. 提示注入（prompt injection）是否只對公開機器人構成風險

• 使用唯讀或停用工具的「reader」代理來摘要不受信任的內容。
• 30. 外洩上下文或代表你呼叫工具。
• 31. 透過以下方式降低影響範圍：

32. 使用唯讀或停用工具的「reader」代理程式來摘要不受信任的內容

​

33. 對啟用工具的代理程式關閉 web_search / web_fetch / browser

34. 沙箱化以及嚴格的工具允許清單 將機器人與獨立的帳號與電話號碼隔離，能在出問題時降低影響範圍。 36. 我的機器人是否應該擁有自己的電子郵件、GitHub 帳號或電話號碼
35. 是的，對大多數設定而言如此。 38. 使用獨立的帳號與電話號碼來隔離機器人
36. 若發生問題，可降低影響範圍。

​

40. 這也讓你更容易輪替

41. 憑證或撤銷存取權，而不影響你的個人帳號。 42. 從小規模開始。

• 43. 只授予你實際需要的工具與帳號存取權，並在需要時再
• 44. 擴充。
• 讓它先起草，然後在送出前核准。

​

2. 我可以用較便宜的模型來處理個人助理任務嗎

3. 可以，如果該代理僅用於聊天，且輸入是可信的。 4. 較小的等級 更容易受到指令劫持的影響，因此請避免將其用於啟用工具的代理 或在讀取不受信任的內容時使用。 5. 如果你必須使用較小的模型，請鎖定 工具並在沙箱中運行。 6. 請參閱 Security。

​

7. 我在 Telegram 中執行了 start，但沒有收到配對碼

8. 配對碼僅在未知的發送者向機器人傳訊，且 dmPolicy: "pairing" 已啟用時才會發送。 9. 單獨輸入 /start 不會產生配對碼。
9. 檢查待處理的請求：

openclaw pairing list telegram

​

12. WhatsApp 會傳訊給我的聯絡人嗎？配對是如何運作的

16. 以以下方式核准配對：

17. openclaw pairing approve whatsapp <code>

18. 列出待處理的請求：

openclaw pairing list whatsapp

​

22. 聊天指令、終止任務，以及「它停不下來」

​

23. 我要如何阻止內部系統訊息顯示在聊天中

24. 大多數內部或工具訊息只會在該工作階段啟用 verbose 或 reasoning 時顯示。

/verbose off
/reasoning off

29. 文件：Thinking and verbose，Security。

​

30. 我要如何停止或取消正在執行的任務

31. 將以下任一項作為獨立訊息發送（不要加斜線）：

32. stop
abort
esc
wait
exit
interrupt

33. 這些是中止觸發詞（不是斜線指令）。
34. 對於背景程序（來自 exec 工具），你可以要求代理執行：

35. process action:kill sessionId:XXX

36. 斜線指令總覽：請參閱 Slash commands。
37. 大多數指令必須以 / 開頭並作為獨立訊息發送，但少數捷徑（如 /status）也可在行內使用，僅限於允許清單中的發送者。

​

38. 我要如何從 Telegram 發送 Discord 訊息？跨情境傳訊被拒絕

39. OpenClaw 預設會封鎖跨提供者傳訊。 40. 如果工具呼叫綁定到 Telegram，除非你明確允許，否則它不會發送到 Discord。
40. 為代理啟用跨提供者傳訊：

42. {
  agents: {
    defaults: {
      tools: {
        message: {
          crossContext: {
            allowAcrossProviders: true,
            marker: { enabled: true, prefix: "[from {channel}] " },
          },
        },
      },
    },
  },
}

43. 編輯設定後重新啟動 gateway。 44. 如果你只想為單一 代理啟用，請改在 agents.list[].tools.message 下設定。

​

45. 為什麼感覺機器人會忽略連續快速發送的訊息

46. 佇列模式控制新訊息如何與正在執行的任務互動。 Use /queue to change modes:

• 48. steer - 新訊息會重新導向目前的任務
• 49. followup - 一次只執行一則訊息
• 50. collect - 將訊息批次收集後一次回覆（預設）
• steer-backlog - 先進行 steer，然後處理積壓項目
• interrupt - 中止目前執行並重新開始

​

回答截圖／聊天紀錄中的確切問題