常見問題

針對真實環境設置（本地開發、VPS、多代理、OAuth/API 金鑰、模型故障轉移）的快速解答及更深入的故障排除。有關運行時診斷，請參閱故障排除。有關完整配置參考，請參閱配置。

如果發生問題時的前 60 秒

快速狀態（首先檢查）
Terminal window
```
openclaw status
```
快速本地摘要：作業系統 + 更新、閘道器/服務連線性、代理/工作階段、提供者設定組態 + 執行時期問題（當閘道器可連線時）。
可貼上的報告（安全可分享）
Terminal window
```
openclaw status --all
```
具有記錄追蹤（token 已編輯）的唯讀診斷。
常駐程式 + 埠狀態
Terminal window
```
openclaw gateway status
```
顯示監督器執行時期與 RPC 連線性、探測目標 URL，以及服務可能使用的設定組態。
深度探測
Terminal window
```
openclaw status --deep
```
執行即時的閘道健康狀態檢測，包括受支援時的通道檢測（需要可連線的閘道）。請參閱健康狀態。
追蹤最新記錄
Terminal window
```
openclaw logs --follow
```
如果 RPC 停機，則回退至：
Terminal window
```
tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
```
檔案日誌與服務日誌是分開的；請參閱日誌記錄和故障排除。
執行醫生程式（修復）
Terminal window
```
openclaw doctor
```
修復/遷移配置/狀態並執行健康檢查。請參閱 Doctor。
閘道器快照
Terminal window
```
openclaw health --json
openclaw health --verbose   # shows the target URL + config path on errors
```
向運行中的閘道請求完整快照（僅限 WS）。請參閱健康狀態。

快速開始與首次執行設定

首次執行常見問題 — 安裝、上架、認證路由、訂閱、初始失敗 — 位於首次執行 FAQ。

什麼是 OpenClaw？

OpenClaw 是什麼，用一段話概括？

OpenClaw 是您在自己的設備上運行的個人 AI 助手。它會在您已經使用的訊息介面上回覆（WhatsApp、Telegram、Slack、Mattermost、Discord、Google Chat、Signal、iMessage、WebChat 以及內建的頻道外掛如 QQ 機器人），並且在支援的平台上還能進行語音互動和使用即時 Canvas。Gateway 是永遠在線的控制平面；而助理則是產品本身。

價值主張

OpenClaw 不僅僅是「一個 Claude 的包裝器」。它是一個 本地優先的控制平面，讓你能夠在 你自己的硬體上運行一個強大的助手，透過你已經使用的聊天應用程式存取，並具有有狀態的會話、記憶和工具 - 而無需將工作流程的控制權交給託管的 SaaS。

亮點：

你的裝置，你的資料： 在你想要的任何地方（Mac、Linux、VPS）執行閘道，並將工作區 + 會話記錄保留在本地。
真實的通道，而不是網頁沙箱： WhatsApp/Telegram/Slack/Discord/Signal/iMessage 等，加上支援平台上的行動語音和 Canvas。
模型無關性： 使用 Anthropic、OpenAI、MiniMax、OpenRouter 等，進行每個代理的路由和故障轉移。
僅限本地的選項： 執行本地模型，因此如果你願意，所有資料都可以保留在你的裝置上。
多代理路由： 按通道、帳戶或任務分開代理，每個都有自己的工作區和預設值。
開源且可駭： 檢查、擴展和自行託管，沒有廠商鎖定。

文件：閘道、通道、多代理、記憶。

我剛設定好——首先應該做什麼？

適合做為初次嘗試的專案：

建立一個網站（WordPress、Shopify 或一個簡單的靜態網站）。
製作行動應用程式原型（大綱、畫面、API 計畫）。
整理檔案和資料夾（清理、命名、標記）。
連結 Gmail 並自動產生摘要或後續追蹤。

它可以處理大型任務，但當您將其分解為階段並使用子助理進行並行工作時，效果最好。

OpenClaw 的五大日常使用案例是什麼？

日常的勝利通常體現在：

個人簡報： 您關注的收件箱、行事曆和新聞摘要。
研究與草擬： 快速研究、摘要，以及電子郵件或文件的初稿。
提醒與跟進： 由 cron 或心跳驅動的提醒與檢查清單。
瀏覽器自動化： 填寫表單、收集資料和重複執行的網頁任務。
跨裝置協調： 從手機發送任務，讓 Gateway 在伺服器上執行，並在聊天中取回結果。

OpenClaw 是否能協助 SaaS 進行潛在客戶開發、外聯、廣告和部落格撰寫？

可以用於研究、資格審查和草稿撰寫。它可以掃描網站、建立候選名單、總結潛在客戶，並撰寫外聯或廣告文案草稿。

關於外聯或廣告投放，請保持人員在環中。避免垃圾訊息，遵守當地法律和平台政策，並在發送前審閱所有內容。最安全的模式是讓 OpenClaw 撰寫草稿，由您來審核批准。

文件：安全性。

與 Claude Code 相比，OpenClaw 在網頁開發方面有哪些優勢？

OpenClaw 是一個個人助理和協調層，而非 IDE 的替代品。使用 Claude Code 或 Codex 可以在程式庫內獲得最快的直接編碼循環。當您需要持久記憶、跨裝置存取和工具編排時，請使用 OpenClaw。

優勢：

跨會話的持久記憶 + 工作區
多平台存取（WhatsApp、Telegram、TUI、WebChat）
工具編排（瀏覽器、檔案、排程、掛鉤）
永遠在線的閘道（在 VPS 上執行，從任何地方互動）
用於本地瀏覽器/螢幕/相機/執行的節點

展示：https://openclaw.ai/showcase

技能與自動化

如何在不讓程式庫變得髒亂的情況下自訂技能？

使用受管覆寫代替編輯程式庫副本。將您的變更放在 `~/.openclaw/skills/

/SKILL.md中（或透過~/.openclaw/openclaw.json中的skills.load.extraDirs新增資料夾）。優先順序為

/skills→

/.agents/skills→~~/.agents/skills→~~/.openclaw/skills→ bundled →skills.load.extraDirs，因此受管覆寫仍然優勝於捆绑技能，而不需觸碰 git。如果您需要全域安裝技能但僅對部分代理程式可見，請將共享副本保留在 ~/.openclaw/skills中，並使用agents.defaults.skills和agents.list[].skills` 控制可見性。只有值得提交至上遊的編輯才應存在於程式庫中並作為 PR 發出。

我可以從自訂資料夾載入技能嗎？

可以。透過 ~/.openclaw/openclaw.json 中的 skills.load.extraDirs 新增額外目錄（優先順序最低）。預設優先順序為 `

/skills→

/.agents/skills→~~/.agents/skills→~~/.openclaw/skills→ bundled →skills.load.extraDirs。clawhub預設安裝到./skills中，OpenClaw 在下一次工作階段會將其視為

/skills。如果該技能應僅對特定代理程式可見，請將其與 agents.defaults.skills或agents.list[].skills` 搭配使用。

如何針對不同的任務使用不同的模型？

目前支援的模式有：

Cron 工作：獨立的工作可以為每個工作設定 model 覆寫。
子代理程式：將任務路由到具有不同預設模型的獨立代理程式。
隨需切換：使用 /model 隨時切換目前會話模型。

參閱 Cron 工作、多代理程式路由和斜線指令。

機器人在執行繁重工作時會卡住。我該如何將工作卸載？

針對長時間或並行任務，請使用子代理。子代理在自己的 session 中運行，會回傳摘要，並讓您的主聊天保持回應。

要求您的機器人「為此任務生成一個子代理」或使用 /subagents。在聊天中使用 /status 查看 Gateway 目前正在做什麼（以及它是否忙碌）。

Token 提示：長時間任務和子代理都會消耗 token。如果您關心成本，請透過 agents.defaults.subagents.model 為子代理設定較便宜的模型。

文件：子代理、背景任務。

Discord 上的執行緒綁定子代理 session 是如何運作的？

使用執行緒綁定。您可以將 Discord 執行緒綁定到子代理或 session 目標，以便該執行緒中的後續訊息保持在該綁定的 session 上。

基本流程：

使用 thread: true 透過 sessions_spawn 生成（並可選擇性地使用 mode: "session" 進行持續的後續追蹤）。
或使用 `/focus

手動綁定。 - 使用/agents檢查綁定狀態。 - 使用/session idle

和/session max-age

控制自動取消聚焦。 - 使用/unfocus` 分離執行緒。

所需設定：

- 全域預設值：`session.threadBindings.enabled`、`session.threadBindings.idleHours`、`session.threadBindings.maxAgeHours`。
- Discord 覆蓋值：`channels.discord.threadBindings.enabled`、`channels.discord.threadBindings.idleHours`、`channels.discord.threadBindings.maxAgeHours`。
- 生成時自動綁定：`channels.discord.threadBindings.spawnSessions` 預設為 `true`；將其設為 `false` 以停用執行緒綁定 session 生成。

文件：[子代理](/zh-Hant/tools/subagents)、[Discord](/zh-Hant/channels/discord)、[設定參考](/zh-Hant/gateway/configuration-reference)、[斜線指令](/zh-Hant/tools/slash-commands)。

子代理已完成，但完成更新發送到了錯誤的位置或從未發布。我應該檢查什麼？

