OpenClaw 配置编辑：完整设置指南 (2026)

TL;DR (快速参考)

最常用的 OpenClaw 配置命令快速参考：

bash

# 打开配置编辑器
openclaw config edit

# 设置特定值
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# 查看当前配置
openclaw config show

# 验证并修复配置问题
openclaw doctor
openclaw doctor --fix

# 重置为默认值
openclaw config reset

什么是 OpenClaw？

OpenClaw 是一个开源 AI 助手框架，可将大语言模型连接到 WhatsApp、Discord、Telegram 和 Slack 等消息通道。它支持多种模型提供商 —— OpenAI、Anthropic、Ollama（本地模型）、Google 等 —— 并可以通过自定义技能和插件进行扩展。

OpenClaw 的核心是其配置系统。几乎所有内容 —— 哪些通道处于激活状态、使用哪个模型、加载哪些技能 —— 都通过配置文件控制。掌握 openclaw config edit 是按你所需运行 OpenClaw 的关键。

openclaw config edit：基础知识

打开配置编辑器

配置 OpenClaw 的主要命令是：

bash

openclaw config edit

这将在你的默认终端编辑器（通常是 nano、vim 或 $EDITOR 环境变量设置的编辑器）中打开配置文件。根据安装方式的不同，配置文件通常位于 ~/.openclaw/config.yaml 或 ~/.config/openclaw/config.yaml。

配置文件结构

OpenClaw 配置文件采用 YAML 格式，分为以下几个部分：

yaml

# 模型配置
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # 模型标识符字符串
  temperature: 0.7
  max_tokens: 4096

# 通道配置
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# 技能与插件
skills:
  - web_search
  - calculator
  - weather

# 语音转文本 (STT)
stt:
  provider: whisper
  model: whisper-1

# 系统提示词
system_prompt: "You are a helpful assistant."

设置单个数值

除了编辑整个文件，你也可以从命令行设置单个配置值：

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

这对于脚本编写或在不打开编辑器的情况下进行快速更改非常有用。

设置通道

WhatsApp 集成需要 Meta Business 账户和 WhatsApp Business API 访问权限。

bash

# 启用 WhatsApp 通道
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

常见问题： WhatsApp 需要一个 Webhook URL。你需要使用反向代理（nginx、Caddy）或隧道服务（ngrok、Cloudflare Tunnel）将 OpenClaw 暴露到互联网。

bash

# 设置 webhook URL
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Discord 的设置更为简单 —— 你只需要从 Discord Developer Portal 获取一个机器人令牌（bot token）。

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

提示： 请确保在 Developer Portal 中为你的 Discord 机器人启用了 "Message Content" 特权意图（privileged intent），否则它将无法读取消息内容。

Telegram 需要从 @BotFather 获取机器人令牌：

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram 支持轮询（polling）和 webhook 两种模式。轮询模式对开发更友好（不需要公网 URL）：

bash

openclaw config set channels.telegram.mode polling

对于生产环境，请使用 webhook 模式：

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

Slack 集成使用 Socket 模式（推荐）或 Events API：

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

推荐使用 Socket 模式，因为它不需要公网 URL。

配置模型提供商

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

将你的 API 密钥设置为环境变量（不要放入配置文件中）：

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (本地模型)

对于注重隐私的用户来说，这正是 OpenClaw 的闪光点。Ollama 让你可以在本地运行模型，无需 API 密钥，数据也不会离开你的机器。

bash

# 首先安装 Ollama
# https://ollama.ai

# 拉取模型
ollama pull llama3.3

# 配置 OpenClaw 使用 Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

常见问题： 如果 OpenClaw 无法连接到 Ollama，请确保 Ollama 正在运行（ollama serve）且基础 URL 匹配。Ollama 的默认端口是 11434。

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI 使用与 OpenAI 兼容的 API
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # 在 OpenAI 提供商配置下使用 xAI 密钥

常见配置错误及修复

错误："Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

这通常意味着配置键中存在拼写错误。请检查拼写。常见错误：

chanels → channels

providr → provider

telgram → telegram

运行 openclaw config show 查看所有有效的键。

错误："Channel auto-enabled without credentials"

某些 OpenClaw 版本会在你设置凭据时自动启用通道，即使你还没有显式启用它们。如果凭据不完整，这可能导致启动失败。

