Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Xây dựng trợ lý cá nhân với OpenClaw

​

⚠️ An toàn trước tiên

• chạy lệnh trên máy của bạn (tùy theo chính sách công cụ của bạn)
• đọc/ghi tệp trong workspace của bạn
• gửi tin nhắn ra ngoài qua WhatsApp/Telegram/Discord/Mattermost và các kênh được tích hợp khác

• Luôn đặt channels.whatsapp.allowFrom (không bao giờ chạy mở cho toàn thế giới trên máy Mac cá nhân của bạn).
• Dùng một số WhatsApp riêng cho trợ lý.
• Heartbeat hiện mặc định chạy mỗi 30 phút. Hãy tắt cho đến khi bạn tin tưởng thiết lập bằng cách đặt agents.defaults.heartbeat.every: "0m".

​

Điều kiện tiên quyết

• Đã cài đặt và onboarding OpenClaw — xem Bắt đầu nếu bạn chưa làm việc này
• Một số điện thoại thứ hai (SIM/eSIM/trả trước) cho trợ lý

​

Thiết lập hai điện thoại (khuyến nghị)

​

Khởi động nhanh trong 5 phút

1. Ghép nối WhatsApp Web (hiển thị QR; quét bằng điện thoại của trợ lý):

openclaw channels login

2. Khởi động Gateway (để nó tiếp tục chạy):

openclaw gateway --port 18789

3. Đặt một cấu hình tối giản trong ~/.openclaw/openclaw.json:

{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

Cấp workspace cho tác nhân (AGENTS)

openclaw setup

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

{
  agents: {
    defaults: {
      skipBootstrap: true,
    },
  },
}

​

Cấu hình biến nó thành “một trợ lý”

• persona/hướng dẫn trong SOUL.md
• mặc định suy nghĩ (nếu muốn)
• Heartbeat (sau khi bạn tin tưởng nó)

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // Start with 0; enable later.
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

​

Phiên và bộ nhớ

• Tệp phiên: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
• Siêu dữ liệu phiên (mức dùng token, tuyến cuối cùng, v.v.): ~/.openclaw/agents/<agentId>/sessions/sessions.json (cũ: ~/.openclaw/sessions/sessions.json)
• /new hoặc /reset bắt đầu một phiên mới cho cuộc trò chuyện đó (có thể cấu hình qua resetTriggers). Nếu được gửi một mình, OpenClaw xác nhận việc đặt lại mà không gọi mô hình.
• /compact [instructions] thu gọn ngữ cảnh phiên và báo cáo ngân sách ngữ cảnh còn lại.

​

Heartbeat (chế độ chủ động)

• Nếu HEARTBEAT.md tồn tại nhưng thực tế trống (chỉ có dòng trống và tiêu đề markdown như # Heading), OpenClaw bỏ qua lần chạy Heartbeat để tiết kiệm lệnh gọi API.
• Nếu thiếu tệp, Heartbeat vẫn chạy và mô hình quyết định cần làm gì.
• Nếu tác nhân trả lời HEARTBEAT_OK (tùy chọn kèm phần đệm ngắn; xem agents.defaults.heartbeat.ackMaxChars), OpenClaw sẽ chặn gửi ra ngoài cho Heartbeat đó.
• Theo mặc định, việc gửi Heartbeat đến các đích kiểu DM user:<id> được cho phép. Đặt agents.defaults.heartbeat.directPolicy: "block" để chặn gửi đến đích trực tiếp trong khi vẫn giữ các lần chạy Heartbeat hoạt động.
• Heartbeat chạy đầy đủ lượt tác nhân — khoảng thời gian ngắn hơn sẽ tiêu tốn nhiều token hơn.

{
  agent: {
    heartbeat: { every: "30m" },
  },
}

​

Phương tiện vào và ra

• {{MediaPath}} (đường dẫn tệp tạm cục bộ)
• {{MediaUrl}} (pseudo-URL)
• {{Transcript}} (nếu đã bật phiên âm âm thanh)

Here’s the screenshot.
MEDIA:https://example.com/screenshot.png

• Nếu tools.fs.workspaceOnly là true, các đường dẫn cục bộ MEDIA: đầu ra vẫn bị giới hạn trong thư mục tạm gốc của OpenClaw, bộ đệm phương tiện, đường dẫn workspace của tác nhân và các tệp do sandbox tạo ra.
• Nếu tools.fs.workspaceOnly là false, MEDIA: đầu ra có thể dùng các tệp cục bộ trên máy chủ mà tác nhân đã được phép đọc.
• Gửi tệp cục bộ trên máy chủ vẫn chỉ cho phép phương tiện và các loại tài liệu an toàn (hình ảnh, âm thanh, video, PDF và tài liệu Office). Văn bản thuần túy và các tệp có vẻ giống bí mật không được xem là phương tiện có thể gửi.

​

Danh sách kiểm tra vận hành

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # asks the gateway for a live health probe with channel probes when supported
openclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

​

Bước tiếp theo

• WebChat: WebChat
• Vận hành Gateway: Runbook Gateway
• Cron + đánh thức: Tác vụ Cron
• Ứng dụng đồng hành trên thanh menu macOS: Ứng dụng OpenClaw macOS
• Ứng dụng node iOS: Ứng dụng iOS
• Ứng dụng node Android: Ứng dụng Android
• Trạng thái Windows: Windows (WSL2)
• Trạng thái Linux: Ứng dụng Linux
• Bảo mật: Bảo mật

​

Liên quan

• Bắt đầu
• Thiết lập
• Tổng quan về kênh