OpenClaw
GitHub立即開始
深入配置

OpenClaw 設定教學 - AI 模型與聊天頻道設定

已經安裝 OpenClaw？了解如何配置 AI 模型、閘道設定、聊天頻道等

您想配置什麼？

選擇您要配置的內容，快速跳轉到對應章節

OpenClaw 設定總覽

OpenClaw 將所有配置儲存在 ~/.openclaw 目錄中。了解這個結構有助於您管理和備份設定。

檔案結構

~/.openclaw/openclaw.json主配置檔案
~/.openclaw/workspace/技能、提示詞、記憶
~/.openclaw/credentials/OAuth 和 API 憑證
~/.openclaw/agents/多代理配置
~/.openclaw/credentials/oauth.jsonOAuth 令牌（Claude 等）

OpenClaw AI 模型設定

必要

OpenClaw 支援多種 AI 供應商。選擇您偏好的供應商並按照步驟設定。

目前配置:Anthropic - API Key

最適合：標準 API 訪問和使用量計費。在 Anthropic 控制台建立您的 API 金鑰。

1

取得 API 金鑰

從 Anthropic 控制台建立 API 金鑰

開啟 Anthropic 控制台
2

CLI 設定

執行配置精靈或使用非交互模式

交互式（推薦）

$ openclaw onboard
# choose: Anthropic API key

非交互式

$ openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

配置檔案結構

配置完成後，openclaw.json 中的相關配置如下：

~/.openclaw/openclaw.json
{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}

提示快取（僅限 API）

OpenClaw 不會覆蓋 Anthropic 的預設快取 TTL，除非您設定它。訂閱認證不遵守 TTL 設定。

~/.openclaw/openclaw.json
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": {
          params: { cacheControlTtl: "5m" }, // or "1h"
        },
      },
    },
  },
}

驗證配置

$ openclaw models status

執行此命令確認認證配置是否生效

推薦使用 Anthropic Claude 以獲得最佳體驗。支援的模型：anthropic/claude-opus-4-5、anthropic/claude-sonnet-4-20250514、anthropic/claude-haiku 等。
注意：認證是按代理（agent）獨立的，新建代理需要單獨配置憑證。

OpenClaw 閘道設定

必要

閘道是 OpenClaw 的核心服務，處理 AI 和聊天平台之間的所有訊息路由。

預設設定

連接埠
18789
綁定地址
127.0.0.1
認證方式
token / password

常用指令

安裝 Daemon 服務（自動識別 macOS/Linux）

$ openclaw gateway install

檢查閘道狀態

$ openclaw gateway status

查看即時日誌

$ openclaw logs --follow

遠端存取

透過 SSH 隧道安全存取遠端伺服器上的閘道：

$ ssh -N -L 18789:127.0.0.1:18789 user@host
查看完整閘道文件

OpenClaw 聊天頻道設定

至少一個

將 OpenClaw 連接到您偏好的聊天平台。每個頻道都有自己的設定流程。

目前配置:WhatsApp
1

WhatsApp 帳戶管理

登入或登出 WhatsApp 帳戶

登入（產生 QR 碼）

$ openclaw channels login whatsapp

登出（需要重新連接時使用）

$ openclaw channels logout whatsapp
2

掃描 QR 碼

在手機上開啟 WhatsApp，前往設定 → 已連結的裝置 → 掃描 QR 碼

QR 碼

使用 WhatsApp 手機應用程式掃描

3

批准配對

您的第一則訊息會收到配對碼。批准它即可開始聊天。

$ openclaw pairing list whatsapp
$ openclaw pairing approve whatsapp [CODE]
使用專用電話號碼。不建議使用 VoIP 號碼，容易被封鎖。
憑證儲存在 ~/.openclaw/credentials/whatsapp/ 目錄。
查看完整 WhatsApp 配置文件

OpenClaw 技能管理

選用

技能擴展 OpenClaw 的功能。安裝和管理技能以增強您的 AI 助手。

列出可用技能

$ openclaw skills list

安裝技能

$ openclaw skills install <skill-name>

啟用技能

$ openclaw skills enable <skill-name>

熱門技能

網頁搜尋

搜尋網頁並總結結果

web-search
程式碼解譯器

在沙盒環境中執行程式碼

code-interpreter
檔案管理器

讀取、寫入和管理檔案

file-manager
日曆

管理日曆事件和提醒

calendar
查看完整技能配置文件

OpenClaw 進階設定

選用

適用於複雜設定和自動化的進階用戶功能。

多代理設定

為不同情境（工作、個人等）建立獨立的代理。每個代理都有自己的工作區、會話和憑證。

$ openclaw agents add work
$ openclaw agents list
$ openclaw agents switch work

非互動模式

在腳本或 CI/CD 流程中自動化 OpenClaw 設定。

$ openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

定時任務

使用 cron 樣式的排程設定自動化訊息和任務。

cron.json
# ~/.openclaw/cron.json
{
  "jobs": [
    {
      "schedule": "0 9 * * *",
      "action": "send",
      "channel": "telegram",
      "message": "Good morning! Here's your daily briefing..."
    }
  ]
}
查看完整進階配置文件

配置設定完成！

您的 OpenClaw 已完全配置完成。開始與您的 AI 助手聊天吧。

下一步