Chỉnh sửa Cấu hình OpenClaw: Hướng dẫn Thiết lập Đầy đủ (2026)

Q: Tệp cấu hình OpenClaw được lưu trữ ở đâu?

Vị trí mặc định là ~/.openclaw/config.yaml. Trên một số bản cài đặt, nó có thể nằm tại ~/.config/openclaw/config.yaml. Chạy openclaw config show --path để xem vị trí chính xác.

Q: Làm thế nào để cập nhật OpenClaw?

```bash pip install --upgrade openclaw

Q: Làm cách nào để đặt lại cấu hình về mặc định?

```bash openclaw config reset ```

TL;DR

Tham khảo nhanh các lệnh cấu hình OpenClaw phổ biến nhất:

bash

# Mở trình chỉnh sửa cấu hình
openclaw config edit

# Thiết lập một giá trị cụ thể
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Xem cấu hình hiện tại
openclaw config show

# Kiểm tra và khắc phục các vấn đề cấu hình
openclaw doctor
openclaw doctor --fix

# Đặt lại về mặc định
openclaw config reset

OpenClaw là gì?

OpenClaw là một framework trợ lý AI mã nguồn mở kết nối các mô hình ngôn ngữ lớn với các kênh nhắn tin như WhatsApp, Discord, Telegram và Slack. Nó hỗ trợ nhiều nhà cung cấp mô hình — OpenAI, Anthropic, Ollama (mô hình cục bộ), Google, và nhiều hơn nữa — đồng thời có thể mở rộng với các kỹ năng (skills) và plugin tùy chỉnh.

Cốt lõi của OpenClaw là hệ thống cấu hình của nó. Gần như mọi thứ — kênh nào đang hoạt động, mô hình nào được sử dụng, kỹ năng nào được tải — đều được kiểm soát thông qua các tệp cấu hình. Thành thạo openclaw config edit là chìa khóa để vận hành OpenClaw theo cách bạn muốn.

openclaw config edit: Những kiến thức cơ bản

Mở trình chỉnh sửa cấu hình

Lệnh chính để cấu hình OpenClaw là:

bash

openclaw config edit

Lệnh này sẽ mở tệp cấu hình của bạn trong trình chỉnh sửa terminal mặc định (thường là nano, vim, hoặc bất kỳ trình chỉnh sửa nào được thiết lập trong biến $EDITOR). Tệp cấu hình thường nằm tại ~/.openclaw/config.yaml hoặc ~/.config/openclaw/config.yaml tùy thuộc vào cách cài đặt của bạn.

Cấu trúc tệp cấu hình

Tệp cấu hình OpenClaw có định dạng YAML và được tổ chức thành các phần:

yaml

# Cấu hình mô hình
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # chuỗi định danh mô hình
  temperature: 0.7
  max_tokens: 4096

# Cấu hình kênh
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: ""

# Kỹ năng và plugin
skills:
  - web_search
  - calculator
  - weather

# Chuyển đổi giọng nói thành văn bản (STT)
stt:
  provider: whisper
  model: whisper-1

# Lời nhắc hệ thống
system_prompt: "You are a helpful assistant."

Thiết lập các giá trị riêng lẻ

Thay vì chỉnh sửa toàn bộ tệp, bạn có thể thiết lập các giá trị cấu hình riêng lẻ từ dòng lệnh:

bash

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

Cách này rất hữu ích cho việc viết script hoặc thay đổi nhanh mà không cần mở trình chỉnh sửa.

Thiết lập các kênh

Tích hợp WhatsApp yêu cầu tài khoản Meta Business và quyền truy cập WhatsApp Business API.

bash

# Kích hoạt kênh 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"

Vấn đề phổ biến: WhatsApp yêu cầu một URL webhook. Bạn cần công khai OpenClaw ra internet bằng reverse proxy (nginx, Caddy) hoặc dịch vụ đường hầm (ngrok, Cloudflare Tunnel).

bash

# Thiết lập URL webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Thiết lập Discord đơn giản hơn — bạn chỉ cần một bot token từ Discord Developer Portal.

bash

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

Mẹo: Đảm bảo bot Discord của bạn đã bật "Message Content" privileged intent trong Developer Portal, nếu không nó sẽ không thể đọc được tin nhắn.

Telegram yêu cầu bot token từ @BotFather:

bash

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

Telegram hỗ trợ cả chế độ polling và webhook. Polling dễ dàng hơn cho việc phát triển (không cần URL công khai):

bash

openclaw config set channels.telegram.mode polling

Đối với môi trường production, hãy sử dụng chế độ webhook:

bash

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

Slack

Tích hợp Slack sử dụng Socket Mode (được khuyến nghị) hoặc 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 Mode được khuyến nghị vì nó không yêu cầu URL công khai.

Cấu hình nhà cung cấp mô hình

OpenAI

bash

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

Thiết lập API key của bạn dưới dạng biến môi trường (không để nó trong tệp cấu hình):

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 (Mô hình cục bộ)

Đây là nơi OpenClaw tỏa sáng cho những người dùng quan tâm đến quyền riêng tư. Ollama cho phép bạn chạy các mô hình cục bộ mà không cần API key hoặc dữ liệu rời khỏi máy của bạn.

bash

# Cài đặt Ollama trước
# https://ollama.ai

# Tải một mô hình
ollama pull llama3.3

# Cấu hình OpenClaw để sử dụng Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Vấn đề phổ biến: Nếu OpenClaw không thể kết nối với Ollama, hãy đảm bảo Ollama đang chạy (ollama serve) và base URL trùng khớp. Cổng mặc định của Ollama là 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 sử dụng API tương thích với OpenAI
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-..."   # Sử dụng key xAI với nhà cung cấp OpenAI

Các lỗi cấu hình phổ biến và cách khắc phục

Lỗi: "Unknown config key"

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

Lỗi này thường do sai chính tả trong khóa cấu hình. Hãy kiểm tra lại cách viết của bạn. Các lỗi phổ biến:

chanels → channels

providr → provider

telgram → telegram

Chạy openclaw config show để xem tất cả các khóa hợp lệ.

Lỗi: "Channel auto-enabled without credentials"

Một số phiên bản OpenClaw tự động kích hoạt các kênh khi bạn thiết lập thông tin xác thực, ngay cả khi bạn chưa kích hoạt chúng một cách rõ ràng. Điều này có thể gây ra lỗi khởi động nếu thông tin xác thực chưa đầy đủ.

Cách khắc phục:

bash

# Vô hiệu hóa rõ ràng các kênh bạn không sử dụng
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Lỗi: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Bạn cần thiết lập biến môi trường tương ứng. OpenClaw cố tình không lưu trữ API key trong tệp cấu hình vì lý do bảo mật.

Cách khắc phục: Thêm API key vào profile shell của bạn (~/.bashrc, ~/.zshrc) hoặc sử dụng tệp .env:

bash

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

Sử dụng openclaw doctor

Lệnh openclaw doctor kiểm tra toàn bộ cấu hình của bạn và báo cáo các vấn đề:

bash

openclaw doctor

Ví dụ đầu ra:

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.

Cờ --fix cố gắng giải quyết các vấn đề một cách tự động:

bash

openclaw doctor --fix

Lệnh này sẽ vô hiệu hóa các kênh thiếu thông tin xác thực, sửa các lỗi định dạng đã biết và đề xuất các cách khắc phục thủ công cho các vấn đề không thể giải quyết tự động.

Cấu hình nâng cao

Kỹ năng tùy chỉnh (Custom Skills)

OpenClaw hỗ trợ các kỹ năng tùy chỉnh (plugin) để mở rộng khả năng của trợ lý:

yaml

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

Hoặc qua dòng lệnh:

bash

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

Cấu hình Chuyển đổi giọng nói thành văn bản (STT)

Để hỗ trợ tin nhắn thoại trên WhatsApp và Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # tự động phát hiện hoặc chỉ định "en", "vi", v.v.

bash

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

Tích hợp nhà thông minh Tuya

OpenClaw có thể điều khiển các thiết bị nhà thông minh tương thích với Tuya:

yaml

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

Điều này cho phép bạn điều khiển đèn, công tắc, nhiệt kế và các thiết bị Tuya khác thông qua các lệnh ngôn ngữ tự nhiên trong bất kỳ kênh nào được kết nối.

Cấu hình nhiều mô hình

Bạn có thể định nghĩa các thiết lập mô hình sẵn có và chuyển đổi giữa chúng:

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
# hoặc chuyển đổi khi đang chạy
openclaw --model fast

Các câu hỏi thường gặp

Tệp cấu hình OpenClaw được lưu trữ ở đâu?

Vị trí mặc định là ~/.openclaw/config.yaml. Trên một số bản cài đặt, nó có thể nằm tại ~/.config/openclaw/config.yaml. Chạy openclaw config show --path để xem vị trí chính xác.

Tôi có thể sử dụng OpenClaw mà không cần cloud API không?

Có. Hãy cấu hình Ollama làm nhà cung cấp mô hình và sử dụng Telegram ở chế độ polling. Điều này mang lại cho bạn một trợ lý AI hoàn toàn cục bộ, riêng tư và không có dữ liệu nào rời khỏi máy của bạn.

Làm thế nào để cập nhật OpenClaw?

bash

pip install --upgrade openclaw
# hoặc
npm update -g openclaw

Sau khi cập nhật, hãy chạy openclaw doctor để kiểm tra bất kỳ thay đổi nào về định dạng cấu hình.

Tôi có thể chạy nhiều kênh đồng thời không?

Có. Bạn có thể kích hoạt bao nhiêu kênh tùy thích — OpenClaw xử lý chúng đồng thời. Mỗi kênh sẽ chia sẻ cùng một cấu hình mô hình và kỹ năng.

Làm cách nào để đặt lại cấu hình về mặc định?

bash

openclaw config reset

Lệnh này sẽ ghi đè tệp cấu hình của bạn bằng mẫu mặc định. Hãy sao lưu cấu hình hiện tại của bạn trước nếu cần.

Bạn muốn thứ gì đó đơn giản hơn?

OpenClaw rất mạnh mẽ nhưng đòi hỏi sự thoải mái với terminal và cấu hình thủ công. Nếu bạn muốn xây dựng và triển khai các sản phẩm tích hợp AI mà không cần tự quản lý tệp cấu hình, nhà cung cấp mô hình và tích hợp kênh:

Y Build xử lý toàn bộ quy trình — triển khai, video sản phẩm, AI SEO và phân tích. Không tệp cấu hình. Không terminal. Chỉ cần xây dựng và phát hành. Bắt đầu miễn phí →

Nguồn tham khảo:

TL;DR

Tham khảo nhanh các lệnh cấu hình OpenClaw phổ biến nhất:

bash

# Mở trình chỉnh sửa cấu hình
openclaw config edit

# Thiết lập một giá trị cụ thể
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Xem cấu hình hiện tại
openclaw config show

# Kiểm tra và khắc phục các vấn đề cấu hình
openclaw doctor
openclaw doctor --fix

# Đặt lại về mặc định
openclaw config reset

OpenClaw là gì?

openclaw config edit: Những kiến thức cơ bản

Mở trình chỉnh sửa cấu hình

Lệnh chính để cấu hình OpenClaw là:

bash

openclaw config edit

Cấu trúc tệp cấu hình

Tệp cấu hình OpenClaw có định dạng YAML và được tổ chức thành các phần:

yaml

# Cấu hình mô hình
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # chuỗi định danh mô hình
  temperature: 0.7
  max_tokens: 4096

# Cấu hình kênh
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: ""

# Kỹ năng và plugin
skills:
  - web_search
  - calculator
  - weather

# Chuyển đổi giọng nói thành văn bản (STT)
stt:
  provider: whisper
  model: whisper-1

# Lời nhắc hệ thống
system_prompt: "You are a helpful assistant."

Thiết lập các giá trị riêng lẻ

Thay vì chỉnh sửa toàn bộ tệp, bạn có thể thiết lập các giá trị cấu hình riêng lẻ từ dòng lệnh:

bash

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

Cách này rất hữu ích cho việc viết script hoặc thay đổi nhanh mà không cần mở trình chỉnh sửa.

Thiết lập các kênh

Tích hợp WhatsApp yêu cầu tài khoản Meta Business và quyền truy cập WhatsApp Business API.

bash

# Kích hoạt kênh 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"

bash

# Thiết lập URL webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Thiết lập Discord đơn giản hơn — bạn chỉ cần một bot token từ Discord Developer Portal.

bash

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

Mẹo: Đảm bảo bot Discord của bạn đã bật "Message Content" privileged intent trong Developer Portal, nếu không nó sẽ không thể đọc được tin nhắn.

Telegram yêu cầu bot token từ @BotFather:

bash

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

Telegram hỗ trợ cả chế độ polling và webhook. Polling dễ dàng hơn cho việc phát triển (không cần URL công khai):

bash

openclaw config set channels.telegram.mode polling

Đối với môi trường production, hãy sử dụng chế độ webhook:

bash

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

Slack

Tích hợp Slack sử dụng Socket Mode (được khuyến nghị) hoặc 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 Mode được khuyến nghị vì nó không yêu cầu URL công khai.

Cấu hình nhà cung cấp mô hình

OpenAI

bash

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

Thiết lập API key của bạn dưới dạng biến môi trường (không để nó trong tệp cấu hình):

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 (Mô hình cục bộ)

bash

# Cài đặt Ollama trước
# https://ollama.ai

# Tải một mô hình
ollama pull llama3.3

# Cấu hình OpenClaw để sử dụng Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost: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 sử dụng API tương thích với OpenAI
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-..."   # Sử dụng key xAI với nhà cung cấp OpenAI

Các lỗi cấu hình phổ biến và cách khắc phục

Lỗi: "Unknown config key"

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

Lỗi này thường do sai chính tả trong khóa cấu hình. Hãy kiểm tra lại cách viết của bạn. Các lỗi phổ biến:

chanels → channels

providr → provider

telgram → telegram

Chạy openclaw config show để xem tất cả các khóa hợp lệ.

Lỗi: "Channel auto-enabled without credentials"

Cách khắc phục:

bash

# Vô hiệu hóa rõ ràng các kênh bạn không sử dụng
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Lỗi: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Bạn cần thiết lập biến môi trường tương ứng. OpenClaw cố tình không lưu trữ API key trong tệp cấu hình vì lý do bảo mật.

Cách khắc phục: Thêm API key vào profile shell của bạn (~/.bashrc, ~/.zshrc) hoặc sử dụng tệp .env:

bash

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

Sử dụng openclaw doctor

Lệnh openclaw doctor kiểm tra toàn bộ cấu hình của bạn và báo cáo các vấn đề:

bash

openclaw doctor

Ví dụ đầu ra:

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.

Cờ --fix cố gắng giải quyết các vấn đề một cách tự động:

bash

openclaw doctor --fix

Cấu hình nâng cao

Kỹ năng tùy chỉnh (Custom Skills)

OpenClaw hỗ trợ các kỹ năng tùy chỉnh (plugin) để mở rộng khả năng của trợ lý:

yaml

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

Hoặc qua dòng lệnh:

bash

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

Cấu hình Chuyển đổi giọng nói thành văn bản (STT)

Để hỗ trợ tin nhắn thoại trên WhatsApp và Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # tự động phát hiện hoặc chỉ định "en", "vi", v.v.

bash

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

Tích hợp nhà thông minh Tuya

OpenClaw có thể điều khiển các thiết bị nhà thông minh tương thích với Tuya:

yaml

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

Cấu hình nhiều mô hình

Bạn có thể định nghĩa các thiết lập mô hình sẵn có và chuyển đổi giữa chúng:

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
# hoặc chuyển đổi khi đang chạy
openclaw --model fast

Các câu hỏi thường gặp

Tệp cấu hình OpenClaw được lưu trữ ở đâu?

Tôi có thể sử dụng OpenClaw mà không cần cloud API không?

Làm thế nào để cập nhật OpenClaw?

bash

pip install --upgrade openclaw
# hoặc
npm update -g openclaw

Sau khi cập nhật, hãy chạy openclaw doctor để kiểm tra bất kỳ thay đổi nào về định dạng cấu hình.

Tôi có thể chạy nhiều kênh đồng thời không?

Có. Bạn có thể kích hoạt bao nhiêu kênh tùy thích — OpenClaw xử lý chúng đồng thời. Mỗi kênh sẽ chia sẻ cùng một cấu hình mô hình và kỹ năng.

Làm cách nào để đặt lại cấu hình về mặc định?

bash

openclaw config reset

Lệnh này sẽ ghi đè tệp cấu hình của bạn bằng mẫu mặc định. Hãy sao lưu cấu hình hiện tại của bạn trước nếu cần.

Bạn muốn thứ gì đó đơn giản hơn?

Nguồn tham khảo: