Providers
Anthropic
Anthropic สร้างตระกูลโมเดล Claude OpenClaw รองรับการยืนยันตัวตนสองเส้นทาง:
- API key — เข้าถึง Anthropic API โดยตรงพร้อมการคิดค่าบริการตามการใช้งาน (โมเดล
anthropic/*) - Claude CLI — ใช้การเข้าสู่ระบบ Claude CLI ที่มีอยู่บนโฮสต์เดียวกันซ้ำ
เริ่มต้นใช้งาน
API key
เหมาะที่สุดสำหรับ: การเข้าถึง API มาตรฐานและการคิดค่าบริการตามการใช้งาน
รับ API key ของคุณ
สร้าง API key ใน 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: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
Claude CLI
เหมาะที่สุดสำหรับ: การใช้การเข้าสู่ระบบ Claude CLI ที่มีอยู่ซ้ำโดยไม่ต้องมี API key แยกต่างหาก
ตรวจสอบให้แน่ใจว่า Claude CLI ติดตั้งและเข้าสู่ระบบแล้ว
ตรวจสอบด้วย:
claude --version
เรียกใช้ออนบอร์ดิง
openclaw onboard
# choose: Claude CLI
OpenClaw ตรวจพบและใช้ข้อมูลรับรอง Claude CLI ที่มีอยู่ซ้ำ
ตรวจสอบว่าโมเดลพร้อมใช้งาน
openclaw models list --provider anthropic
ตัวอย่างการกำหนดค่า
แนะนำให้ใช้ model ref มาตรฐานของ Anthropic พร้อมการ override รันไทม์ CLI:
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-7" },
agentRuntime: { id: "claude-cli" },
},
},
}
model refs แบบเดิม claude-cli/claude-opus-4-7 ยังคงใช้งานได้เพื่อ
ความเข้ากันได้ แต่การกำหนดค่าใหม่ควรเก็บการเลือก provider/model เป็น
anthropic/* และวางแบ็กเอนด์การทำงานไว้ใน agentRuntime.id
ค่าเริ่มต้นการคิด (Claude 4.6)
โมเดล Claude 4.6 ใช้การคิดแบบ adaptive เป็นค่าเริ่มต้นใน OpenClaw เมื่อไม่ได้ตั้งค่าระดับการคิดไว้อย่างชัดเจน
Override ต่อข้อความด้วย /think:<level> หรือในพารามิเตอร์โมเดล:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { thinking: "adaptive" },
},
},
},
},
}
การแคชพรอมป์
OpenClaw รองรับฟีเจอร์การแคชพรอมป์ของ Anthropic สำหรับการยืนยันตัวตนด้วย API key
| ค่า | ระยะเวลาแคช | คำอธิบาย |
|---|---|---|
"short" (ค่าเริ่มต้น) |
5 นาที | ใช้โดยอัตโนมัติสำหรับการยืนยันตัวตนด้วย API key |
"long" |
1 ชั่วโมง | แคชแบบขยาย |
"none" |
ไม่แคช | ปิดใช้งานการแคชพรอมป์ |
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { cacheRetention: "long" },
},
},
},
},
}
Override แคชต่อเอเจนต์
ใช้พารามิเตอร์ระดับโมเดลเป็นค่าพื้นฐาน จากนั้น override เอเจนต์เฉพาะผ่าน 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, override ตามคีย์)
วิธีนี้ทำให้เอเจนต์หนึ่งคงแคชระยะยาวไว้ได้ ขณะที่อีกเอเจนต์หนึ่งบนโมเดลเดียวกันปิดแคชสำหรับทราฟฟิกที่มาเป็นช่วงสั้นๆ/มีการใช้ซ้ำต่ำ
หมายเหตุ Bedrock Claude
- โมเดล Anthropic Claude บน Bedrock (
amazon-bedrock/*anthropic.claude*) ยอมรับการส่งผ่านcacheRetentionเมื่อตั้งค่าไว้ - โมเดล Bedrock ที่ไม่ใช่ Anthropic จะถูกบังคับเป็น
cacheRetention: "none"ขณะรันไทม์ - ค่าเริ่มต้นอัจฉริยะของ API key ยังเติม
cacheRetention: "short"ให้กับ refs Claude-on-Bedrock เมื่อไม่ได้ตั้งค่าไว้อย่างชัดเจน
การกำหนดค่าขั้นสูง
โหมดเร็ว
toggle /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-7 |
| อินพุตที่รองรับ | รูปภาพ, เอกสาร PDF |
เมื่อแนบรูปภาพหรือ PDF เข้ากับการสนทนา OpenClaw จะกำหนดเส้นทางผ่านผู้ให้บริการการทำความเข้าใจสื่อของ Anthropic โดยอัตโนมัติ
หน้าต่างบริบท 1M (เบต้า)
หน้าต่างบริบท 1M ของ Anthropic ถูกจำกัดด้วยสถานะเบต้า เปิดใช้งานต่อโมเดล:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { context1m: true },
},
},
},
},
}
OpenClaw แมปค่านี้เป็น anthropic-beta: context-1m-2025-08-07 ในคำขอ
params.context1m: true ยังใช้กับแบ็กเอนด์ Claude CLI
(claude-cli/*) สำหรับโมเดล Opus และ Sonnet ที่มีสิทธิ์ โดยขยายหน้าต่างบริบท
ของรันไทม์สำหรับเซสชัน CLI เหล่านั้นให้ตรงกับพฤติกรรม direct-API
บริบท 1M ของ Claude Opus 4.7
anthropic/claude-opus-4.7 และ variant claude-cli ของโมเดลนี้มีหน้าต่างบริบท 1M
เป็นค่าเริ่มต้น โดยไม่ต้องใช้ params.context1m: true
การแก้ไขปัญหา
ข้อผิดพลาด 401 / โทเค็นใช้ไม่ได้กะทันหัน
การยืนยันตัวตนด้วยโทเค็น Anthropic หมดอายุและอาจถูกเพิกถอนได้ สำหรับการตั้งค่าใหม่ ให้ใช้ Anthropic API key แทน
ไม่พบ API key สำหรับ provider "anthropic"
การยืนยันตัวตน Anthropic เป็นแบบ ต่อเอเจนต์ — เอเจนต์ใหม่จะไม่สืบทอดคีย์ของเอเจนต์หลัก เรียกใช้ออนบอร์ดิงอีกครั้งสำหรับเอเจนต์นั้น (หรือกำหนดค่า API key บนโฮสต์ gateway) จากนั้นตรวจสอบด้วย openclaw models status
ไม่พบข้อมูลรับรองสำหรับโปรไฟล์ "anthropic:default"
เรียกใช้ openclaw models status เพื่อดูว่าโปรไฟล์การยืนยันตัวตนใดทำงานอยู่ เรียกใช้ออนบอร์ดิงอีกครั้ง หรือกำหนดค่า API key สำหรับพาธโปรไฟล์นั้น
ไม่มีโปรไฟล์การยืนยันตัวตนที่พร้อมใช้งาน (ทั้งหมดอยู่ในคูลดาวน์)
ตรวจสอบ openclaw models status --json สำหรับ auth.unusableProfiles คูลดาวน์จาก rate limit ของ Anthropic อาจจำกัดตามโมเดล ดังนั้นโมเดล Anthropic ที่เป็นพี่น้องกันอาจยังใช้งานได้ เพิ่มโปรไฟล์ Anthropic อีกอันหรือรอให้คูลดาวน์สิ้นสุด