Chạy AutoGPT trên một base URL OpenAI tùy chỉnh.

Updated 2026-07-30

AutoGPT Classic đọc OPENAI_API_BASE_URL từ .env của nó và chuyển thẳng cho client OpenAI làm base_url. Trỏ nó vào https://api.apisrouter.com/v1, đặt một key, và traffic SMART_LLM cùng FAST_LLM của agent định tuyến qua một endpoint đo lường duy nhất.

Câu trả lời nhanh: hai dòng trong .env.

File .env.template của AutoGPT Classic ghi rõ OPENAI_API_BASE_URL là "Custom url for the OpenAI API, useful for connecting to custom backends", và code provider nối nó thẳng vào client: class OpenAICredentials đọc api_base từ biến đó và truyền nó làm base_url. Vậy nên việc ghi đè là bỏ comment một dòng và đặt key: OPENAI_API_BASE_URL thành https://api.apisrouter.com/v1 và OPENAI_API_KEY thành key gateway của bạn. Một lưu ý về phạm vi trước khi đi tiếp: điều này áp dụng cho AutoGPT Classic, agent tự động sống dưới classic/original_autogpt trong repo. AutoGPT Platform mới hơn của repo (trình xây dựng trực quan) quản lý credential model theo từng block qua backend riêng của nó, và biến môi trường này không phải cách bạn cấu hình nó.

OPENAI_API_BASE_URL=https://api.apisrouter.com/v1
OPENAI_API_KEY=sk-APIsRouter-...
SMART_LLM=gpt-5.4
FAST_LLM=gpt-5.4-mini

Cách AutoGPT Classic định tuyến các lệnh gọi model.

AutoGPT (Significant-Gravitas trên GitHub, khoảng 185K star, repo agent nhiều star nhất từng có) đi tiên phong cho vòng lặp tự động: agent lên kế hoạch, chọn một hành động, thực thi nó, đánh giá kết quả, và lặp lại tới khi mục tiêu hoàn thành hoặc ngân sách thì không. Classic chia việc dùng model của nó qua hai slot. SMART_LLM đảm nhận các lượt lý luận chính của agent, và FAST_LLM xử lý công việc nhẹ hơn; giá trị mặc định sống trong config dưới dạng giá trị enum, ghi đè được từ môi trường. Cơ chế định tuyến sạch một cách bất thường với một dự án lâu năm như thế này: OpenAICredentials.api_base là UserConfigurable từ OPENAI_API_BASE_URL, và get_api_access_kwargs() trao nó cho client OpenAI làm base_url. Mọi request provider-OpenAI mà agent thực hiện, lượt lên kế hoạch, quyết định dùng tool, tóm tắt, đều đi tới bất kỳ host nào biến đó gọi tên. Ràng buộc phân biệt AutoGPT với các công cụ tự do: SMART_LLM và FAST_LLM được gõ kiểu như enum ModelName, xác thực đối chiếu với registry model biên dịch sẵn trong agent, không phải chuỗi tự do. Registry của các bản build gần đây bao phủ dòng GPT-5 tới gpt-5.4 cùng các họ 4.1, 4o, và o-series, nhưng quy tắc thực tế là chọn từ những tên mà enum trong bản checkout của bạn thực sự chứa. Gateway sau đó nhận đúng id đó, nên id cũng phải tồn tại trong catalog; gpt-5.4 và gpt-5.4-mini thỏa cả hai phía hiện nay.

Cài đặt đầy đủ: .env đúng thư mục, model từ registry.

Sao chép .env.template thành .env bên trong classic/original_autogpt, bỏ comment và đặt bốn giá trị, và chạy agent từ thư mục đó. .env được nạp tương đối theo cấu trúc thư mục làm việc của agent classic, nên một file được cấu hình đẹp đẽ ở gốc repo chẳng làm gì cho nó. Việc chọn model là một lần tra registry, không phải chuyển tiếp nguyên trạng. Đặt SMART_LLM thành một id mà enum không chứa sẽ thất bại xác thực lúc khởi động, trước khi có bất kỳ request nào, ít nhất là thất bại một cách ồn ào. Hệ quả là các id Claude hoàn toàn không gọi được qua đường này: Classic có một provider Anthropic gốc riêng (ANTHROPIC_API_KEY) cho các tên enum đó, và provider đó không đọc OPENAI_API_BASE_URL. Nếu mục tiêu của bạn là một key qua một endpoint, giữ cả hai slot ở các tên registry-OpenAI mà gateway phục vụ. Kỷ luật ngân sách vẫn áp dụng. Vòng lặp tự động nổi tiếng vì tiêu tốn token thành từng đợt không giám sát, và việc định tuyến lại không đổi điều đó; nó khiến điều đó đo được. Các cài đặt ngân sách riêng của Classic vẫn đáng đặt, và góc nhìn sử dụng theo từng key cho bạn sổ cái bên ngoài mỗi lần chạy.

