openclaw agents

จัดการเอเจนต์ที่แยกจากกัน (พื้นที่ทำงาน + การยืนยันตัวตน + การกำหนดเส้นทาง) การเรียกใช้ openclaw agents โดยไม่มีคำสั่งย่อยจะเทียบเท่ากับ openclaw agents list

เนื้อหาที่เกี่ยวข้อง:

• การกำหนดเส้นทางแบบหลายเอเจนต์
• พื้นที่ทำงานของเอเจนต์
• การกำหนดค่า Skills: การกำหนดการมองเห็น Skills

ตัวอย่าง

openclaw agents listopenclaw agents list --bindingsopenclaw agents add work --workspace ~/.openclaw/workspace-workopenclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:*openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactiveopenclaw agents bindingsopenclaw agents bind --agent work --bind telegram:opsopenclaw agents unbind --agent work --bind telegram:opsopenclaw agents set-identity --workspace ~/.openclaw/workspace --from-identityopenclaw agents set-identity --agent main --avatar avatars/openclaw.pngopenclaw agents delete work

ชุดคำสั่งที่ใช้งานได้

agents list

ตัวเลือก: --json, --bindings (รวมกฎการกำหนดเส้นทางทั้งหมด ไม่ใช่เพียงจำนวนหรือข้อมูลสรุปต่อเอเจนต์)

agents add [name]

ตัวเลือก: --workspace <dir>, --model <id>, --agent-dir <dir>, --bind <channel[:accountId]> (ระบุซ้ำได้), --non-interactive, --json

• การส่งแฟล็กสำหรับเพิ่มอย่างชัดเจนใดๆ จะเปลี่ยนคำสั่งไปใช้ขั้นตอนแบบไม่โต้ตอบ
• โหมดไม่โต้ตอบต้องระบุทั้งชื่อเอเจนต์และ --workspace
• main เป็นค่าที่สงวนไว้และไม่สามารถใช้เป็นรหัสเอเจนต์ใหม่ได้
• โหมดโต้ตอบจะตั้งต้นการยืนยันตัวตนโดยคัดลอกเฉพาะข้อมูลประจำตัวแบบคงที่ที่เคลื่อนย้ายได้ (โปรไฟล์ api_key และ token แบบคงที่) เว้นแต่ข้อมูลประจำตัวจะปฏิเสธด้วย copyToAgents: false ส่วนโปรไฟล์โทเค็นรีเฟรช OAuth จะไม่ถูกคัดลอก เว้นแต่ผู้ให้บริการจะยินยอมด้วย copyToAgents: true หากไม่มีการคัดลอก OAuth จะยังใช้งานได้ผ่านการสืบทอดแบบอ่านผ่านจากที่เก็บของเอเจนต์ main จริงเท่านั้น หากเอเจนต์เริ่มต้นที่กำหนดค่าไว้ไม่ใช่ main ให้ลงชื่อเข้าใช้แยกต่างหากสำหรับโปรไฟล์ OAuth บนเอเจนต์ใหม่

agents bindings

ตัวเลือก: --agent <id>, --json

agents bind

ตัวเลือก: --agent <id> (ค่าเริ่มต้นคือเอเจนต์เริ่มต้นปัจจุบัน), --bind <channel[:accountId]> (ระบุซ้ำได้), --json

agents unbind

ตัวเลือก: --agent <id> (ค่าเริ่มต้นคือเอเจนต์เริ่มต้นปัจจุบัน), --bind <channel[:accountId]> (ระบุซ้ำได้), --all, --json รับค่าได้ทั้ง --all หรือค่า --bind อย่างน้อยหนึ่งค่า แต่ใช้ทั้งสองแบบพร้อมกันไม่ได้

agents set-identity

ตัวเลือก: --agent <id>, --workspace <dir>, --identity-file <path>, --from-identity, --name <name>, --theme <theme>, --emoji <emoji>, --avatar <value>, --json ดูตั้งค่าอัตลักษณ์ด้านล่าง

agents delete <id>

ตัวเลือก: --force, --json

• ไม่สามารถลบ main ได้
• หากไม่มี --force จะต้องมีการยืนยันแบบโต้ตอบ (คำสั่งจะล้มเหลวในเซสชันที่ไม่ใช่ TTY ให้เรียกใช้อีกครั้งด้วย --force)
• ไดเรกทอรีพื้นที่ทำงาน สถานะเอเจนต์ และบันทึกเซสชันจะถูกย้ายไปยังถังขยะ ไม่ได้ถูกลบอย่างถาวร
• เมื่อเข้าถึง Gateway ได้ การลบจะส่งผ่าน Gateway เพื่อให้การล้างข้อมูลการกำหนดค่าและที่เก็บเซสชันใช้ตัวเขียนเดียวกับการรับส่งข้อมูลขณะทำงาน หากเข้าถึง Gateway ไม่ได้ CLI จะย้อนกลับไปใช้เส้นทางภายในเครื่องแบบออฟไลน์
• หากพื้นที่ทำงานของเอเจนต์อื่นเป็นพาธเดียวกัน อยู่ภายในพื้นที่ทำงานนี้ หรือครอบคลุมพื้นที่ทำงานนี้ พื้นที่ทำงานจะถูกเก็บไว้ และ --json จะรายงาน workspaceRetained, workspaceRetainedReason และ workspaceSharedWith

การผูกเส้นทาง