首先檢查已解析的請求者路由：

完成模式的子代理傳送優先使用任何綁定的執行緒或對話路由（如果存在）。
如果完成來源僅攜帶頻道，OpenClaw 會退回到請求者會話的儲存路由 (lastChannel / lastTo / lastAccountId)，以便直接傳送仍能成功。
如果既沒有綁定路由也沒有可用的儲存路由，直接傳送可能會失敗，結果會退回到佇列會話傳送，而不是立即發布到聊天。
無效或過時的目標仍可能強制退回到佇列或導致最終傳送失敗。
如果子代理最後一個可見的助理回覆確切是靜默標記 NO_REPLY / no_reply，或確切是 ANNOUNCE_SKIP，OpenClaw 會有意抑制公告，而不是發布過時的早期進度。
如果子代理在僅進行工具呼叫後超時，公告可能會將其折疊為簡短的局部進度摘要，而不是重播原始工具輸出。

除錯：

openclaw tasks show

文件：[子代理](/zh-Hant/tools/subagents)、[背景工作](/zh-Hant/automation/tasks)、[會話工具](/zh-Hant/concepts/session-tool)。

Cron 或提醒未觸發。我應該檢查什麼？

Cron 在 Gateway 程序內運行。如果 Gateway 未持續運行，排程的工作將不會執行。

檢查清單：

確認 cron 已啟用 (cron.enabled) 且未設定 OPENCLAW_SKIP_CRON。
檢查 Gateway 是否全天候運行（無睡眠/重新啟動）。
驗證工作的時區設定 (--tz 與主機時區的對比)。

除錯：

openclaw cron run

openclaw cron runs —id

—limit 50

文件：[Cron 工作](/zh-Hant/automation/cron-jobs)、[自動化](/zh-Hant/automation)。

Cron 已觸發，但沒有發送任何內容到頻道。為什麼？

請先檢查傳遞模式：

--no-deliver / delivery.mode: "none" 表示不預期 runner 的備用發送。
缺少或無效的公告目標（channel / to）表示 runner 跳過了出站傳遞。
頻道認證失敗（unauthorized、Forbidden）表示 runner 嘗試傳遞，但憑證阻擋了它。
靜默的隔離結果（僅 NO_REPLY / no_reply）被視為故意不可傳遞，因此 runner 也會抑制排隊的備用傳遞。

對於隔離的 cron 工作，當有聊天路由可用時，代理程式仍然可以使用 message 工具直接發送。--announce 僅控制 runner 對代理程式尚未發送的最終文字的備用路徑。

除錯：

openclaw cron runs --id

—limit 50 openclaw tasks show

文件：[Cron 工作](/zh-Hant/automation/cron-jobs)、[背景任務](/zh-Hant/automation/tasks)。

為什麼隔離的 cron 執行會切換模型或重試一次？

這通常是即時模型切換路徑，而不是重複排程。

隔離的 cron 可以持續化執行時期的模型移交，並在作用中執行拋出 LiveSessionModelSwitchError 時重試。重試會保留切換後的提供者/模型，且如果切換帶有新的認證設定檔覆寫，cron 也會在重試前將其持續化。

相關選擇規則：

Gmail hook 模型覆寫在適用時優先。
然後是各個工作的 model。
然後是任何已儲存的 cron 會話模型覆寫。
然後是正常的代理程式/預設模型選擇。

重試迴圈是有界的。在初始嘗試加上 2 次切換重試後， cron 會中止而不是無限迴圈。

除錯：

openclaw cron runs --id

—limit 50 openclaw tasks show

文件：[Cron 工作](/zh-Hant/automation/cron-jobs)、[cron CLI](/zh-Hant/cli/cron)。

我如何在 Linux 上安裝技能？

使用原生 openclaw skills 指令或將技能放入您的工作區。macOS 技能 UI 在 Linux 上無法使用。在 https://clawhub.ai 瀏覽技能。

openclaw skills search "calendar"
openclaw skills search --limit 20
openclaw skills install

openclaw skills install

—version

openclaw skills install

—force openclaw skills install

—global openclaw skills update —all openclaw skills update —all —global openclaw skills list —eligible openclaw skills check

原生 `openclaw skills install` 預設會寫入到現用工作區 `skills/`
目錄中。新增 `--global` 以安裝到所有本地代理程式的共享管理技能目錄。僅在您想要發布或同步您自己的技能時，才安裝獨立的 `clawhub` CLI。
如果您想要限制哪些代理程式可以看到共享技能，請使用
`agents.defaults.skills` 或 `agents.list[].skills`。

OpenClaw 可以排程執行任務或在背景持續執行嗎？

可以。使用 Gateway 排程器：

Cron jobs 用於排程或週期性任務（重新啟動後仍持續存在）。
Heartbeat 用於「主工作階段」的定期檢查。
Isolated jobs 用於發佈摘要或傳送訊息至聊天的自主代理程式。

文件：Cron jobs、Automation、 Heartbeat。

我可以從 Linux 執行僅適用於 Apple macOS 的技能嗎？

不能直接執行。macOS 技能受到 metadata.openclaw.os 以及必要二進位檔案的門檻限制，而且只有在 Gateway 主機 上符合資格時，這些技能才會出現在系統提示詞中。在 Linux 上，除非你覆寫門檻限制，darwin 專用的技能（例如 apple-notes、apple-reminders、things-mac）將不會載入。

你有三種支援的模式：

選項 A - 在 Mac 上執行 Gateway（最簡單）。 在存在 macOS 二進位檔案的地方執行 Gateway，然後從 Linux 以遠端模式連線或透過 Tailscale 連線。因為 Gateway 主機是 macOS，技能會正常載入。

選項 B - 使用 macOS 節點（不需 SSH）。 在 Linux 上執行 Gateway，配對 macOS 節點（選單列應用程式），並在 Mac 上將 Node Run Commands 設定為「Always Ask」或「Always Allow」。當節點上存在必要的二進位檔案時，OpenClaw 可以將僅限 macOS 的技能視為符合資格。代理程式會透過 nodes 工具執行這些技能。如果你選擇「Always Ask」，在提示詞中核可「Always Allow」會將該指令加入允許清單。

選項 C - 透過 SSH 代理 macOS 二進位檔案（進階）。 將 Gateway 保留在 Linux 上，但讓必要的 CLI 二進位檔案解析為在 Mac 上執行的 SSH 包裝程式。然後覆寫技能以允許 Linux，使其保持符合資格。

建立二進位檔案的 SSH 包裝程式（例如：針對 Apple Notes 的 memo）：

#!/usr/bin/env bash
set -euo pipefail
exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"

將包裝程式放在 Linux 主機的 PATH 上（例如 ~/bin/memo）。

覆寫技能元資料（workspace 或 ~/.openclaw/skills）以允許 Linux：

---
name: apple-notes
description: Manage Apple Notes via the memo CLI on macOS.
metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] } } }
---

啟動新工作階段，以便重新整理技能快照。

你們有 Notion 或 HeyGen 整合功能嗎？

目前尚未內建。

選項如下：

自訂技能 / 外掛： 最適合用來進行可靠的 API 存取（Notion 和 HeyGen 都有 API）。
瀏覽器自動化： 不需要編寫程式碼，但速度較慢且較不穩定。

如果你想為每個客戶保留上下文（代理商工作流程），一個簡單的模式是：

每個客戶使用一個 Notion 頁面（上下文 + 偏好設定 + 進行中的工作）。
要求代理程式在會話開始時擷取該頁面。

如果你想要原生整合，請提出功能請求或建構一個針對這些 API 的技能。

安裝技能：

openclaw skills install

openclaw skills update —all

原生安裝會置於現有工作區的 `skills/` 目錄中。若要跨所有本地代理程式共用技能，請使用 `openclaw skills install

—global（或手動將其置於 ~/.openclaw/skills/

/SKILL.md中）。如果只有某些代理程式應該看到共用安裝，請設定agents.defaults.skills或agents.list[].skills`。某些技能預期透過 Homebrew 安裝二進位檔案；在 Linux 上這是指 Linuxbrew（請參閱上面的 Homebrew Linux FAQ 條目）。請參閱技能、技能設定和 ClawHub。

我如何將現有的已登入 Chrome 用於 OpenClaw？

使用內建的 user 瀏覽器設定檔，它透過 Chrome DevTools MCP 進行連接：

openclaw browser --browser-profile user tabs
openclaw browser --browser-profile user snapshot

如果你想要自訂名稱，請建立一個明確的 MCP 設定檔：

openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser --browser-profile chrome-live tabs

此路徑可以使用本地主機瀏覽器或連線的瀏覽器節點。如果 Gateway 在其他地方執行，請在瀏覽器機器上執行節點主機，或是改用遠端 CDP。

目前 existing-session / user 的限制：

動作是由參照驅動，而非由 CSS 選擇器驅動
上傳需要 ref / inputRef 且目前一次僅支援一個檔案
responsebody、PDF 匯出、下載攔截和批次動作仍需要受管理的瀏覽器或原始 CDP 設定檔

沙盒機制與記憶體

是否有專門的沙盒文件？

有的。請參閱 Sandboxing。關於 Docker 特定設定（Docker 中的完整閘道或沙盒映像檔），請參閱 Docker。

Docker 感覺受限 - 如何啟用完整功能？

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

使用 OPENCLAW_HOME_VOLUME 持續保存 /home/node，讓快取得以保留。
使用 OPENCLAW_IMAGE_APT_PACKAGES 將系統相依性內建至映像檔中。
透過內建 CLI 安裝 Playwright 瀏覽器： node /app/node_modules/playwright-core/cli.js install chromium
設定 PLAYWRIGHT_BROWSERS_PATH 並確保路徑已持續保存。

文件：Docker、Browser。

我可以讓私訊保持個人化，但讓群組使用單一代理程式公開/沙盒化嗎？

可以 - 如果您的私人流量是 私訊 (DMs) 而您的公開流量是群組。

使用 agents.defaults.sandbox.mode: "non-main"，讓群組/頻道階段作業（非主要金鑰）在設定的沙盒後端執行，同時主要私訊階段作業保持在主機上。如果您不選擇後端，Docker 是預設後端。然後透過 tools.sandbox.tools 限制沙盒階段作業中可用的工具。

設定逐步解說 + 範例設定：Groups: personal DMs + public groups

主要設定參考：Gateway configuration

如何將主機資料夾綁定到沙盒中？

將 agents.defaults.sandbox.docker.binds 設定為 ["host:path:mode"] (例如 "/home/user/src:/src:ro")。全域 + 每個代理程式的綁定會合併；當 scope: "shared" 時，會忽略每個代理程式的綁定。對於任何敏感資訊請使用 :ro，並請記得綁定會繞過沙盒檔案系統牆。

OpenClaw 會針對正規化路徑以及透過最深層現有祖先解析的規範路徑，驗證綁定來源。這意味著即使最後一個路徑區段尚不存在，符號連結父系逃逸仍會失敗並關閉，且在解析符號連結後仍會套用允許的根目錄檢查。

請參閱沙盒機制和沙盒 vs 工具政策 vs 提升權限以取得範例和安全注意事項。

記憶體如何運作？

OpenClaw 的記憶體只是代理程式工作區中的 Markdown 檔案：

memory/YYYY-MM-DD.md 中的每日筆記
MEMORY.md 中的策劃長期筆記 (僅限主要/私人階段)

OpenClaw 也會執行 靜默預壓縮記憶體清除，以提醒模型在自動壓縮之前寫入持久化的筆記。這僅在工作區可寫入時執行 (唯讀沙盒會跳過此步驟)。請參閱記憶體。

記憶體一直忘記事情。如何讓它牢記？

要求機器人 將事實寫入記憶體。長期筆記應放在 MEMORY.md 中，短期內容則放入 memory/YYYY-MM-DD.md。

這仍是我們正在改進的領域。提醒模型儲存記憶會有幫助；它會知道該做什麼。如果它持續忘記，請驗證 Gateway 在每次執行時是否使用相同的工作區。

文件：記憶體、代理程式工作區。

記憶體是否會永久保存？有哪些限制？

記憶體檔案儲存在磁碟上，並會持續保存直到您刪除它們。限制在於您的儲存空間，而非模型。工作階段語境 仍然受限於模型的語境視窗，因此冗長的對話可能會被壓縮或截斷。這就是為什麼存在記憶體搜尋——它只將相關的部分拉回語境中。

文件：記憶體、語境。

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

只有在使用 OpenAI 嵌入 時才需要。Codex OAuth 涵蓋了聊天/完成功能，但並不授予嵌入存取權限，因此 透過 Codex 登入（OAuth 或 Codex CLI 登入） 對語意記憶體搜尋沒有幫助。OpenAI 嵌入仍然需要一個真實的 API 金鑰（OPENAI_API_KEY 或 models.providers.openai.apiKey）。

如果您未明確設定提供者，當 OpenClaw 可以解析 API 金鑰時（auth profiles，models.providers.*.apiKey，或環境變數），它會自動選擇一個提供者。如果解析到 OpenAI 金鑰，它會優先選擇 OpenAI；否則如果解析到 Gemini 金鑰則選擇 Gemini，接著是 Voyage，然後是 Mistral。如果沒有可用的遠端金鑰，記憶體搜尋將保持停用狀態，直到您進行設定。如果您已設定並存在本機模型路徑， OpenClaw 會優先使用 local。當您明確設定 memorySearch.provider = "ollama" 時，支援 Ollama。

如果您希望保持本機化，請設定 memorySearch.provider = "local"（並可選擇性地設定 memorySearch.fallback = "none"）。如果您想要 Gemini 嵌入，請設定 memorySearch.provider = "gemini" 並提供 GEMINI_API_KEY（或 memorySearch.remote.apiKey）。我們支援 OpenAI、Gemini、Voyage、Mistral、Ollama 或本機 嵌入模型——詳見記憶體以了解設定細節。

檔案在磁碟上的位置

與 OpenClaw 一起使用的所有數據都會在本機保存嗎？

不會 - OpenClaw 的狀態是本機的，但 外部服務仍然能看到您發送給它們的內容。

預設為本機： 會話、記憶檔案、配置和工作區位於 Gateway 主機上 (~/.openclaw + 您的工作區目錄)。
必要時遠端： 您發送給模型提供者（Anthropic/OpenAI/等）的訊息會傳送至它們的 API，且聊天平台（WhatsApp/Telegram/Slack/等）會在其伺服器上儲存訊息數據。
您控制數據足跡： 使用本機模型可將提示保留在您的機器上，但頻道流量仍會經過頻道的伺服器。

相關：Agent workspace、Memory。

OpenClaw 將資料儲存在哪裡？

所有內容都位於 $OPENCLAW_STATE_DIR （預設值： ~/.openclaw）之下：

Path	Purpose
`$OPENCLAW_STATE_DIR/openclaw.json`	主要設定 (JSON5)
`$OPENCLAW_STATE_DIR/credentials/oauth.json`	舊版 OAuth 匯入（首次使用時會複製到 auth profiles）
`$OPENCLAW_STATE_DIR/agents/

/agent/auth.json | 舊版相容性檔案（靜態api_key項目已清理） | |$OPENCLAW_STATE_DIR/credentials/ | 提供者狀態 (例如whatsapp/

/sessions/ | 對話記錄與狀態 (各代理程式) | |$OPENCLAW_STATE_DIR/agents/

/sessions/sessions.json` | Session 中繼資料 (各代理程式) |

舊版單一代理程式路徑： `~/.openclaw/agent/*` （由 `openclaw doctor` 遷移）。

您的 **工作區** (AGENTS.md、記憶體檔案、技能等) 是分開的，並透過 `agents.defaults.workspace` 進行設定 (預設值： `~/.openclaw/workspace`)。

AGENTS.md / SOUL.md / USER.md / MEMORY.md 應該放在哪裡？

這些檔案位於 agent workspace 中，而不是 ~/.openclaw。

Workspace (每個 agent): AGENTS.md、SOUL.md、IDENTITY.md、USER.md， MEMORY.md、memory/YYYY-MM-DD.md，以及選用的 HEARTBEAT.md。小寫的根目錄 memory.md 僅供舊版修復輸入使用；當這兩個檔案都存在時，openclaw doctor --fix 可以將其合併到 MEMORY.md 中。
State dir (~/.openclaw): 配置、通道/提供者狀態、認證設定檔、工作階段、日誌，以及共享技能 (~/.openclaw/skills)。

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

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

如果機器人在重啟後「忘記」了先前的事，請確認 Gateway 每次啟動時都使用相同的 workspace (請記住：遠端模式使用的是 gateway host 的 workspace，而不是您的本機筆電)。

提示：如果您希望某種行為或偏好設定能持續保存，請要求機器人將其寫入 AGENTS.md 或 MEMORY.md，而不是依賴聊天紀錄。

請參閱 Agent workspace 和 Memory。

建議的備份策略

將您的 agent workspace 放在私人 git repo 中，並將其備份到某個私人位置 (例如 GitHub private repo)。這會儲存記憶 + AGENTS/SOUL/USER 檔案，讓您稍後還原助理的「心智」。

切勿將 ~/.openclaw 下的任何內容送交 (憑證、工作階段、權杖或加密的秘密載荷)。如果您需要完整還原，請分別備份 workspace 和 state 目錄 (請參閱上述的遷移問題)。

文件：Agent workspace。

如何完全解除安裝 OpenClaw？

請參閱專屬指南：Uninstall。

代理可以在工作區之外運作嗎？

可以。工作區是預設的 cwd 和記憶錨點，而不是嚴格的沙箱。相對路徑在工作區內解析，但絕對路徑可以存取其他主機位置，除非啟用了沙箱。如果您需要隔離，請使用 agents.defaults.sandbox 或每個代理的沙箱設定。如果您希望儲存庫成為預設工作目錄，請將該代理的 workspace 指向儲存庫根目錄。OpenClaw 儲存庫只是原始碼；請將工作區分開，除非您有意讓代理在其中運作。

範例（儲存庫作為預設 cwd）：

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

遠端模式：Session store 在哪裡？

Session 狀態由 gateway host 擁有。如果您處於遠端模式，您關心的 session store 位於遠端機器上，而不是您的本地筆記型電腦。請參閱 Session 管理。

設定基礎

設定檔是什麼格式？它在哪裡？

