Providers
Anthropic
Anthropic สร้างตระกูลโมเดล Claude OpenClaw รองรับเส้นทางการยืนยันตัวตนสองแบบ:
- คีย์ API — เข้าถึง Anthropic API โดยตรงพร้อมการเรียกเก็บเงินตามการใช้งาน (โมเดล
anthropic/*) - Claude CLI — ใช้การเข้าสู่ระบบ Claude Code ที่มีอยู่บนโฮสต์เดียวกันซ้ำ
เริ่มต้นใช้งาน
คีย์ API
เหมาะที่สุดสำหรับ: การเข้าถึง API มาตรฐานและการเรียกเก็บเงินตามการใช้งาน
รับคีย์ API ของคุณ
สร้างคีย์ API ใน Anthropic Console
รันการเริ่มต้นใช้งาน
openclaw onboard# choose: Anthropic API keyหรือส่งคีย์โดยตรง:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"ตรวจสอบว่าโมเดลพร้อมใช้งาน
openclaw models list --provider anthropicตัวอย่างการกำหนดค่า
{ env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}Claude CLI
เหมาะที่สุดสำหรับ: การใช้การเข้าสู่ระบบ Claude CLI ที่มีอยู่ซ้ำโดยไม่ต้องมีคีย์ API แยกต่างหาก
ตรวจสอบให้แน่ใจว่าติดตั้ง Claude CLI และเข้าสู่ระบบแล้ว
ตรวจสอบด้วย:
claude --versionรันการเริ่มต้นใช้งาน
openclaw onboard# choose: Claude CLIOpenClaw ตรวจพบและใช้ข้อมูลรับรอง Claude CLI ที่มีอยู่ซ้ำ
ตรวจสอบว่าโมเดลพร้อมใช้งาน
openclaw models list --provider anthropicตัวอย่างการกำหนดค่า
แนะนำให้ใช้การอ้างอิงโมเดล Anthropic แบบมาตรฐานพร้อมการแทนที่รันไทม์ CLI:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" }, models: { "anthropic/claude-opus-4-8": { agentRuntime: { id: "claude-cli" }, }, }, }, },}การอ้างอิงโมเดลแบบเดิม claude-cli/claude-opus-4-7 ยังใช้ได้เพื่อ
ความเข้ากันได้ แต่การกำหนดค่าใหม่ควรเก็บการเลือกผู้ให้บริการ/โมเดลเป็น
anthropic/* และใส่แบ็กเอนด์การดำเนินการไว้ในนโยบายรันไทม์ของผู้ให้บริการ/โมเดล
การเรียกเก็บเงินและ claude -p
OpenClaw ใช้เส้นทาง claude -p แบบไม่โต้ตอบของ Claude Code สำหรับการรัน Claude CLI
ปัจจุบัน Anthropic ถือว่าเส้นทางนั้นเป็นการใช้งาน Agent SDK/แบบโปรแกรม:
- จนถึงวันที่ 15 มิถุนายน 2026 การจัดการแผนแบบสมัครสมาชิกจะเป็นไปตามกฎ Claude Code ที่ใช้งานอยู่ของ Anthropic สำหรับบัญชีที่เข้าสู่ระบบ
- ตั้งแต่วันที่ 15 มิถุนายน 2026 เป็นต้นไป การใช้งาน
claude -pในแผนแบบสมัครสมาชิกจะหักจาก เครดิต Agent SDK รายเดือนของผู้ใช้ก่อน จากนั้นจึงหักจากเครดิตการใช้งานตามอัตรา API มาตรฐานหากเปิดใช้เครดิตการใช้งาน - การเข้าสู่ระบบผ่าน Console/คีย์ API ใช้การเรียกเก็บเงิน API แบบจ่ายตามการใช้งานและไม่ได้รับ เครดิต Agent SDK ของแผนสมัครสมาชิก
Anthropic สามารถเปลี่ยนพฤติกรรมการเรียกเก็บเงินและการจำกัดอัตราของ Claude Code ได้โดยไม่ต้องมี
การเผยแพร่ OpenClaw ตรวจสอบ claude auth status, /status และ
เอกสาร Anthropic ที่ลิงก์ไว้เมื่อความคาดการณ์ได้ของการเรียกเก็บเงินเป็นเรื่องสำคัญ
ค่าเริ่มต้นของการคิด (Claude Fable 5, 4.8 และ 4.6)
anthropic/claude-fable-5 ใช้การคิดแบบปรับตัวเสมอและมีค่าเริ่มต้นเป็นความพยายามระดับ high
เนื่องจาก Anthropic ไม่อนุญาตให้ปิดการคิดสำหรับโมเดลนี้
/think off และ /think minimal จึงใช้ความพยายามระดับ low OpenClaw ยังละเว้นค่า
temperature แบบกำหนดเองสำหรับคำขอ Fable 5 ด้วย
Claude Opus 4.8 ปิดการคิดไว้เป็นค่าเริ่มต้นใน OpenClaw เมื่อคุณเปิดใช้การคิดแบบปรับตัวอย่างชัดเจนด้วย /think high|xhigh|max OpenClaw จะส่งค่าความพยายาม Opus 4.8 ของ Anthropic; โมเดล Claude 4.6 มีค่าเริ่มต้นเป็น adaptive
แทนที่ต่อข้อความด้วย /think:<level> หรือในพารามิเตอร์โมเดล:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-8": { params: { thinking: "high" }, }, }, }, },}การแคชพรอมป์
OpenClaw รองรับฟีเจอร์การแคชพรอมป์ของ Anthropic สำหรับการรับรองความถูกต้องด้วย API key
| ค่า | ระยะเวลาแคช | คำอธิบาย |
|---|---|---|
"short" (ค่าเริ่มต้น) |
5 นาที | ใช้โดยอัตโนมัติสำหรับการรับรองความถูกต้องด้วย API key |
"long" |
1 ชั่วโมง | แคชแบบขยาย |
"none" |
ไม่มีการแคช | ปิดใช้งานการแคชพรอมป์ |
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, },}การแทนที่แคชรายเอเจนต์
ใช้พารามิเตอร์ระดับโมเดลเป็นค่าพื้นฐาน แล้วแทนที่เอเจนต์เฉพาะผ่าน agents.list[].params:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" }, models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, list: [ { id: "research", default: true }, { id: "alerts", params: { cacheRetention: "none" } }, ], },}ลำดับการผสานการกำหนดค่า:
agents.defaults.models["provider/model"].paramsagents.list[].params(idที่ตรงกัน แทนที่ตามคีย์)
วิธีนี้ทำให้เอเจนต์หนึ่งคงแคชอายุยาวไว้ได้ ขณะที่อีกเอเจนต์บนโมเดลเดียวกันปิดการแคชสำหรับทราฟฟิกแบบพุ่งเป็นช่วงหรือมีการใช้ซ้ำน้อย
หมายเหตุ Bedrock Claude
- โมเดล Anthropic Claude บน Bedrock (
amazon-bedrock/*anthropic.claude*) รับการส่งผ่านcacheRetentionเมื่อกำหนดค่าไว้ - โมเดล Bedrock ที่ไม่ใช่ Anthropic จะถูกบังคับเป็น
cacheRetention: "none"ขณะรันไทม์ - ค่าเริ่มต้นอัจฉริยะของ API key ยังตั้งค่าเริ่มต้น
cacheRetention: "short"สำหรับ refs Claude-on-Bedrock เมื่อไม่ได้ตั้งค่าไว้อย่างชัดเจน
การกำหนดค่าขั้นสูง
โหมดเร็ว
ตัวสลับ /fast แบบใช้ร่วมกันของ OpenClaw รองรับทราฟฟิก Anthropic โดยตรง (API key และ OAuth ไปยัง api.anthropic.com)
| คำสั่ง | แมปไปยัง |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{ agents: { defaults: { models: { "anthropic/claude-sonnet-4-6": { params: { fastMode: true }, }, }, }, },}การทำความเข้าใจสื่อ (รูปภาพและ PDF)
Plugin Anthropic ที่รวมมาในตัวลงทะเบียนความสามารถในการทำความเข้าใจรูปภาพและ PDF OpenClaw จะแก้ไขความสามารถด้านสื่อโดยอัตโนมัติจากการรับรองความถูกต้อง Anthropic ที่กำหนดค่าไว้ โดยไม่ต้องมี การกำหนดค่าเพิ่มเติม
| คุณสมบัติ | ค่า |
|---|---|
| โมเดลเริ่มต้น | claude-opus-4-8 |
| อินพุตที่รองรับ | รูปภาพ, เอกสาร PDF |
เมื่อแนบรูปภาพหรือ PDF กับการสนทนา OpenClaw จะกำหนดเส้นทางผ่านผู้ให้บริการทำความเข้าใจสื่อของ Anthropic โดยอัตโนมัติ
หน้าต่างบริบท 1M
หน้าต่างบริบท 1M ของ Anthropic พร้อมใช้งานบนโมเดล Claude 4.x ที่รองรับ GA เช่น Opus 4.8, Opus 4.7, Opus 4.6 และ Sonnet 4.6 OpenClaw กำหนดขนาดโมเดลเหล่านั้นเป็น 1M โดยอัตโนมัติ:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": {}, }, }, },}การกำหนดค่ารุ่นเก่ายังคงใช้ params.context1m: true ได้ แต่ OpenClaw จะไม่ส่ง
header เบต้า context-1m-2025-08-07 ที่เลิกใช้แล้วอีกต่อไป รายการกำหนดค่า anthropicBeta รุ่นเก่า
ที่มีค่านั้นจะถูกละเว้นระหว่างการแก้ไข header ของคำขอ และ
โมเดล Claude รุ่นเก่าที่ไม่รองรับจะยังคงใช้หน้าต่างบริบทปกติของตน
params.context1m: true ยังใช้กับแบ็กเอนด์ Claude CLI
(claude-cli/*) สำหรับโมเดล Opus และ Sonnet ที่รองรับ GA และเข้าเกณฑ์ โดยคง
หน้าต่างบริบทขณะรันไทม์สำหรับเซสชัน CLI เหล่านั้นให้ตรงกับพฤติกรรมของ direct API
บริบท 1M ของ Claude Opus 4.8
anthropic/claude-opus-4-8 และตัวแปร claude-cli ของมันมีหน้าต่างบริบท 1M
เป็นค่าเริ่มต้น โดยไม่ต้องใช้ params.context1m: true
การแก้ไขปัญหา
ข้อผิดพลาด 401 / โทเค็นใช้ไม่ได้อย่างกะทันหัน
การรับรองความถูกต้องด้วยโทเค็น Anthropic หมดอายุได้และอาจถูกเพิกถอนได้ สำหรับการตั้งค่าใหม่ ให้ใช้ API key ของ Anthropic แทน
ไม่พบ API key สำหรับผู้ให้บริการ "anthropic"
การยืนยันตัวตนของ Anthropic เป็นแบบ ต่อเอเจนต์ — เอเจนต์ใหม่จะไม่สืบทอดคีย์ของเอเจนต์หลัก ให้เรียกใช้การเริ่มต้นใช้งานใหม่สำหรับเอเจนต์นั้น (หรือกำหนดค่า API key บนโฮสต์ Gateway) แล้วตรวจสอบด้วย openclaw models status
ไม่พบข้อมูลประจำตัวสำหรับโปรไฟล์ "anthropic:default"
เรียกใช้ openclaw models status เพื่อดูว่าโปรไฟล์การยืนยันตัวตนใดกำลังใช้งานอยู่ ให้เรียกใช้การเริ่มต้นใช้งานใหม่ หรือกำหนดค่า API key สำหรับพาธโปรไฟล์นั้น
ไม่มีโปรไฟล์การยืนยันตัวตนที่ใช้งานได้ (ทั้งหมดอยู่ในช่วงพักรอ)
ตรวจสอบ openclaw models status --json สำหรับ auth.unusableProfiles ช่วงพักรอจากการจำกัดอัตราของ Anthropic อาจผูกกับโมเดลเฉพาะ ดังนั้นโมเดล Anthropic อื่นในกลุ่มเดียวกันอาจยังใช้งานได้ เพิ่มโปรไฟล์ Anthropic อีกโปรไฟล์หนึ่ง หรือรอให้ช่วงพักรอสิ้นสุด