修复：

bash

# 显式禁用你不使用的通道
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

错误："Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

你需要设置相应的环境变量。出于安全原因，OpenClaw 特意不在配置文件中存储 API 密钥。

修复： 将 API 密钥添加到你的 shell 配置文件（~/.bashrc，~/.zshrc）或使用 .env 文件：

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

使用 openclaw doctor

openclaw doctor 命令会验证你的整个配置并报告问题：

bash

openclaw doctor

输出示例：

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

--fix 标志会尝试自动解决问题：

bash

openclaw doctor --fix

这将禁用缺少凭据的通道，纠正已知的格式问题，并对无法自动解决的问题提供手动修复建议。

高级配置

自定义技能

OpenClaw 支持自定义技能（插件）来扩展助手的能力：

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

或者通过命令行：

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

语音转文本 (STT) 配置

要在 WhatsApp 和 Telegram 上支持语音消息：

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # 自动检测或指定 "en", "zh" 等

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

涂鸦 (Tuya) 智能家居集成

OpenClaw 可以控制兼容涂鸦的智能家居设备：

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

这让你可以通过任何已连接通道的自然语言命令来控制灯光、开关、恒温器和其他涂鸦设备。

多模型配置

你可以定义模型预设并在它们之间切换：

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# 或在运行时切换
openclaw --model fast

常见问题解答

OpenClaw 配置文件存储在哪里？

默认位置是 ~/.openclaw/config.yaml。在某些安装中，它可能位于 ~/.config/openclaw/config.yaml。运行 openclaw config show --path 查看确切位置。

我可以在不使用任何云端 API 的情况下使用 OpenClaw 吗？

可以。将 Ollama 配置为你的模型提供商，并以轮询（polling）模式使用 Telegram。这样你就拥有了一个完全本地化、私密的 AI 助手，数据不会离开你的机器。

如何更新 OpenClaw？

bash

pip install --upgrade openclaw
# 或者
npm update -g openclaw

更新后，运行 openclaw doctor 检查是否有任何配置格式更改。

我可以同时运行多个通道吗？

可以。你可以启用任意数量的通道 —— OpenClaw 会并发处理它们。每个通道共享相同的模型和技能配置。

如何将配置重置为默认值？

bash

openclaw config reset

这将用默认模板覆盖你的配置文件。如果需要，请先备份现有配置。

想要更简单的方案？

OpenClaw 功能强大，但需要熟悉终端和手动配置。如果你想在不管理配置文件、模型提供商和通道集成的情况下构建并发布 AI 产品：

Y Build 处理全栈流程 —— 部署、产品视频、AI SEO 和分析。无需配置文件，无需终端。只需构建并发布。免费开始 →

参考资料：

TL;DR (快速参考)

最常用的 OpenClaw 配置命令快速参考：

bash

# 打开配置编辑器
openclaw config edit

# 设置特定值
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# 查看当前配置
openclaw config show

# 验证并修复配置问题
openclaw doctor
openclaw doctor --fix

# 重置为默认值
openclaw config reset

什么是 OpenClaw？

openclaw config edit：基础知识

打开配置编辑器

配置 OpenClaw 的主要命令是：

bash

openclaw config edit

配置文件结构

OpenClaw 配置文件采用 YAML 格式，分为以下几个部分：

yaml

# 模型配置
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # 模型标识符字符串
  temperature: 0.7
  max_tokens: 4096

# 通道配置
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# 技能与插件
skills:
  - web_search
  - calculator
  - weather

# 语音转文本 (STT)
stt:
  provider: whisper
  model: whisper-1

# 系统提示词
system_prompt: "You are a helpful assistant."

设置单个数值

除了编辑整个文件，你也可以从命令行设置单个配置值：

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

这对于脚本编写或在不打开编辑器的情况下进行快速更改非常有用。

设置通道

WhatsApp 集成需要 Meta Business 账户和 WhatsApp Business API 访问权限。

bash

# 启用 WhatsApp 通道
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

常见问题： WhatsApp 需要一个 Webhook URL。你需要使用反向代理（nginx、Caddy）或隧道服务（ngrok、Cloudflare Tunnel）将 OpenClaw 暴露到互联网。

bash

# 设置 webhook URL
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Discord 的设置更为简单 —— 你只需要从 Discord Developer Portal 获取一个机器人令牌（bot token）。

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