OpenClaw 從 $OPENCLAW_CONFIG_PATH 讀取可選的 JSON5 設定（預設值：~/.openclaw/openclaw.json）：

$OPENCLAW_CONFIG_PATH

如果檔案不存在，它會使用較安全的預設值（包括預設工作區 ~/.openclaw/workspace）。

我設定了 gateway.bind: "lan" (或 "tailnet")，但現在沒有監聽任何連線 / 介面顯示未授權

非回環綁定 需要有效的閘道驗證路徑。實際上這代表：

共用金鑰驗證：token 或密碼
gateway.auth.mode: "trusted-proxy" 位於正確設定的身分感知反向代理後方

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

註記：

gateway.remote.token / .password 單獨使用不會啟用本機閘道驗證。
只有在未設定 gateway.auth.* 時，本機呼叫路徑才能使用 gateway.remote.* 作為後備。
若要使用密碼驗證，請改為設定 gateway.auth.mode: "password" 加上 gateway.auth.password (或 OPENCLAW_GATEWAY_PASSWORD)。
如果 gateway.auth.token / gateway.auth.password 是透過 SecretRef 明確設定且無法解析，解析將會封閉式失敗 (沒有遠端後備遮罩)。
共用金鑰控制 UI 設定會透過 connect.params.auth.token 或 connect.params.auth.password (儲存於 app/UI 設定中) 進行驗證。承載身分的模式，例如 Tailscale Serve 或 trusted-proxy，則會改用請求標頭。請避免將共用金鑰放在 URL 中。
使用 gateway.auth.mode: "trusted-proxy" 時，同主機回環反向代理需要明確的 gateway.auth.trustedProxy.allowLoopback = true 以及 gateway.trustedProxies 中的回環條目。

為什麼我在本機現在同樣需要 Token？

OpenClaw 預設會強制執行閘道驗證，包括回路 (loopback)。在一般的預設路徑中，這意味著使用 Token 驗證：如果未設定明確的驗證路徑，閘道啟動時會解析為 Token 模式並為該次啟動產生僅限執行時期的 Token，因此 本機 WS 客戶端必須進行驗證。當客戶端在重啟之間需要穩定的金鑰時，請明確設定 gateway.auth.token、gateway.auth.password、OPENCLAW_GATEWAY_TOKEN 或 OPENCLAW_GATEWAY_PASSWORD。這能阻擋其他本機程序呼叫閘道。

如果您偏好不同的驗證路徑，可以明確選擇密碼模式（或者，針對具備身份識別能力的反向代理，使用 trusted-proxy）。如果您真的想要開放回路，請在設定中明確設定 gateway.auth.mode: "none"。Doctor 可以隨時為您產生 Token：openclaw doctor --generate-gateway-token。

變更設定後我需要重新啟動嗎？

閘道會監看設定檔並支援熱重載 (hot-reload)：

gateway.reload.mode: "hybrid" (預設)：熱套用安全變更，針對關鍵變更則重新啟動
hot、restart、off 也受到支援

我如何停用有趣的 CLI 標語？

在設定中設定 cli.banner.taglineMode：

{
  cli: {
    banner: {
      taglineMode: "off", // random | default | off
    },
  },
}

off：隱藏標語文字，但保留橫幅標題/版本行。
default：每次都使用 All your chats, one OpenClaw.。
random：輪播有趣/應景標語（預設行為）。
如果您完全不想要橫幅，請設定環境變數 OPENCLAW_HIDE_BANNER=1。

我該如何啟用網頁搜尋（以及網頁擷取）？

web_fetch 不需要 API 金鑰即可運作。web_search 取決於您選擇的提供者：

支援 API 的提供者（如 Brave、Exa、Firecrawl、Gemini、Grok、Kimi、MiniMax Search、Perplexity 和 Tavily）需要其標準的 API 金鑰設定。
Ollama Web Search 不需要金鑰，但它使用您設定的 Ollama 主機並且需要 ollama signin。
DuckDuckGo 不需要金鑰，但它是基於 HTML 的非官方整合。
SearXNG 無需金鑰/自行託管；請設定 SEARXNG_BASE_URL 或 plugins.entries.searxng.config.webSearch.baseUrl。

建議： 執行 openclaw configure --section web 並選擇一個提供者。環境變數替代方案：

Brave: BRAVE_API_KEY
Exa: EXA_API_KEY
Firecrawl: FIRECRAWL_API_KEY
Gemini: GEMINI_API_KEY
Grok: XAI_API_KEY
Kimi: KIMI_API_KEY 或 MOONSHOT_API_KEY
MiniMax Search: MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY 或 MINIMAX_API_KEY
Perplexity: PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY
SearXNG: SEARXNG_BASE_URL
Tavily: TAVILY_API_KEY

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
          },
        },
      },
    },
    },
    tools: {
      web: {
        search: {
          enabled: true,
          provider: "brave",
          maxResults: 5,
        },
        fetch: {
          enabled: true,
          provider: "firecrawl", // optional; omit for auto-detect
        },
      },
    },
}

特定提供者的網頁搜尋設定現在位於 `plugins.entries.

.config.webSearch.之下。舊版tools.web.search.提供者路徑為了相容性仍會暫時載入，但不應用於新設定。 Firecrawl 網頁擷取後援設定位於plugins.entries.firecrawl.config.webFetch.*` 之下。

註記：

- 如果您使用白名單，請新增 `web_search`/`web_fetch`/`x_search` 或 `group:web`。
- `web_fetch` 預設為啟用（除非明確停用）。
- 如果省略 `tools.web.fetch.provider`，OpenClaw 會從可用的憑證中自動偵測第一個就緒的擷取後援提供者。目前的內建提供者是 Firecrawl。
- Daemon 從 `~/.openclaw/.env`（或服務環境）讀取環境變數。

文件：[Web 工具](/zh-Hant/tools/web)。

config.apply 抹除了我的設定。我該如何復原並避免再次發生？

config.apply 會取代整個設定。如果您傳送一個部分物件，其他所有內容都會被移除。

目前的 OpenClaw 可防範許多意外的覆寫操作：

OpenClaw 擁有的設定寫入會在寫入前驗證完整的變更後設定。
無效或具破壞性的 OpenClaw 擁有寫入會被拒絕，並儲存為 openclaw.json.rejected.*。
如果直接編輯破壞了啟動或熱重新載入，Gateway 會失效關閉或跳過重新載入；它不會重寫 openclaw.json。
openclaw doctor --fix 擁有修復功能，可以還原最後已知良好的狀態，同時將被拒絕的檔案儲存為 openclaw.json.clobbered.*。

復原方式：

檢查 openclaw logs --follow 中的 Invalid config at、Config write rejected: 或 config reload skipped (invalid config)。
檢查活動設定旁邊最新的 openclaw.json.clobbered.* 或 openclaw.json.rejected.*。
執行 openclaw config validate 和 openclaw doctor --fix。
使用 openclaw config set 或 config.patch 只複製預定的金鑰回來。
如果您沒有最後已知良好的狀態或被拒絕的載荷，請從備份還原，或重新執行 openclaw doctor 並重新設定通道/模型。
如果這是出乎意料的，請回報 bug 並附上您最後已知的設定或任何備份。
本地編碼代理程式通常可以從日誌或歷史記錄重建可用的設定。

避免方式：

使用 openclaw config set 進行小幅變更。
使用 openclaw configure 進行互動式編輯。
當您不確定確切路徑或欄位形狀時，先使用 config.schema.lookup；它會返回淺層架構節點以及用於下鑽的直接子項摘要。
使用 config.patch 進行部分 RPC 編輯；僅將 config.apply 用於完整設定替換。
如果您從代理程式執行中使用僅限擁有者的 gateway 工具，它仍會拒絕對 tools.exec.ask / tools.exec.security 的寫入（包括正規化至相同受保護執行路徑的舊版 tools.bash.* 別名）。

文件：設定、組態設定、Gateway 故障排除、Doctor。

如何在跨設備的環境中運行中央 Gateway 與專屬 Workers？

常見的架構模式是一個 Gateway（例如 Raspberry Pi）加上節點和代理：

Gateway (中央)： 擁有通道、路由和工作階段。
Nodes (設備)： Mac/iOS/Android 作為外設連接並公開本機工具 (system.run, canvas, camera)。
Agents (Workers)： 用於特殊角色的獨立大腦/工作區（例如 “Hetzner ops”, “個人資料”）。
Sub-agents： 當您需要並行處理時，從主代理衍生背景工作。
TUI： 連接到 Gateway 並切換代理/工作階段。

文件：Nodes, Remote access, Multi-Agent Routing, Sub-agents, TUI。

OpenClaw 瀏覽器可以無頭模式執行嗎？

可以。這是一個設定選項：

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

預設為 false (有頭模式)。無頭模式在某些網站上更可能觸發反機器人檢查。參閱 Browser。

無頭模式使用相同的 Chromium 引擎，且適用於大多數自動化作業（表單、點擊、抓取、登入）。主要差異如下：

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

如何使用 Brave 進行瀏覽器控制？

將 browser.executablePath 設定為您的 Brave 執行檔（或任何基於 Chromium 的瀏覽器）並重新啟動 Gateway。請參閱 Browser 中的完整設定範例。

遠端 Gateway 和節點

指令如何在 Telegram、閘道與節點之間傳遞？