cd classic/original_autogpt
cp .env.template .env
# edit .env:
#   OPENAI_API_BASE_URL=https://api.apisrouter.com/v1
#   OPENAI_API_KEY=sk-APIsRouter-...
#   SMART_LLM=gpt-5.4
#   FAST_LLM=gpt-5.4-mini
./autogpt.sh run   # or: poetry run autogpt run

Chọn SMART_LLM và FAST_LLM.

So sánh trung thực là theo từng mục tiêu, không phải theo từng lệnh gọi: cho agent cùng một mục tiêu dưới hai lựa chọn SMART_LLM và so sánh tổng token cùng chất lượng kết quả trong log sử dụng. Agent tự động là khối lượng công việc duy nhất nơi model mạnh hơn thường thắng về tổng chi phí.

  • SMART_LLM là sự phán đoán của agent. Nó quyết định làm gì tiếp theo ở mỗi vòng lặp, và một quyết định tồi không chỉ lãng phí một lệnh gọi, nó sinh ra cả một nhánh lệnh gọi lãng phí. gpt-5.4 là lựa chọn phù hợp nhất hiện nay cho slot này, xét cả registry lẫn catalog.
  • FAST_LLM hấp thụ khối lượng công việc máy móc. gpt-5.4-mini giữ các lệnh gọi phụ trợ của vòng lặp ở một phần nhỏ so với giá của slot smart, điều này quan trọng vì các lần chạy tự động nhân mọi thứ lên.
  • Đừng bị cám dỗ chạy FAST_LLM làm slot smart để tiết kiệm tiền: vòng lặp tự động cộng dồn chất lượng quyết định, nên một bộ lên kế hoạch yếu hơn thường tốn tổng token nhiều hơn số nó tiết kiệm được mỗi lệnh gọi.
  • Tên registry thay đổi theo bản checkout. Sau khi pull một phiên bản mới, kiểm tra lại xem các tên bạn đã cấu hình còn xác thực được không; một lần đổi tên enum thất bại lúc khởi động với một lỗi rõ ràng, điều này tốt hơn một fallback âm thầm.

Trả theo mức sử dụng · thấp hơn giá chính thức

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Mô hìnhGiá chính thứcGiá của chúng tôi
GPT-5.4$2.50 / $15.00 per M$2.00 / $12.00 per M
GPT-5.4 mini$0.75 / $4.50 per M$0.60 / $3.60 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
GPT-5.6 Sol$5.00 / $30.00 per M$4.00 / $24.00 per M

Các kiểu lỗi đặc thù của AutoGPT.

Bẫy tên biến. Ba công cụ khác nhau dùng ba cách viết khác nhau: mem0 đọc OPENAI_BASE_URL, Aider đọc OPENAI_API_BASE, và AutoGPT Classic đọc OPENAI_API_BASE_URL. Thói quen từ một công cụ khác để lại sai biến, AutoGPT bỏ qua nó âm thầm, và request tiếp tục chảy tới api.openai.com trên bất kỳ giá trị OPENAI_API_KEY nào đang có. Request không xuất hiện trong log sử dụng gateway của bạn nghĩa là hãy kiểm tra điều này trước tiên. Enum từ chối lúc khởi động. SMART_LLM hoặc FAST_LLM đặt thành một id ngoài registry biên dịch sẵn sẽ thất bại xác thực trước khi agent chạy. Đây là hành vi đúng, nhưng nó gây bất ngờ cho người đến từ các công cụ tự do nơi mọi chuỗi đều được chuyển tiếp; lỗi này nghĩa là "chọn một tên registry", không phải "endpoint đang sập". Tên Claude định tuyến kiểu gốc. Tên enum Anthropic đi qua provider Anthropic và ANTHROPIC_API_KEY, bỏ qua OPENAI_API_BASE_URL. Nếu bạn mong đợi mọi request nằm trong một log sử dụng mà chỉ thấy một phần, traffic thiếu đó nằm trên một đường provider gốc. Sai .env. Agent classic nạp .env của chính thư mục nó. Một file ở gốc repo, hoặc một export shell bị che khuất bởi một giá trị .env cũ, tạo ra các trạng thái cấu hình nửa vời gây bối rối. Giữ cả bốn giá trị ở một chỗ: classic/original_autogpt/.env. Kỳ vọng nền tảng. Các block của AutoGPT Platform quản lý credential trong backend riêng của chúng; đặt biến môi trường này không định tuyến lại chúng. Đường đi của trang này là của Classic.

