​

Thiết lập

​

Tóm tắt

• Tùy chỉnh nằm ngoài repo: ~/.openclaw/workspace (workspace) + ~/.openclaw/openclaw.json (cấu hình).
• Quy trình ổn định: cài đặt ứng dụng macOS; để nó chạy Gateway đi kèm.
• Quy trình tiên tiến: tự chạy Gateway qua pnpm gateway:watch, sau đó để ứng dụng macOS kết nối ở chế độ Local.

​

Yêu cầu trước (từ source)

• Khuyến nghị dùng Node 24 (Node 22 LTS, hiện tại 22.16+, vẫn được hỗ trợ)
• pnpm
• Docker (tùy chọn; chỉ cho thiết lập container/e2e — xem Docker)

​

Chiến lược tùy chỉnh (để cập nhật không gây ảnh hưởng)

• Cấu hình: ~/.openclaw/openclaw.json (dạng JSON/JSON5)
• Workspace: ~/.openclaw/workspace (kỹ năng, gợi ý, ký ức; biến nó thành repo git riêng tư)

openclaw setup

openclaw setup

​

Chạy Gateway từ repo này

node openclaw.mjs gateway --port 18789 --verbose

​

Quy trình ổn định (ứng dụng macOS trước)

1. Cài đặt + khởi chạy OpenClaw.app (thanh menu).
2. Hoàn thành danh sách kiểm tra onboarding/permissions (TCC prompts).
3. Đảm bảo Gateway là Local và đang chạy (ứng dụng quản lý nó).
4. Liên kết các bề mặt (ví dụ: WhatsApp):

openclaw channels login

5. Kiểm tra nhanh:

openclaw health

• Chạy openclaw setup, sau đó openclaw channels login, rồi khởi động Gateway thủ công (openclaw gateway).

​

Quy trình tiên tiến (Gateway trong terminal)

​

0) (Tùy chọn) Chạy ứng dụng macOS từ source

./scripts/restart-mac.sh

​

1) Khởi động Gateway dev

pnpm install
pnpm gateway:watch

​

2) Chỉ định ứng dụng macOS kết nối với Gateway đang chạy

• Chế độ kết nối: Local Ứng dụng sẽ kết nối với gateway đang chạy trên cổng đã cấu hình.

​

3) Xác minh

• Trạng thái Gateway trong ứng dụng nên hiển thị “Using existing gateway …”
• Hoặc qua CLI:

openclaw health

​

Lưu ý thường gặp

• Sai cổng: Gateway WS mặc định là ws://127.0.0.1:18789; giữ ứng dụng + CLI trên cùng một cổng.
• Nơi lưu trữ trạng thái:
  • Thông tin đăng nhập: ~/.openclaw/credentials/
  • Phiên làm việc: ~/.openclaw/agents/<agentId>/sessions/
  • Nhật ký: /tmp/openclaw/

​

Bản đồ lưu trữ thông tin đăng nhập

• WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
• Telegram bot token: cấu hình/môi trường hoặc channels.telegram.tokenFile (chỉ file thường; từ chối symlinks)
• Discord bot token: cấu hình/môi trường hoặc SecretRef (nhà cung cấp env/file/exec)
• Slack tokens: cấu hình/môi trường (channels.slack.*)
• Danh sách cho phép ghép đôi:
  • ~/.openclaw/credentials/<channel>-allowFrom.json (tài khoản mặc định)
  • ~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json (tài khoản không mặc định)
• Hồ sơ xác thực mô hình: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• Payload bí mật dựa trên file (tùy chọn): ~/.openclaw/secrets.json
• Nhập OAuth cũ: ~/.openclaw/credentials/oauth.json Chi tiết thêm: Bảo mật.

​

Cập nhật (không làm hỏng cấu hình của bạn)

• Giữ ~/.openclaw/workspace và ~/.openclaw/ là “đồ của bạn”; không đặt gợi ý/cấu hình cá nhân vào repo openclaw.
• Cập nhật source: git pull + pnpm install (khi lockfile thay đổi) + tiếp tục sử dụng pnpm gateway:watch.

​

Linux (dịch vụ người dùng systemd)

sudo loginctl enable-linger $USER

​

Tài liệu liên quan

• Gateway runbook (cờ, giám sát, cổng)
• Cấu hình Gateway (schema cấu hình + ví dụ)
• Discord và Telegram (thẻ trả lời + cài đặt replyToMode)
• Thiết lập trợ lý OpenClaw
• Ứng dụng macOS (vòng đời gateway)