提示： 请确保在 Developer Portal 中为你的 Discord 机器人启用了 "Message Content" 特权意图（privileged intent），否则它将无法读取消息内容。

Telegram 需要从 @BotFather 获取机器人令牌：

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram 支持轮询（polling）和 webhook 两种模式。轮询模式对开发更友好（不需要公网 URL）：

bash

openclaw config set channels.telegram.mode polling

对于生产环境，请使用 webhook 模式：

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

Slack 集成使用 Socket 模式（推荐）或 Events API：

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

推荐使用 Socket 模式，因为它不需要公网 URL。

配置模型提供商

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

将你的 API 密钥设置为环境变量（不要放入配置文件中）：

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (本地模型)

对于注重隐私的用户来说，这正是 OpenClaw 的闪光点。Ollama 让你可以在本地运行模型，无需 API 密钥，数据也不会离开你的机器。

bash

# 首先安装 Ollama
# https://ollama.ai

# 拉取模型
ollama pull llama3.3

# 配置 OpenClaw 使用 Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

常见问题： 如果 OpenClaw 无法连接到 Ollama，请确保 Ollama 正在运行（ollama serve）且基础 URL 匹配。Ollama 的默认端口是 11434。

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI 使用与 OpenAI 兼容的 API
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # 在 OpenAI 提供商配置下使用 xAI 密钥

常见配置错误及修复

错误："Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

这通常意味着配置键中存在拼写错误。请检查拼写。常见错误：

chanels → channels

providr → provider

telgram → telegram

运行 openclaw config show 查看所有有效的键。

错误："Channel auto-enabled without credentials"

某些 OpenClaw 版本会在你设置凭据时自动启用通道，即使你还没有显式启用它们。如果凭据不完整，这可能导致启动失败。

修复：

bash

# 显式禁用你不使用的通道
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

错误："Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

你需要设置相应的环境变量。出于安全原因，OpenClaw 特意不在配置文件中存储 API 密钥。

修复： 将 API 密钥添加到你的 shell 配置文件（~/.bashrc，~/.zshrc）或使用 .env 文件：

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

使用 openclaw doctor

openclaw doctor 命令会验证你的整个配置并报告问题：

bash

openclaw doctor

输出示例：

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

--fix 标志会尝试自动解决问题：

bash

openclaw doctor --fix

这将禁用缺少凭据的通道，纠正已知的格式问题，并对无法自动解决的问题提供手动修复建议。

高级配置

自定义技能

OpenClaw 支持自定义技能（插件）来扩展助手的能力：

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

或者通过命令行：

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

语音转文本 (STT) 配置

要在 WhatsApp 和 Telegram 上支持语音消息：

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # 自动检测或指定 "en", "zh" 等

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

涂鸦 (Tuya) 智能家居集成

OpenClaw 可以控制兼容涂鸦的智能家居设备：

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

这让你可以通过任何已连接通道的自然语言命令来控制灯光、开关、恒温器和其他涂鸦设备。

多模型配置

你可以定义模型预设并在它们之间切换：

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# 或在运行时切换
openclaw --model fast

常见问题解答

OpenClaw 配置文件存储在哪里？

默认位置是 ~/.openclaw/config.yaml。在某些安装中，它可能位于 ~/.config/openclaw/config.yaml。运行 openclaw config show --path 查看确切位置。

我可以在不使用任何云端 API 的情况下使用 OpenClaw 吗？

如何更新 OpenClaw？

bash

pip install --upgrade openclaw
# 或者
npm update -g openclaw

更新后，运行 openclaw doctor 检查是否有任何配置格式更改。

我可以同时运行多个通道吗？

可以。你可以启用任意数量的通道 —— OpenClaw 会并发处理它们。每个通道共享相同的模型和技能配置。

如何将配置重置为默认值？

bash

openclaw config reset

这将用默认模板覆盖你的配置文件。如果需要，请先备份现有配置。

想要更简单的方案？

OpenClaw 功能强大，但需要熟悉终端和手动配置。如果你想在不管理配置文件、模型提供商和通道集成的情况下构建并发布 AI 产品：

Y Build 处理全栈流程 —— 部署、产品视频、AI SEO 和分析。无需配置文件，无需终端。只需构建并发布。免费开始 →

参考资料：