Client/Hermes Agent
Dùng Wokey API với Hermes Agent
Lấy khóa API Wokey, trỏ Hermes Agent đến base URL của Wokey, rồi xác nhận kết nối bằng một yêu cầu curl.
Cập nhật
Trên trang nàyexpand_more
Lấy khóa API và base URLlink
Mọi client đều dùng cùng một khóa API Wokey và cùng một base URL.
Tạo khóa API
Đăng nhập và tạo khóa nền tảng trên trang API. Các khóa trong cùng một tài khoản dùng chung số dư của tài khoản đó.
Tạo khóa APIkeyDùng base URL của Wokey
Đặt base URL của client là tên miền của gateway; cấu hình bên dưới cho biết có cần thêm /v1 hay không.
Cấu hình clientlink
Hermes Agent chỉ cần năm dòng cấu hình đầu tiên cho mô hình, provider tùy chỉnh, Base URL và khóa API. Với các mô hình GPT (như gpt-6-sol), hãy thêm api_mode: codex_responses để có tỷ lệ trúng cache tốt nhất; với các mô hình khác như Claude thì bỏ dòng này.
# ~/.hermes/config.yaml
model:
default: claude-opus-5-5
provider: custom
base_url: https://api.wokey.ai
api_key: YOUR_API_KEY
# Chỉ dành cho mô hình GPT (như gpt-6-sol) — bỏ chú thích để có tỷ lệ trúng cache tốt nhất:
# api_mode: codex_responsesĐịnh dạng API và base URLlink
Khi một client chuyển sang định dạng API khác, việc base URL có kết thúc bằng /v1 hay không có thể thay đổi.
| Định dạng | Base URL | Dùng cho |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai | DeepSeek, GLM, Kimi và các mô hình khác |
Nơi cấu hình: ~/.hermes/config.yaml
Chạy Hermes Agent như một agent chạy liên tục với Opus 5.5: so sánh với Claude Duetlink
Ngày 2026-10-21, Anthropic mở bản xem trước nghiên cứu (research preview) của Claude Duet, một agent chủ động xây dựng trên Claude Opus 5.5: gửi bản tóm tắt mỗi sáng, theo dõi các ứng dụng bạn đã kết nối ở chế độ nền và hỏi ý bạn trước khi hành động. Duet chỉ dùng được khi đăng nhập bằng tài khoản Claude; không có khóa API hay base URL tùy chỉnh, nên không thể chạy qua Wokey. Hermes Agent là agent chạy liên tục mã nguồn mở, do bạn tự lưu trữ: khi kết nối với Wokey, nó dùng cùng mô hình Opus 5.5, không cần danh sách chờ và không giới hạn khu vực.
| Claude Duet | Hermes Agent + Wokey | |
|---|---|---|
| Mô hình | Claude Opus 5.5, không thể đổi | claude-opus-5-5, hoặc bất kỳ mô hình nào khác trên Wokey |
| Ai có thể dùng | Người đăng ký Claude Pro và Max tại Mỹ, qua danh sách chờ; chưa hỗ trợ Team và Enterprise | Bạn tự cài đặt; chỉ cần một khóa API Wokey, ở bất kỳ khu vực nào |
| Chi phí | Không tính thêm phí trong thời gian xem trước, nhưng dùng chung giới hạn sử dụng của gói với chat và Claude Code, kể cả các lần kiểm tra nền | Trả theo token từ số dư Wokey của bạn; bạn quyết định tần suất kiểm tra |
| Chạy ở đâu | Một máy ảo có trình duyệt riêng trên đám mây của Anthropic; vẫn hoạt động khi điện thoại và laptop của bạn đã tắt | Máy tính hoặc máy chủ của chính bạn; để chạy suốt ngày đêm, hãy đặt nó trên một máy luôn bật |
| Cách trò chuyện với nó | Ứng dụng Duet (iOS và Android) và claude.ai | Các ứng dụng chat như Telegram và Slack |
| Bộ nhớ và công cụ | Kế thừa bộ nhớ, skills và connector từ tài khoản Claude của bạn | Bộ nhớ, skills và công cụ nằm trên máy cục bộ; bạn tự cài đặt và quản lý |
| Phê duyệt trước khi hành động | Hỏi trước khi gửi tin nhắn, thanh toán, ký hoặc xóa; giao dịch chứng khoán và chuyển tiền giữa các tài khoản luôn bị cấm | Bạn tự đặt quyền và quy tắc phê duyệt; chỉ cấp quyền cho những tài khoản cần thiết |
- Khi tính phí theo token, kiểm tra càng thường xuyên thì càng tốn: mỗi lần kiểm tra đều gửi lại system prompt và bộ nhớ. Hãy dùng mô hình rẻ hơn (chẳng hạn claude-sonnet-5-5 hoặc deepseek-v4.1-flash) cho các lần kiểm tra định kỳ, và chuyển sang Opus 5.5 khi cần ra quyết định và hành động.
- Qua Chat Completions, Opus 5.5 suy nghĩ trước khi viết, nên token đầu tiên đến chậm; agent chạy ở chế độ nền hầu như không bị ảnh hưởng.
- Cấu hình ở trên đã mặc định dùng claude-opus-5-5; không cần thay đổi gì.
Thông tin về Duet được kiểm tra ngày 2026-10-22 · Nguồn thông tin về Duet: Introducing Claude Duet · Claude Duet FAQ
Kiểm tra bằng curllink
Nếu client báo lỗi, trước hết hãy dùng curl để loại trừ vấn đề về khóa API và base URL.
Hermes Agent mặc định dùng định dạng OpenAI Chat Completions. Nếu yêu cầu này trả về 200 thì khóa API và base URL đều đúng. Hãy thay YOUR_API_KEY bằng khóa của bạn trước khi gửi.
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'Lỗi và khắc phục sự cốlink
Trước hết hãy phân biệt các trường hợp xác thực, số dư, giới hạn tốc độ, mô hình không khả dụng và upstream hết thời gian chờ.
invalid api key
Khóa bị thiếu, nhập sai, đã bị xóa, hoặc header Authorization / x-api-key mâu thuẫn nhau.
insufficient balance
Số dư tài khoản quá thấp. Hãy nạp tiền trước khi gửi thêm yêu cầu.
model_denylisted / account_restricted
Lệnh gọi đến mô hình, hoặc đến mọi mô hình trên tài khoản, bị tạm dừng sau nhiều lần vi phạm. Xem Phí xử lý vi phạm và giới hạn.
request_blocked
Yêu cầu này bị chặn trước khi đến upstream và không bị tính phí, ví dụ gửi lại nguyên vẹn một yêu cầu mà mô hình vừa từ chối, hoặc người dùng cuối đang bị tạm dừng (X-End-User-Id). Thông báo lỗi cho biết điều gì bị chặn; hãy sửa yêu cầu theo thông báo hoặc thử lại sau. Các yêu cầu khác không bị ảnh hưởng.
rate limited
Lưu lượng quá dày. Hãy thử lại sau hoặc giảm số yêu cầu đồng thời. Nếu chỉ một mô hình, hoặc một người dùng cuối (X-End-User-Id), liên tục trả về 429, đó có thể là giới hạn tạm thời sau khi vi phạm.
client disconnected
Client đã đóng kết nối trước khi phản hồi hoàn tất (mã downstream_aborted). Mặc định trường hợp này miễn phí. Khi một tài khoản có ít nhất 50 lần client ngắt kết nối trong 24 giờ qua và chúng chiếm từ 10% số yêu cầu trở lên, các yêu cầu bị ngắt kết nối sau đó sẽ bị tính phí theo mức sử dụng mà upstream báo cáo: phần đầu vào đã xử lý, bao gồm đọc và ghi cache, và phần đầu ra chỉ khi upstream đã tính. Ngắt kết nối trước khi upstream báo cáo bất kỳ mức sử dụng nào vẫn miễn phí. Tài khoản sẽ được thông báo khi bắt đầu tính phí, và việc tính phí tự động dừng trong vòng một giờ khi tỷ lệ ngắt kết nối trở lại bình thường. Nguyên nhân thường gặp là thời gian chờ của client hoặc proxy quá ngắn, hoặc chương trình hủy yêu cầu trước khi chúng hoàn tất.
upstream unavailable
Dịch vụ mô hình upstream tạm thời không khả dụng. Hãy đổi mô hình hoặc thử lại sau.
upstream timeout
Phản hồi từ upstream hết thời gian chờ. Hãy rút ngắn ngữ cảnh, giảm max_tokens hoặc thử lại.
upstream overloaded
Mô hình upstream tạm thời quá tải và Wokey đã thử lại trên các tuyến khác (mã upstream_overloaded). Lỗi này không liên quan đến số dư của bạn. Hãy thử lại sau ít phút hoặc đổi mô hình.
Câu hỏi thường gặplink
- base_url của Hermes Agent có cần kết thúc bằng /v1 không?
- Không. Đặt base_url là https://api.wokey.ai và provider là custom.
- Khi nào cần thêm api_mode: codex_responses?
- Chỉ khi dùng mô hình GPT như gpt-6-sol, vì nó cho tỷ lệ trúng cache tốt nhất. Bỏ qua với Claude và các mô hình khác.
- Khóa API đặt ở đâu?
- Trong trường api_key dưới model trong ~/.hermes/config.yaml, chỉ riêng khóa.