Telegram 訊息由 閘道（gateway） 處理。閘道會執行代理程式（agent），且僅在需要節點工具時，透過 Gateway WebSocket 呼叫節點：

Telegram → Gateway → Agent → node.* → Node → Gateway → Telegram

節點無法看見來自提供者的入站流量；它們只會接收節點 RPC 呼叫。

如果閘道是遠端託管，我的代理程式要如何存取我的電腦？

簡短回答：將您的電腦配對為節點。閘道在其他地方執行，但它可以透過 Gateway WebSocket 在您的本機上呼叫 node.* 工具（螢幕、相機、系統）。

典型設定：

在永遠連線的主機（VPS/家用伺服器）上執行閘道。
將閘道主機與您的電腦放在同一個 tailnet 中。
確保閘道 WS 可連線（tailnet bind 或 SSH tunnel）。
在本機開啟 macOS 應用程式，並以 Remote over SSH 模式（或直接透過 tailnet）連線，以便將其註冊為節點。

在閘道上批准該節點：

openclaw devices list
openclaw devices approve

不需要額外的 TCP 橋接器；節點透過 Gateway WebSocket 連線。

安全提醒：配對 macOS 節點會允許在該機器上進行 `system.run`。僅
配對您信任的裝置，並閱讀 [Security](/zh-Hant/gateway/security)。

文件：[Nodes](/zh-Hant/nodes)、[Gateway protocol](/zh-Hant/gateway/protocol)、[macOS remote mode](/zh-Hant/platforms/mac/remote)、[Security](/zh-Hant/gateway/security)。

Tailscale 已連線但我沒收到回應。現在該怎麼辦？

檢查基本事項：

Gateway 正在執行：openclaw gateway status
Gateway 健康狀態：openclaw status
頻道健康狀態：openclaw channels status

然後驗證認證與路由：

如果您使用 Tailscale Serve，請確保 gateway.auth.allowTailscale 設定正確。
如果您透過 SSH 隧道連線，請確認本機隧道已啟動並指向正確的連接埠。
確認您的允許清單（DM 或群組）包含您的帳號。

文件：Tailscale、遠端存取、頻道。

兩個 OpenClaw 實例可以互相通訊嗎（本機 + VPS）？

可以。目前沒有內建的「bot-to-bot」橋接器，但您可以透過幾種可靠的方式進行連線：

最簡單的方式： 使用兩個機器人都能存取的一般聊天頻道（Telegram/Slack/WhatsApp）。讓機器人 A 發送訊息給機器人 B，然後讓機器人 B 像往常一樣回覆。

CLI 橋接器（通用）： 執行一個腳本，使用 openclaw agent --message ... --deliver 呼叫另一個 Gateway，目標鎖定另一個機器人正在監聽的聊天室。如果其中一個機器人在遠端 VPS 上，請透過 SSH/Tailscale 將您的 CLI 指向該遠端 Gateway （請參閱遠端存取）。

範例模式（從可以連線到目標 Gateway 的機器上執行）：

openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to

提示：加入防護機制，以免兩個機器人無限循環（僅限提及、頻道
允許清單，或是「不回覆機器人訊息」規則）。

文件：[遠端存取](/zh-Hant/gateway/remote)、[Agent CLI](/zh-Hant/cli/agent)、[Agent send](/zh-Hant/tools/agent-send)。

多個代理是否需要分開的 VPS？

不需要。一個 Gateway 可以代管多個代理，每個代理都有自己的工作區、模型預設值和路由。這是標準設定，比每個代理運行一個 VPS 更便宜且簡單。

只有當您需要強隔離（安全邊界）或您不想分享的差異很大的設定時，才使用分開的 VPS。否則，請保留一個 Gateway 並使用多個代理或子代理。

比起從 VPS 使用 SSH，在我的個人筆記型電腦上使用節點有什麼好處嗎？

有的——節點是從遠端 Gateway 連接到您的筆記型電腦的首選方式，而且它們提供的不僅僅是 shell 存取權限。Gateway 運行於 macOS/Linux（Windows 透過 WSL2）並且輕量化（一台小型 VPS 或 Raspberry Pi 級別的設備即可；4 GB RAM 綽綽有餘），因此一種常見的設定是一台常駐主機加上您的筆記型電腦作為節點。

無需開放連入 SSH。 節點會主機連出至 Gateway WebSocket 並使用裝置配對。
更安全的執行控制。 system.run 會受到該筆記型電腦上的節點允許清單/批准的限制。
更多裝置工具。 除了 system.run 之外，節點還暴露 canvas、camera 和 screen。
本機瀏覽器自動化。 將 Gateway 保留在 VPS 上，但透過筆記型電腦上的節點主機在本機執行 Chrome，或透過 Chrome MCP 連接到主機上的本機 Chrome。

SSH 適合臨時的 shell 存取，但對於持續的代理工作流程和裝置自動化，節點更簡單。

文件：節點、節點 CLI、瀏覽器。

節點是否會執行 gateway 服務？

不會。除非您有意執行隔離的設定檔（請參閱多重 Gateway），否則每台主機應只執行 一個 gateway。節點是連接到 gateway 的周邊裝置（iOS/Android 節點，或是選單列應用程式中的 macOS「節點模式」）。關於無頭節點主機和 CLI 控制，請參閱節點主機 CLI。

對於 gateway、discovery 和託管外掛介面變更，需要完整重新啟動。

是否有 API / RPC 方式可以套用配置？

是的。

config.schema.lookup：在寫入前檢視一個設定子樹，包括其淺層架構節點、匹配的 UI 提示以及直接子項摘要
config.get：取得目前的快照 + 雜湊值
config.patch：安全的部分更新（大多數 RPC 編輯的首選）；盡可能進行熱重載，必要時重新啟動
config.apply：驗證並替換完整設定；盡可能進行熱重載，必要時重新啟動
僅限擁有者使用的 gateway 執行期工具仍會拒絕重寫 tools.exec.ask / tools.exec.security；舊版 tools.bash.* 別名會正規化為同一個受保護的執行路徑

初次安裝的最低合理設定

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

這會設定您的工作區並限制誰可以觸發機器人。

如何在 VPS 上設定 Tailscale 並從我的 Mac 連線？

最低步驟：

在 VPS 上安裝 + 登入

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

在您的 Mac 上安裝 + 登入
- 使用 Tailscale 應用程式並登入同一個 tailnet。
啟用 MagicDNS（建議）
- 在 Tailscale 管理主控台中啟用 MagicDNS，以便 VPS 擁有穩定的名稱。
使用 tailnet 主機名稱
- SSH：ssh [email protected]
- Gateway WS：ws://your-vps.tailnet-xxxx.ts.net:18789

如果您希望在無需 SSH 的情況下使用控制 UI，請在 VPS 上使用 Tailscale Serve：

openclaw gateway --tailscale serve

這會將閘道保持在 loopback 並透過 Tailscale 公開 HTTPS。請參閱 Tailscale。

如何將 Mac 節點連接到遠端 Gateway (Tailscale Serve)?

Serve 會公開 Gateway Control UI + WS。節點透過相同的 Gateway WS 端點進行連線。

建議的設定方式：

確保 VPS + Mac 位於同一個 tailnet 中。
在 Remote 模式下使用 macOS 應用程式 (SSH 目標可以是 tailnet 主機名稱)。應用程式將會對 Gateway 連接埠進行通道連線，並以節點身分連線。

在 gateway 上核准節點：

openclaw devices list
openclaw devices approve

文件：[Gateway 通訊協定](/zh-Hant/gateway/protocol)、[探索](/zh-Hant/gateway/discovery)、[macOS 遠端模式](/zh-Hant/platforms/mac/remote)。

我應該在第二台筆記型電腦上安裝，還是只需新增一個節點？

如果您只需要在第二台筆記型電腦上使用 本機工具 (screen/camera/exec)，請將其新增為節點。如此可以保持單一 Gateway 並避免重複的設定。本機節點工具目前僅支援 macOS，但我們計劃將其擴展到其他作業系統。

只有當您需要 強式隔離 或兩個完全獨立的機器人時，才安裝第二個 Gateway。

文件：節點、節點 CLI、多個 Gateway。

環境變數與 .env 載入

OpenClaw 如何載入環境變數？

OpenClaw 會從父程序 (shell、launchd/systemd、CI 等) 讀取環境變數，並另外載入：

目前工作目錄中的 .env
來自 ~/.openclaw/.env (亦稱 $OPENCLAW_STATE_DIR/.env) 的全域備援 .env

這兩個 .env 檔案都不會覆蓋現有的環境變數。

您也可以在設定中定義內聯環境變數 (僅在程序環境中缺少時才會套用)：

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

請參閱 /environment 以了解完整的優先順序和來源。

我透過服務啟動了 Gateway，但我的環境變數消失了。現在該怎麼辦？

兩個常見的修復方法：

將遺失的金鑰放在 ~/.openclaw/.env 中，這樣即使服務未繼承您的 shell 環境，也能讀取到這些金鑰。
啟用 shell 匯入（可選的便利功能）：

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

這會執行您的登入 shell 並僅匯入預期的遺失金鑰（絕不覆蓋）。等效的環境變數為： OPENCLAW_LOAD_SHELL_ENV=1, OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000。