Ai định tuyến AutoGPT qua một gateway.

  • Lập trình viên hồi sinh Classic cho các thử nghiệm tự động, muốn cảm giác thèm token khét tiếng của vòng lặp nằm trên một sổ cái đo lường theo từng key ngay từ lần chạy đầu.
  • Người thích nghịch chạy các mục tiêu không giám sát dài, nơi khả năng quan sát theo từng request về việc agent thực sự làm gì với ngân sách của nó quan trọng ngang tổng số.
  • Đội chuẩn hóa một endpoint qua nhiều công cụ, nơi AutoGPT chỉ là một .env nữa trỏ vào cùng một key thay vì một tài khoản riêng.
  • Người dùng ghép phán đoán gpt-5.4 với khối lượng gpt-5.4-mini, tính giá theo từng token mà không kèm subscription cho cả hai slot.
  • Lập trình viên không có quyền truy cập billing của một vendor cụ thể. Truy cập dựa trên nạp tiền không yêu cầu thẻ loại bỏ phụ thuộc đăng ký theo từng provider.

Xác minh endpoint và debug lần chạy đầu tiên.

Xác nhận gateway phục vụ đúng id bạn đặt trong SMART_LLM và FAST_LLM; agent gửi các chuỗi đó nguyên văn. Bậc thang lần chạy đầu: một lỗi xác thực nêu tên model của bạn lúc khởi động nghĩa là id không nằm trong registry của bản build, nên chọn một tên registry khác. Một lỗi 401 nghĩa là OPENAI_API_KEY trong .env riêng của agent classic không phải key gateway. Một lỗi model-not-found từ gateway nghĩa là tên registry bạn chọn không nằm trong catalog; hãy khớp hai phía. Và một lần chạy hoạt động nhưng không bao giờ xuất hiện trong log sử dụng nghĩa là biến base URL bị gõ sai chính tả hoặc ở sai file, và traffic đang đi tới host mặc định. Khi vòng lặp đang chạy, hãy theo dõi góc nhìn theo từng request trong mục tiêu đầu tiên thay vì sau đó. Agent tự động bộc lộ hành vi token của chúng trong vài phút đầu, và bắt được một vòng lặp chạy trốn sớm đáng giá hơn bất kỳ chênh lệch giá theo token nào.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | head -50

Câu hỏi thường gặp

Biến môi trường nào đặt base URL tùy chỉnh cho AutoGPT?

OPENAI_API_BASE_URL, trong .env của agent classic. Nó được ghi trong .env.template như một URL tùy chỉnh để kết nối tới các backend tương thích OpenAI, và provider truyền nó cho client OpenAI làm base_url. Chú ý cách viết: nó khác với các biến công cụ khác dùng.

AutoGPT Classic có thể chạy model Claude qua base URL này không?

Không. SMART_LLM và FAST_LLM xác thực đối chiếu với registry model biên dịch sẵn của AutoGPT, và tên Anthropic định tuyến qua provider Anthropic gốc riêng, thứ không đọc OPENAI_API_BASE_URL. Để một key qua một endpoint, giữ cả hai slot ở các tên registry-OpenAI mà gateway phục vụ.

SMART_LLM và FAST_LLM có thể đặt thành gì?

Các tên từ enum ModelName trong bản checkout của bạn: các bản build gần đây bao phủ dòng GPT-5 tới gpt-5.4 cùng các họ 4.1, 4o, và o-series. Chuỗi không xác định thất bại xác thực lúc khởi động. gpt-5.4 và gpt-5.4-mini là lựa chọn vững chắc tồn tại trong cả registry lẫn catalog.

Cấu hình này có áp dụng cho AutoGPT Platform không?

Không. Platform (nửa trình xây dựng trực quan của repo) quản lý credential model theo từng block trong backend riêng của nó. OPENAI_API_BASE_URL cấu hình AutoGPT Classic, agent tự động dưới classic/original_autogpt.

Tôi có còn cần tài khoản OpenAI sau khi đặt base URL không?

Không. Với OPENAI_API_BASE_URL trỏ vào gateway, OPENAI_API_KEY giữ key gateway của bạn và không request nào đi tới host OpenAI. Tên biến là lịch sử để lại; credential là bất cứ gì endpoint sau base URL chấp nhận.

Một lần chạy AutoGPT tốn bao nhiêu?

Đây là khối lượng công việc khó đoán nhất trong danh sách này: vòng lặp tự quyết định số lệnh gọi của nó, nên chi phí tăng theo độ khó mục tiêu và tần suất agent sửa lại kế hoạch. Đặt các control ngân sách của agent, theo dõi trực tiếp góc nhìn sử dụng theo từng key trong các lần chạy đầu, và coi tổng token theo từng mục tiêu là thước đo.