# openclaw agents

จัดการเอเจนต์แบบแยกส่วน (พื้นที่ทำงาน + การยืนยันตัวตน + การกำหนดเส้นทาง).

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

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

# ตัวอย่าง

openclaw agents list
openclaw agents list --bindings
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive
openclaw agents bindings
openclaw agents bind --agent work --bind telegram:ops
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
openclaw agents delete work

# การผูกการกำหนดเส้นทาง

ใช้การผูกการกำหนดเส้นทางเพื่อตรึงทราฟฟิกช่องทางขาเข้าไว้กับเอเจนต์เฉพาะ.

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

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

openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json

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

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

หากคุณละเว้น accountId (--bind <channel>) OpenClaw จะระบุค่าจากค่าเริ่มต้นของช่องทางและฮุกการตั้งค่า Plugin เมื่อมีให้ใช้.

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

# พฤติกรรมขอบเขตการผูก

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

ตัวอย่าง:

# initial channel-only binding
openclaw agents bind --agent work --bind telegram

# later upgrade to account-scoped binding
openclaw agents bind --agent work --bind telegram:ops

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

ลบการผูก:

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

unbind รับได้ทั้ง --all หรือค่า --bind หนึ่งค่าหรือมากกว่า แต่ไม่ใช่ทั้งสองอย่างพร้อมกัน.

# พื้นผิวคำสั่ง

# agents

การเรียกใช้ openclaw agents โดยไม่มีคำสั่งย่อยเทียบเท่ากับ openclaw agents list.

# agents list

ตัวเลือก:

• --json
• --bindings: รวมกฎการกำหนดเส้นทางแบบเต็ม ไม่ใช่เฉพาะจำนวน/สรุปต่อเอเจนต์เท่านั้น

# agents add [name]

ตัวเลือก:

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (ทำซ้ำได้)
• --non-interactive
• --json

หมายเหตุ:

• การส่งแฟล็กเพิ่มแบบระบุชัดเจนใดๆ จะสลับคำสั่งไปยังเส้นทางแบบไม่โต้ตอบ.
• โหมดไม่โต้ตอบต้องมีทั้งชื่อเอเจนต์และ --workspace.
• main ถูกสงวนไว้และไม่สามารถใช้เป็น id ของเอเจนต์ใหม่ได้.
• ในโหมดโต้ตอบ การเติมข้อมูลการยืนยันตัวตนจะคัดลอกเฉพาะโปรไฟล์แบบสแตติกที่พกพาได้ (api_key และ token แบบสแตติกโดยค่าเริ่มต้น). โปรไฟล์ OAuth refresh-token จะยังคง ใช้ได้ผ่านการสืบทอดแบบอ่านทะลุจากที่เก็บเอเจนต์ 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

# agents delete <id>

ตัวเลือก:

• --force
• --json

หมายเหตุ:

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

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

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

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

พาธอวาตาร์จะถูกระบุเทียบกับรากพื้นที่ทำงาน.

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

set-identity เขียนฟิลด์ลงใน agents.list[].identity:

• name
• theme
• emoji
• avatar (พาธแบบสัมพันธ์กับพื้นที่ทำงาน, URL http(s) หรือ data URI)

ตัวเลือก:

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

หมายเหตุ:

• สามารถใช้ --agent หรือ --workspace เพื่อเลือกเอเจนต์เป้าหมายได้.
• หากคุณพึ่งพา --workspace และมีหลายเอเจนต์ใช้พื้นที่ทำงานนั้นร่วมกัน คำสั่งจะล้มเหลวและขอให้คุณส่ง --agent.
• เมื่อไม่มีการระบุฟิลด์อัตลักษณ์อย่างชัดเจน คำสั่งจะอ่านข้อมูลอัตลักษณ์จาก 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
• การกำหนดเส้นทางหลายเอเจนต์
• พื้นที่ทำงานของเอเจนต์