我設定了 COPILOT_GITHUB_TOKEN，但模型狀態顯示「Shell env: off」。為什麼？

openclaw models status 回報是否已啟用 shell 環境變數匯入。「Shell env: off」並不表示您的環境變數遺失——它僅表示 OpenClaw 不會自動載入您的登入 shell。

如果 Gateway 作為服務（launchd/systemd）執行，它將不會繼承您的 shell 環境。請採用以下任一方式修復：

將 token 放在 ~/.openclaw/.env 中：
```
COPILOT_GITHUB_TOKEN=...
```
或啟用 shell 匯入（env.shellEnv.enabled: true）。
或將其新增至您的設定 env 區塊（僅在遺失時套用）。

然後重新啟動 gateway 並重新檢查：

openclaw models status

Copilot tokens 是從 COPILOT_GITHUB_TOKEN 讀取的（也可以是 GH_TOKEN / GITHUB_TOKEN）。請參閱 /concepts/model-providers 和 /environment。

Sessions and multiple chats

我要如何開始一個新的對話？

傳送 /new 或 /reset 作為獨立訊息。請參閱 Session management。

如果我不發送 /new，會話會自動重置嗎？

會話可能在 session.idleMinutes 後過期，但這是預設停用的（預設值為 0）。將其設為正值以啟用閒置過期。啟用後，閒置期間結束後的下一則 訊息將為該聊天金鑰啟動新的會話 ID。這不會刪除對話記錄——它只是啟動一個新會話。

{
  session: {
    idleMinutes: 240,
  },
}

有沒有辦法建立一個 OpenClaw 實例團隊（一個 CEO 和多個代理程式）？

有的，透過多代理程式路由和子代理程式。您可以建立一個協調器代理程式和幾個具有各自工作區和模型的工作代理程式。

話雖如此，這最好被視為一個有趣的實驗。這非常耗費 token，而且通常比使用一個具有不同會話的機器人效率更低。我們設想的典型模型是您與一個機器人對話，並使用不同的會話進行並行工作。該機器人也可以在需要時生成子代理程式。

文件：Multi-agent routing、Sub-agents、Agents CLI。

為什麼上下文在任務中途被截斷？如何防止這種情況？

會話上下文受限於模型的視窗。長時間的對話、大型工具輸出或許多檔案都可能觸發壓縮或截斷。

以下方法有幫助：

請機器人總結當前狀態並將其寫入檔案。
在長時間任務之前使用 /compact，並在切換主題時使用 /new。
將重要的上下文保留在工作區中，並請機器人讀回。
對於長時間或並行工作使用子代理程式，以保持主聊天較小。
如果這種情況經常發生，請選擇具有較大上下文視窗的模型。

如何在不解除安裝的情況下完全重置 OpenClaw？

使用 reset 指令：

openclaw reset

非互動式完全重置：

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

然後重新執行設定：

openclaw onboard --install-daemon

註記：

如果 Onboarding 發現既有設定，也會提供 Reset 選項。請參閱 Onboarding (CLI)。
如果您使用了設定檔 (--profile / OPENCLAW_PROFILE)，請重置各個狀態目錄（預設為 `~/.openclaw-

）。 - 開發重置：openclaw gateway —dev —reset`（僅限開發；會清除開發設定 + 憑證 + 工作階段 + 工作區）。

我遇到「context too large」錯誤 - 該如何重置或壓縮？

使用以下任一方式：

Compact（保留對話但總結較舊的輪次）：
```
/compact
```
或使用 `/compact

` 來引導摘要。

- **Reset**（為相同的聊天金鑰建立新的工作階段 ID）：

  ```
  /new
  /reset
  ```

如果持續發生：

- 啟用或調整 **session pruning**（`agents.defaults.contextPruning`）以修剪舊的工具輸出。
- 使用具有更大內容視窗的模型。

文件：[Compaction](/zh-Hant/concepts/compaction)、[Session pruning](/zh-Hant/concepts/session-pruning)、[Session management](/zh-Hant/concepts/session)。

為什麼我會看到「LLM request rejected: messages.content.tool_use.input field required」？

這是一個供應商驗證錯誤：模型發出了一個 tool_use 區塊但缺少必需的 input。這通常表示工作階段歷程記錄已過時或損毀（常發生於長對話串或工具/結構描述變更後）。

修正方法：使用 /new（獨立訊息）啟動新的工作階段。

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

心跳預設每 30 分鐘 執行一次（使用 OAuth 驗證時為 1 小時）。您可以調整或停用它們：

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

如果 HEARTBEAT.md 存在但實際上是空的（只有空行和像 # Heading 這樣的 markdown 標題），OpenClaw 會跳過心跳執行以節省 API 呼叫。如果檔案不存在，心跳仍會執行，並由模型決定該做什麼。

每個代理的覆寫使用 agents.list[].heartbeat。文件：Heartbeat。

我需要將「機器人帳號」新增到 WhatsApp 群組嗎？

不需要。OpenClaw 執行在 您自己的帳號 上，所以如果您在群組中，OpenClaw 就能看到它。預設情況下，群組回覆會被阻擋，直到您允許發送者 (groupPolicy: "allowlist")。

如果您只希望 您自己 能觸發群組回覆：

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

如何取得 WhatsApp 群組的 JID？

選項 1（最快）：追蹤日誌並在群組中發送測試訊息：

openclaw logs --follow --json

尋找以 @g.us 結尾的 chatId（或 from），例如： [email protected]。

選項 2（如果已經配置/加入白名單）：從配置列出群組：

openclaw directory groups list --channel whatsapp

文件：WhatsApp、Directory、Logs。

為什麼 OpenClaw 不在群組中回覆？

兩個常見原因：

提及閘門已開啟（預設）。您必須 @提及機器人（或符合 mentionPatterns）。
您配置了 channels.whatsapp.groups 但沒有 "*"，而且該群組不在白名單中。

參閱 Groups 和 Group messages。

群組/執行緒是否與私訊共享語境？

直接聊天預設會合併到主會話中。群組/頻道擁有自己的會話金鑰，而 Telegram 主題 / Discord 執行緒則是獨立的會話。請參閱群組和群組訊息。

我可以建立多少個工作區和代理程式？

沒有硬性限制。數十個（甚至數百個）都沒問題，但請留意：

**磁碟增長：**會話和逐字稿儲存在 `~/.openclaw/agents/

/sessions/` 下。 - **Token 成本：**更多代理程式代表更多的並行模型使用量。 - **營運開銷：**每個代理程式的認證設定檔、工作區和頻道路由。

建議：

- 為每個代理程式保留一個 **作用中** 的工作區 (`agents.defaults.workspace`)。
- 如果磁碟增長，請修剪舊的會話（刪除 JSONL 或儲存條目）。
- 使用 `openclaw doctor` 來找出孤立的工作區和設定檔不匹配的情況。

我可以同時執行多個機器人或聊天 (Slack) 嗎？該如何設定？

可以的。使用 多代理程式路由 (Multi-Agent Routing) 來執行多個隔離的代理程式，並透過頻道/帳戶/對等方路由傳入訊息。Slack 受支援為一種頻道，並可以綁定到特定的代理程式。

瀏覽器存取功能強大，但並非「能做到人類能做的一切」——反機器人措施、CAPTCHAs 和 MFA 仍可能阻擋自動化。為了獲得最可靠的瀏覽器控制，請在主機上使用本機 Chrome MCP，或在實際執行瀏覽器的機器上使用 CDP。

最佳實踐設定：

永遠上線的 Gateway 主機 (VPS/Mac mini)。
每個角色一個代理程式 (bindings)。
綁定到這些代理程式的 Slack 頻道。
必要時透過 Chrome MCP 或節點使用本機瀏覽器。

文件：多代理程式路由、Slack、瀏覽器、節點。

模型、故障轉移和驗證設定檔

模型常見問題 — 預設值、選擇、別名、切換、容錯移轉、認證設定檔 — 位於模型常見問題。

閘道器：連接埠、「已在執行」和遠端模式

閘道器使用哪個連接埠？

gateway.port 控制用於 WebSocket + HTTP（控制 UI、hooks 等）的單一多工連接埠。

優先順序：

--port > OPENCLAW_GATEWAY_PORT > gateway.port > default 18789

為什麼 openclaw gateway status 顯示 "Runtime: running" 但 "Connectivity probe: failed"？

因為 “running” 是監督程式（launchd/systemd/schtasks）的視角。連線偵測則是 CLI 實際連線到閘道器 WebSocket 的結果。

使用 openclaw gateway status 並相信這幾行：

Probe target: （偵測實際使用的 URL）
Listening: （連接埠上實際綁定的項目）
Last gateway error: （當程序存活但連接埠未監聽時的常見根本原因）

為什麼 openclaw gateway status 顯示的 "Config (cli)" 和 "Config (service)" 不同？

您正在編輯一個組態檔，但服務正在使用另一個（通常是 --profile / OPENCLAW_STATE_DIR 不匹配）。

修復方法：

openclaw gateway install --force

請從您希望服務使用的相同 --profile / 環境中執行該指令。

"another gateway instance is already listening" 是什麼意思？

OpenClaw 透過在啟動時立即綁定 WebSocket 監聽器來強制執行執行時鎖定（預設 ws://127.0.0.1:18789）。如果綁定失敗並出現 EADDRINUSE，它會拋出 GatewayLockError，表示另一個實例正在監聽。

