การตั้งค่าผู้ช่วยส่วนตัว

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.

​

⚠️ ความปลอดภัยต้องมาก่อน

• รันคำสั่งบนเครื่องของคุณ (ขึ้นอยู่กับนโยบายเครื่องมือของคุณ)
• อ่าน/เขียนไฟล์ในเวิร์กสเปซของคุณ
• ส่งข้อความกลับออกไปผ่าน WhatsApp/Telegram/Discord/Mattermost และช่องทางอื่นๆ ที่รวมมาให้

• ตั้งค่า channels.whatsapp.allowFrom เสมอ (อย่ารันแบบเปิดให้ทั้งโลกเข้าถึงบน Mac ส่วนตัวของคุณ)
• ใช้หมายเลข WhatsApp เฉพาะสำหรับผู้ช่วย
• ตอนนี้ Heartbeat มีค่าเริ่มต้นเป็นทุก 30 นาที ปิดไว้จนกว่าคุณจะเชื่อถือการตั้งค่านี้ โดยตั้งค่า agents.defaults.heartbeat.every: "0m"

​

ข้อกำหนดเบื้องต้น

• ติดตั้งและเริ่มต้นใช้งาน OpenClaw แล้ว - ดู เริ่มต้นใช้งาน หากคุณยังไม่ได้ทำขั้นตอนนี้
• หมายเลขโทรศัพท์ที่สอง (SIM/eSIM/เติมเงิน) สำหรับผู้ช่วย

​

การตั้งค่าแบบสองโทรศัพท์ (แนะนำ)

​

เริ่มต้นอย่างรวดเร็วใน 5 นาที

1. จับคู่ WhatsApp Web (แสดง QR; สแกนด้วยโทรศัพท์ของผู้ช่วย):

openclaw channels login

2. เริ่ม Gateway (ปล่อยให้รันต่อไป):

openclaw gateway --port 18789

3. ใส่คอนฟิกขั้นต่ำใน ~/.openclaw/openclaw.json:

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

​

ให้เวิร์กสเปซแก่เอเจนต์ (AGENTS)

openclaw setup

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

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

​

คอนฟิกที่ทำให้มันกลายเป็น “ผู้ช่วย”

• บุคลิก/คำสั่งใน SOUL.md
• ค่าเริ่มต้นการคิด (หากต้องการ)
• Heartbeat (เมื่อคุณเชื่อถือมันแล้ว)

{
  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,
    },
  },
}

​

เซสชันและหน่วยความจำ

• ไฟล์เซสชัน: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
• เมทาดาทาเซสชัน (การใช้โทเค็น, เส้นทางล่าสุด ฯลฯ): ~/.openclaw/agents/<agentId>/sessions/sessions.json (แบบเดิม: ~/.openclaw/sessions/sessions.json)
• /new หรือ /reset เริ่มเซสชันใหม่สำหรับแชตนั้น (กำหนดค่าได้ผ่าน resetTriggers) หากส่งมาเดี่ยวๆ OpenClaw จะยืนยันการรีเซ็ตโดยไม่เรียกโมเดล
• /compact [instructions] compact บริบทเซสชันและรายงานงบประมาณบริบทที่เหลืออยู่

​

Heartbeat (โหมดเชิงรุก)

• หากมี HEARTBEAT.md อยู่แต่แทบว่างเปล่า (มีเพียงบรรทัดว่างและหัวข้อ markdown เช่น # Heading) OpenClaw จะข้ามการรัน Heartbeat เพื่อประหยัดการเรียก API
• หากไฟล์หายไป Heartbeat จะยังคงรันและโมเดลจะตัดสินใจว่าต้องทำอะไร
• หากเอเจนต์ตอบกลับด้วย HEARTBEAT_OK (อาจมีข้อความเสริมสั้นๆ; ดู agents.defaults.heartbeat.ackMaxChars) OpenClaw จะระงับการส่งออกสำหรับ Heartbeat นั้น
• โดยค่าเริ่มต้น อนุญาตให้ส่ง Heartbeat ไปยังเป้าหมายแบบ DM user:<id> ได้ ตั้งค่า agents.defaults.heartbeat.directPolicy: "block" เพื่อระงับการส่งไปยังเป้าหมายโดยตรง โดยยังคงให้การรัน Heartbeat ทำงานอยู่
• Heartbeat รันเป็นรอบเอเจนต์เต็มรูปแบบ - ช่วงเวลาที่สั้นลงจะใช้โทเค็นมากขึ้น

{
  agents: {
    defaults: {
      heartbeat: { every: "30m" },
    },
  },
}

​

สื่อขาเข้าและขาออก

• {{MediaPath}} (พาธไฟล์ชั่วคราวภายในเครื่อง)
• {{MediaUrl}} (pseudo-URL)
• {{Transcript}} (หากเปิดใช้การถอดเสียง)

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

• หาก tools.fs.workspaceOnly เป็น true พาธภายในเครื่องของ MEDIA: ขาออกจะยังถูกจำกัดให้อยู่ใน temp root ของ OpenClaw, แคชสื่อ, พาธเวิร์กสเปซของเอเจนต์ และไฟล์ที่สร้างจาก sandbox
• หาก tools.fs.workspaceOnly เป็น false MEDIA: ขาออกสามารถใช้ไฟล์ภายในเครื่องโฮสต์ที่เอเจนต์ได้รับอนุญาตให้อ่านอยู่แล้ว
• พาธภายในเครื่องสามารถเป็นพาธสัมบูรณ์, สัมพัทธ์กับเวิร์กสเปซ หรือสัมพัทธ์กับโฮมด้วย ~/
• การส่งจากเครื่องโฮสต์ยังอนุญาตเฉพาะสื่อและชนิดเอกสารที่ปลอดภัยเท่านั้น (รูปภาพ, เสียง, วิดีโอ, PDF และเอกสาร Office) ไฟล์ข้อความล้วนและไฟล์ที่ดูเหมือนมีความลับจะไม่ถูกถือว่าเป็นสื่อที่ส่งได้

​

รายการตรวจสอบการปฏิบัติการ

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)

​

ขั้นตอนถัดไป

• WebChat: WebChat
• การปฏิบัติการ Gateway: คู่มือปฏิบัติการ Gateway
• Cron + การปลุก: งาน Cron
• ตัวช่วยบนแถบเมนู macOS: แอป OpenClaw macOS
• แอปโหนด iOS: แอป iOS
• แอปโหนด Android: แอป Android
• สถานะ Windows: Windows (WSL2)
• สถานะ Linux: แอป Linux
• ความปลอดภัย: ความปลอดภัย

​

ที่เกี่ยวข้อง

• เริ่มต้นใช้งาน
• ตั้งค่า
• ภาพรวมช่องทาง