ใช้การผูกเส้นทางเพื่อกำหนดให้การรับส่งข้อมูลขาเข้าจากช่องทางไปยังเอเจนต์ที่ระบุ

หากคุณต้องการให้แต่ละเอเจนต์มองเห็น Skills ต่างกันด้วย ให้กำหนดค่า agents.defaults.skills และ agents.list[].skills ใน openclaw.json ดูการกำหนดค่า Skillsและข้อมูลอ้างอิงการกำหนดค่า

แสดงรายการการผูก:

openclaw agents bindingsopenclaw agents bindings --agent workopenclaw agents bindings --json

เพิ่มการผูก:

openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

คุณยังสามารถเพิ่มการผูกขณะสร้างเอเจนต์ได้:

openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:*

หากคุณละเว้น accountId (--bind <channel>) OpenClaw จะระบุค่าจากฮุกการตั้งค่า Plugin การบังคับผูกบัญชี หรือจำนวนบัญชีที่กำหนดค่าไว้ของช่องทาง

หากคุณละเว้น --agent สำหรับ bind หรือ unbind OpenClaw จะกำหนดเป้าหมายเป็นเอเจนต์เริ่มต้นปัจจุบัน

รูปแบบ --bind

ลักษณะการทำงานของขอบเขตการผูก

• การผูกที่จัดเก็บไว้โดยไม่มี accountId จะจับคู่เฉพาะบัญชีเริ่มต้นของช่องทาง
• accountId: "*" เป็นค่าทดแทนสำรองสำหรับทั้งช่องทาง (ทุกบัญชี) และมีความเฉพาะเจาะจงน้อยกว่าการผูกบัญชีอย่างชัดเจน
• หากเอเจนต์เดียวกันมีการผูกช่องทางที่ตรงกันโดยไม่มี accountId อยู่แล้ว และภายหลังคุณผูกด้วย accountId ที่ระบุไว้อย่างชัดเจนหรือที่ระบบระบุให้ OpenClaw จะอัปเกรดการผูกเดิมนั้นโดยตรงแทนการเพิ่มรายการซ้ำ

ตัวอย่าง:

# จับคู่ทุกบัญชีบนช่องทางopenclaw agents bind --agent work --bind telegram:* # จับคู่บัญชีที่ระบุopenclaw agents bind --agent work --bind telegram:ops # การผูกเฉพาะช่องทางในตอนเริ่มต้นopenclaw agents bind --agent work --bind telegram # อัปเกรดเป็นการผูกที่มีขอบเขตระดับบัญชีในภายหลังopenclaw agents bind --agent work --bind telegram:alerts

หลังการอัปเกรด การกำหนดเส้นทางสำหรับการผูกนั้นจะมีขอบเขตเฉพาะ telegram:alerts หากคุณต้องการการกำหนดเส้นทางสำหรับบัญชีเริ่มต้นด้วย ให้เพิ่มอย่างชัดเจน (เช่น --bind telegram:default)

ลบการผูก:

openclaw agents unbind --agent work --bind telegram:opsopenclaw agents unbind --agent work --all

ไฟล์อัตลักษณ์

พื้นที่ทำงานของแต่ละเอเจนต์สามารถมีไฟล์ IDENTITY.md ที่รากของพื้นที่ทำงาน:

• ตัวอย่างพาธ: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity จะอ่านจากรากของพื้นที่ทำงาน (หรือจาก --identity-file ที่ระบุอย่างชัดเจน)

พาธของภาพประจำตัวจะถูกตีความโดยอ้างอิงจากรากของพื้นที่ทำงาน และไม่สามารถออกนอกพื้นที่ทำงานได้ แม้จะผ่านลิงก์สัญลักษณ์ก็ตาม

ตั้งค่าอัตลักษณ์

set-identity จะเขียนฟิลด์ลงใน agents.list[].identity: name, theme, emoji, avatar (พาธที่สัมพันธ์กับพื้นที่ทำงาน, URL แบบ http(s) หรือ URI ข้อมูล)

• --agent หรือ --workspace ใช้เลือกเอเจนต์เป้าหมาย หาก --workspace ตรงกับเอเจนต์มากกว่าหนึ่งรายการ คำสั่งจะล้มเหลวและขอให้คุณส่ง --agent
• ไฟล์ภาพประจำตัวภายในเครื่องที่มีพาธสัมพันธ์กับพื้นที่ทำงานจำกัดขนาดไว้ที่ 2 MB ส่วน URL แบบ HTTP(S) และ URI แบบ data: จะไม่ถูกตรวจสอบตามขีดจำกัดขนาดไฟล์ภายในเครื่อง
• เมื่อไม่ได้ระบุฟิลด์อัตลักษณ์อย่างชัดเจน คำสั่งจะอ่านข้อมูลอัตลักษณ์จาก IDENTITY.md

โหลดจาก IDENTITY.md:

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

เขียนทับฟิลด์อย่างชัดเจน:

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png

ตัวอย่างการกำหนดค่า:

{  agents: {    list: [      {        id: "main",        identity: {          name: "OpenClaw",          theme: "space lobster",          emoji: "🦞",          avatar: "avatars/openclaw.png",        },      },    ],  },}

เนื้อหาที่เกี่ยวข้อง

• ข้อมูลอ้างอิง CLI
• การกำหนดเส้นทางแบบหลายเอเจนต์
• พื้นที่ทำงานของเอเจนต์