修復方法：停止另一個實例、釋放連接埠，或使用 `openclaw gateway —port

` 執行。

我如何在遠端模式下執行 OpenClaw（客戶端連接到其他地方的 Gateway）？

設定 gateway.mode: "remote" 並指向一個遠端 WebSocket URL，可選地使用共享金鑰的遠端認證：

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

注意事項：

openclaw gateway 僅在 gateway.mode 為 local 時啟動（或者您傳遞了覆蓋旗標）。
macOS 應用程式會監看設定檔，並在這些值變更時即時切換模式。
gateway.remote.token / .password 僅為客戶端遠端認證；它們本身不啟用本機 gateway 認證。

控制 UI 顯示「未授權」（或持續重新連線）。該怎麼辦？

您的閘道驗證路徑與 UI 的驗證方法不符。

事實（來源代碼）：

控制 UI 將 Token 保留在 sessionStorage 中，僅限當前瀏覽器分頁階段與選定的閘道 URL，因此同分頁重新整理能持續運作，無需還原長效的 localStorage Token 持久性。
在 AUTH_TOKEN_MISMATCH 上，當閘道返回重試提示（canRetryWithDeviceToken=true、recommendedNextStep=retry_with_device_token）時，受信任的客戶端可嘗試一次有界的重試，使用快取的裝置 Token。
該快取 Token 重試現在會重複使用與裝置 Token 一同儲存的快取已批准範圍。明確的 deviceToken / 明確的 scopes 呼叫者仍會保留其要求的範圍集，而非繼承快取的範圍。
在該重試路徑之外，連線驗證優先順序為：明確的共用 Token/密碼優先，其次是明確的 deviceToken，接著是儲存的裝置 Token，最後是啟動 Token。
內建的設定代碼啟動僅限節點。批准後，它會傳回具有 scopes: [] 的節點裝置 Token，並不會傳回移交的操作者 Token。

修正方法：

最快的方法：openclaw dashboard（會列印並複製儀表板 URL，嘗試開啟；若是無頭模式則顯示 SSH 提示）。
如果您還沒有 Token：openclaw doctor --generate-gateway-token。
若為遠端：先建立通道：ssh -N -L 18789:127.0.0.1:18789 user@host 然後開啟 http://127.0.0.1:18789/。
共用密鑰模式：設定 gateway.auth.token / OPENCLAW_GATEWAY_TOKEN 或 gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD，然後在控制 UI 設定中貼上相符的密鑰。
Tailscale Serve 模式：請確保 gateway.auth.allowTailscale 已啟用，且您開啟的是 Serve URL，而非繞過 Tailscale 身分標頭的原始回送/tailnet URL。
受信任代理模式：請確保您是透過設定的身分感知代理連線，而非原始的閘道 URL。同主機回送代理也需要 gateway.auth.trustedProxy.allowLoopback = true。
若在一次重試後仍不一致，請輪替/重新批准配對的裝置 Token：
- openclaw devices list
- `openclaw devices rotate —device

—role operator`

若輪替呼叫顯示被拒絕，請檢查兩件事：
- 配對裝置階段只能輪替其自己的裝置，除非它們也擁有 operator.admin
- 明確的 --scope 值不能超過呼叫者目前的操作者範圍
仍然卡住？執行 openclaw status --all 並依照疑難排解操作。關於驗證詳情請參閱儀表板。

我設定了 gateway.bind tailnet 但它無法綁定且沒有任何監聽

tailnet bind 會從您的網路介面卡 (100.64.0.0/10) 中選取一個 Tailscale IP。如果機器不在 Tailscale 上 (或介面已停用)，就沒有可綁定的物件。

修正方法：

在該主機上啟動 Tailscale (使其擁有 100.x 位址)，或
切換至 gateway.bind: "loopback" / "lan"。

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

我可以在同一台主機上執行多個 Gateway 嗎？

通常不需要 - 一個 Gateway 可以執行多個訊息通道和代理程式。僅當您需要冗餘 (例如：救援機器人) 或強式隔離時才使用多個 Gateway。

可以，但您必須隔離：

OPENCLAW_CONFIG_PATH (每個執行個體的設定)
OPENCLAW_STATE_DIR (每個執行個體的狀態)
agents.defaults.workspace (工作區隔離)
gateway.port (唯一連接埠)

快速設定 (推薦)：

每個執行個體使用 `openclaw —profile

…(會自動建立~/.openclaw-

)。 - 在每個 profile 設定中設定唯一的 gateway.port(或在手動執行時傳遞—port)。 - 安裝針對各 profile 的服務：openclaw —profile

gateway install`。

Profiles 也會在服務名稱後加上後綴 (`ai.openclaw.

；舊版 com.openclaw.*, openclaw-gateway-

.service, OpenClaw Gateway (

)`)。完整指南：Multiple gateways。

什麼是「無效握手」/ 代碼 1008？

Gateway 是一個 WebSocket 伺服器，它期望收到的第一條訊息是一個 connect 幀。如果收到其他內容，它會以 代碼 1008（策略違規）關閉連線。

常見原因：

