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

​

⚠️ 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 đ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 30 phút một lần. 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 (để nó tiếp tục chạy):

openclaw gateway --port 18789

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

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

​

Cấp workspace cho tác tử (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" },
  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 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 gửi riêng lẻ, OpenClaw xác nhận việc đặt lại mà không gọi model.
• /compact [instructions] compaction 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, chú thích Markdown/HTML, tiêu đề Markdown như # Heading, dấu fence, hoặc các mục checklist trống), 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à model quyết định phải làm gì.
• Nếu tác tử trả lời bằng HEARTBEAT_OK (tùy chọn có 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, cho phép gửi Heartbeat đến các mục tiêu kiểu DM user:<id>. Đặt agents.defaults.heartbeat.directPolicy: "block" để chặn gửi đến 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 đầy đủ các lượt của 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)

{
  "message": "Here's the screenshot.",
  "mediaUrl": "https://example.com/screenshot.png"
}

• Nếu tools.fs.workspaceOnly là true, đường dẫn phương tiện cục bộ đầu ra vẫn bị giới hạn trong temp root của OpenClaw, bộ nhớ đệm phương tiện, các đường dẫn workspace của tác tử và các tệp do sandbox tạo.
• Nếu tools.fs.workspaceOnly là false, phương tiện cục bộ đầ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 theo workspace, hoặc tương đối theo home với ~/.
• Gửi 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, tài liệu Office và tài liệu văn bản đã được xác thực như Markdown/MD, TXT, JSON, YAML và YML). Đây là phần mở rộng của ranh giới tin cậy đọc trên máy chủ hiện có, không phải trình quét bí mật: nếu tác tử có thể đọc secret.txt hoặc config.json cục bộ trên máy chủ, nó có thể đính kèm tệp đó khi phần mở rộng và xác thực nội dung khớp.

​

Checklist 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
• Windows Hub: Windows
• 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