Thiết lập trợ lý cá nhân

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.

​

⚠️ 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 không gian làm việc của bạn
• gửi tin nhắn ngược ra ngoài qua WhatsApp/Telegram/Discord/Mattermost và các kênh đi kèm khác

• Luôn đặt channels.whatsapp.allowFrom (đừng bao giờ chạy ở chế độ 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

• OpenClaw đã được cài đặt và onboarding - 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 (để Gateway tiếp tục chạy):

openclaw gateway --port 18789

3. Đặt cấu hình tối thiểu trong ~/.openclaw/openclaw.json:

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

​

Cấp cho tác tử một không gian làm việc (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 (khi bạn đã tin tưởng nó)

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      workspace: "~/.openclaw/workspace",
      thinkingDefault: "high",
      timeoutSeconds: 1800,
      // Start with 0; enable later.
      heartbeat: { every: "0m" },
    },
    list: [
      {
        id: "main",
        default: true,
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  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 sử dụng token, tuyến gần nhất, 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 riêng lẻ, OpenClaw xác nhận việc đặt lại mà không gọi mô hình.
• /compact [instructions] né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 về cơ bản trống (chỉ có dòng trống và tiêu đề markdown như # Heading), OpenClaw bỏ qua lượt 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 tử trả lời bằng HEARTBEAT_OK (tùy chọn kèm phần đệm ngắn; xem agents.defaults.heartbeat.ackMaxChars), OpenClaw sẽ chặn việc gửi ra ngoài cho Heartbeat đó.
• Theo mặc định, việc gửi Heartbeat tới các mục tiêu kiểu DM user:<id> được cho phép. Đặt agents.defaults.heartbeat.directPolicy: "block" để chặn gửi tới mục tiêu trực tiếp trong khi vẫn giữ các lượt chạy Heartbeat hoạt động.
• Heartbeat chạy trọn lượt tác tử - khoảng thời gian ngắn hơn sẽ tiêu tốn nhiều token hơn.

{
  agents: {
    defaults: {
      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 gốc tạm của OpenClaw, bộ nhớ đệm phương tiện, đường dẫn không gian làm việc của tác tử, và các tệp do sandbox tạo.
• 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 tử đã được phép đọc.
• Đường dẫn cục bộ có thể là tuyệt đối, tương đối với không gian làm việc, hoặc tương đối với thư mục home bằng ~/.
• Gửi từ máy chủ cục bộ 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 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 nút iOS: Ứng dụng iOS
• Ứng dụng nút 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