您在瀏覽器中打開了 HTTP URL (http://...) 而不是使用 WS 客戶端。
您使用了錯誤的連接埠或路徑。
代理或隧道移除了身份驗證標頭或發送了非 Gateway 請求。

快速修復：

使用 WS URL：`ws://

:18789（如果是 HTTPS 則使用 wss://…）。 2. 不要在正常的瀏覽器分頁中打開 WS 連接埠。 3. 如果開啟了身份驗證，請在 connect` 幀中包含令牌/密碼。

如果您使用的是 CLI 或 TUI，URL 應類似於：

```
openclaw tui --url ws://

:18789 —token

協議詳情：[Gateway 協議](/zh-Hant/gateway/protocol)。

日誌記錄與除錯

日誌在哪裡？

檔案日誌（結構化）：

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

您可以通過 logging.file 設置穩定的路徑。檔案日誌級別由 logging.level 控制。控制台詳細程度由 --verbose 和 logging.consoleLevel 控制。

最快的日誌追蹤：

openclaw logs --follow

服務/監督者日誌（當 gateway 通過 launchd/systemd 運行時）：

macOS launchd stdout：~/Library/Logs/openclaw/gateway.log（設定檔使用 `gateway-

.log；stderr 被抑制） - Linux：journalctl —user -u openclaw-gateway[-

].service -n 200 —no-pager - Windows：schtasks /Query /TN “OpenClaw Gateway (

)” /V /FO LIST`

更多資訊請參閱 [疑難排解](/zh-Hant/gateway/troubleshooting)。

如何啟動/停止/重新啟動 Gateway 服務？

使用 gateway 輔助工具：

openclaw gateway status
openclaw gateway restart

如果您手動運行 gateway，openclaw gateway --force 可以回收連接埠。參閱 Gateway。

我在 Windows 上關閉了終端機 - 如何重新啟動 OpenClaw？

有 兩種 Windows 安裝模式：

1) WSL2（推薦）： Gateway 在 Linux 內運行。

開啟 PowerShell，進入 WSL，然後重新啟動：

wsl
openclaw gateway status
openclaw gateway restart

如果您從未安裝過該服務，請在前台啟動它：

openclaw gateway run

2) 原生 Windows（不推薦）： Gateway 直接在 Windows 中運行。

開啟 PowerShell 並執行：

openclaw gateway status
openclaw gateway restart

如果您手動運行它（無服務），請使用：

openclaw gateway run

文件：Windows (WSL2)、Gateway 服務手冊。

Gateway 已啟動但回應從未到達。我應該檢查什麼？

首先進行快速健康檢查：

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

常見原因：

模型驗證未在 gateway host 上載入（請檢查 models status）。
頻道配對/允許清單封鎖了回應（請檢查頻道設定 + 記錄）。
WebChat/Dashboard 已開啟但沒有正確的 token。

如果您是遠端連線，請確認 tunnel/Tailscale 連線已啟動，且 Gateway WebSocket 可連接。

文件：Channels、Troubleshooting、Remote access。

"Disconnected from gateway: no reason" - 現在該怎麼辦？

這通常表示 UI 失去了 WebSocket 連線。請檢查：

Gateway 是否正在運行？ openclaw gateway status
Gateway 是否健康？ openclaw status
UI 是否有正確的 token？ openclaw dashboard
若為遠端連線，tunnel/Tailscale 連線是否已啟動？

然後查看記錄：

openclaw logs --follow

文件：Dashboard、Remote access、Troubleshooting。

Telegram setMyCommands 失敗。我該檢查什麼？

首先檢查日誌和通道狀態：

openclaw channels status
openclaw channels logs --channel telegram

然後根據錯誤進行匹配：

BOT_COMMANDS_TOO_MUCH：Telegram 選單項目過多。OpenClaw 已經將內容修剪至 Telegram 限制並以較少的指令重試，但某些選單項目仍需要被移除。請減少插件/技能/自訂指令，或者如果您不需要選單，請停用 channels.telegram.commands.native。
TypeError: fetch failed、Network request for 'setMyCommands' failed! 或類似的網路錯誤：如果您在 VPS 上或位於代理伺服器之後，請確認允許傳出 HTTPS 且 api.telegram.org 的 DNS 運作正常。

如果 Gateway 是遠端的，請確保您正在查看 Gateway 主機上的日誌。

文件：Telegram、通道疑難排解。

TUI 沒有顯示輸出。我該檢查什麼？

首先確認 Gateway 可以連線且 Agent 可以執行：

openclaw status
openclaw models status
openclaw logs --follow

在 TUI 中，使用 /status 查看當前狀態。如果您預期在聊天通道中收到回覆，請確保已啟用傳遞功能 (/deliver on)。

文件：TUI、斜線指令。

如何完全停止然後啟動 Gateway？

如果您已安裝服務：

openclaw gateway stop
openclaw gateway start

這會停止/啟動 監控服務 (macOS 上為 launchd，Linux 上為 systemd)。當 Gateway 作為背景守護程序運行時，請使用此方法。

如果您在前台運行，請使用 Ctrl-C 停止，然後執行：

openclaw gateway run

文件：Gateway 服務手冊。

ELI5: openclaw gateway restart vs openclaw gateway

openclaw gateway restart：重新啟動背景服務（launchd/systemd）。
openclaw gateway：在目前終端機階段中於前景執行閘道。

如果您已安裝服務，請使用 gateway 指令。當您想要進行一次性、前景執行時，請使用 openclaw gateway。

Fastest way to get more details when something fails

使用 --verbose 啟動閘道以取得更多主控台詳細資訊。然後檢查日誌檔中的通道驗證、模型路由和 RPC 錯誤。

媒體與附件

My skill generated an image/PDF, but nothing was sent

來自代理的傳出附件必須包含一個 `MEDIA:

` 行（獨自一行）。請參閱 OpenClaw assistant setup 和 Agent send。

CLI 傳送方式：

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

另請檢查：

- 目標通道支援傳出媒體且未被允許清單封鎖。
- 檔案在供應商的大小限制內（圖片會調整大小至最大 2048px）。
- `tools.fs.workspaceOnly=true` 將本地路徑傳送限制在工作區、temp/media-store 和沙箱驗證的檔案。
- `tools.fs.workspaceOnly=false` 允許 `MEDIA:` 傳送代理已可讀取的主機本地檔案，但僅限於媒體和安全文件類型（圖片、音訊、視訊、PDF 和 Office 文件）。純文字和類似機密的檔案仍會被封鎖。

參閱 [Images](/zh-Hant/nodes/images)。

安全與存取控制

讓 OpenClaw 接收傳入的私人訊息 (DM) 是否安全？

將傳入的私人訊息視為不受信任的輸入。預設值旨在降低風險：

支援私人訊息的頻道，其預設行為是配對：
- 未知的發送者會收到配對碼；機器人不會處理其訊息。
- 使用以下指令批准：`openclaw pairing approve —channel

[—account

]

      - 待處理的請求上限為 **每頻道 3 個**；如果未收到代碼，請檢查openclaw pairing list —channel
[—account
]。     - 公開開放私人訊息需要明確選擇加入 (dmPolicy: “open”和允許清單”*”`)。
執行 `openclaw doctor` 以顯示具有風險的私人訊息政策。

提示詞注入 (Prompt injection) 是否只是公開機器人的顧慮？
不。提示詞注入涉及的是 不受信任的內容，而不僅僅是誰可以傳送私人訊息給機器人。
如果您的助理讀取外部內容 (網頁搜尋/擷取、瀏覽器頁面、電子郵件、
文件、附件、貼上的記錄)，該內容可能包含試圖
挾持模型的指令。即使 只有您是發送者，這也可能發生。
最大的風險在於啟用工具時：模型可能被誘騙而
外泄上下文或代表您呼叫工具。您可以透過以下方式降低影響範圍：

使用唯讀或停用工具的「讀者」代理程式來總結不受信任的內容
針對啟用工具的代理程式，將 web_search / web_fetch / browser 保持關閉
將解碼後的檔案/文件文字也視為不受信任：OpenResponses
input_file 和媒體附件擷取功能都會將擷取的文字包裝在
明確的外部內容邊界標記中，而不是直接傳遞原始檔案文字
沙箱機制與嚴格的工具允許清單

詳細資訊：Security。
我的機器人應該有自己的電子郵件、GitHub 帳號或電話號碼嗎？
是的，對於大多數設定而言。使用獨立的帳號和電話號碼將機器人隔離
可以在發生問題時減輕受影響的範圍。這也讓輪換憑證
或撤銷存取權限變得更容易，且不會影響您的個人帳號。
從小處著手。只授予您實際需要的工具和帳號存取權，並在
需要時再進行擴充。
文件：安全性、配對。
我可以讓它自主處理我的簡訊，這樣安全嗎？
我們不建議讓其完全控制您的個人訊息。最安全的模式是：

將私訊保持在 配對模式 或嚴格的允許清單中。
如果您希望它代表您發送訊息，請使用 獨立的號碼或帳號。
讓它起草內容，然後 在發送前進行審核。

如果您想嘗試，請在專用帳號上進行並保持隔離。請參閱
安全性。
我可以在個人助理任務中使用較便宜的模型嗎？
可以，前提是代理程式僅用於聊天且輸入內容是受信任的。較小的等級 更容易受到指令劫持，因此請避免將其用於啟用工具的代理程式 或在讀取不受信任的內容時使用。如果您必須使用較小的模型，請鎖定 工具並在沙盒中執行。請參閱 安全性。
我在 Telegram 中執行了 /start 但沒有收到配對碼
配對碼僅在未知發送者傳送訊息給機器人且
已啟用 dmPolicy: "pairing" 時才會傳送。僅使用 /start 本身並不會產生代碼。
檢查待處理的要求：
Terminal window
openclaw pairing list telegram

如果您希望立即存取，請將您的發送者 ID 加入允許清單或為該帳號設定 dmPolicy: "open"
。
WhatsApp：它會訊息我的聯絡人嗎？配對運作方式為何？
不會。預設的 WhatsApp 私訊 (DM) 政策為配對。未知的發送者只會收到配對碼，且其訊息不會被處理。OpenClaw 只會回覆它收到的聊天或您觸發的明確發送。
透過以下方式核准配對：
Terminal window
openclaw pairing approve whatsapp
列出待處理請求：

```bash
openclaw pairing list whatsapp

精靈電話號碼提示：它是用來設定您的允許清單/擁有者，以便允許您自己的私訊。它不用於自動發送。如果您在個人的 WhatsApp 號碼上執行，請使用該號碼並啟用 channels.whatsapp.selfChatMode。

聊天指令、中止任務，以及「它無法停止」

如何停止內部系統訊息顯示在聊天中？

大多數內部或工具訊息只會在該工作階段啟用詳細、追蹤或推理時出現。

在您看到訊息的聊天中修正：

/verbose off
/trace off
/reasoning off

如果仍然顯得嘈雜，請檢查控制 UI 中的工作階段設定，並將詳細模式設定為繼承。同時確認您沒有使用在設定中將 verboseDefault 設定為 on 的機器人設定檔。

文件：Thinking and verbose、Security。

如何停止/取消正在執行的任務？

發送以下任一訊息作為獨立訊息（無斜線）：

stop
stop action
stop current action
stop run
stop current run
stop agent
stop the agent
stop openclaw
openclaw stop
stop don't do anything
stop do not do anything
stop doing anything
please stop
stop please
abort
esc
wait
exit
interrupt

這些是中止觸發器（不是斜線指令）。

對於背景程序（來自 exec 工具），您可以要求代理執行：

process action:kill sessionId:XXX

斜線指令概覽：請參閱 Slash commands。

大多數指令必須作為以 / 開頭的獨立訊息發送，但少數捷徑（例如 /status）對允許清單上的發送者也可內聯使用。

我如何從 Telegram 發送 Discord 訊息？（「跨內容訊息被拒絕」）

OpenClaw 預設會封鎖跨供應商的訊息傳遞。如果工具呼叫綁定到 Telegram，除非您明確允許，否則它不會傳送到 Discord。

為代理程式啟用跨供應商訊息傳遞：

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

編輯設定後請重新啟動閘道。

為什麼感覺機器人會「忽略」快速連發的訊息？

預設情況下，執行中的提示會被引導至活躍的執行中。使用 /queue 來選擇活躍執行的行為：

steer - 在下一個模型邊界引導活躍執行
followup - 將訊息加入佇列，並在當前執行結束後逐一執行
collect - 將相容訊息加入佇列，並在當前執行結束後回覆一次
interrupt - 中止當前執行並重新開始

預設模式為 steer。您可以為佇列模式新增 debounce:0.5s cap:25 drop:summarize 等選項。參閱 Command queue 和 Steering queue。

其他

使用 API 金鑰時 Anthropic 的預設模型是什麼？

在 OpenClaw 中，憑證與模型選擇是分開的。設定 ANTHROPIC_API_KEY（或在設定檔中儲存 Anthropic API 金鑰）可啟用驗證，但實際的預設模型是您在 agents.defaults.model.primary 中設定的任何模型（例如 anthropic/claude-sonnet-4-6 或 anthropic/claude-opus-4-6）。如果您看到 No credentials found for profile "anthropic:default"，這表示 Gateway 在預期的 auth-profiles.json 中找不到正在執行的代理程式的 Anthropic 憑證。

還是卡住了？在 Discord 提問或開啟 GitHub discussion。