go-calcom cung cấp cho các dự án Go một client được tạo có kiểu dữ liệu để quản lý tài nguyên lập lịch Cal.com API v2.
Cài đặt & Tải xuống
1. ClawHub CLI
Cách nhanh nhất để cài đặt kỹ năng trực tiếp từ thư viện.
npx clawhub@latest install go-calcom
2. Cài đặt Thủ công
Sao chép thư mục kỹ năng vào một trong những vị trí sau
~/.openclaw/skills/ <project>/skills/ Ưu tiên: Không gian làm việc > Cục bộ > Gói sẵn
3. Cài đặt Prompt
Sao chép prompt này vào OpenClaw để tự động cài đặt.
Giúp tôi cài đặt go-calcom bằng Clawhub. Nếu Clawhub chưa
Bạn muốn tải xuống?
Nhận các tệp kỹ năng gốc dưới dạng lưu trữ ZIP.
go-calcom là gì?
go-calcom là một client Go không chính thức cho Cal.com API v2, được cung cấp trong gói calcom và được tạo từ tài liệu OpenAPI công khai của Cal.com. Nó hiển thị các phương thức và mô hình có kiểu dữ liệu cho việc đặt chỗ, loại sự kiện, khoảng thời gian trống, lịch trình, lịch, nhóm, webhook và các thao tác hồ sơ.
Đối với các nhà phát triển khám phá Openclaw Skills, kỹ năng này giải thích cách cài đặt và sử dụng client, xác thực an toàn, khám phá các phương thức được tạo và xử lý phản hồi API. Nó hướng dẫn chỉnh sửa mã nguồn Go trong dự án hiện tại; bản thân client không đọc hoặc ghi tệp.
Trường hợp sử dụng go-calcom
- Kiểm tra tính khả dụng, đặt chỗ, loại sự kiện, lịch trình, lịch hoặc dữ liệu hồ sơ của Cal.com từ ứng dụng Go.
- Tạo, đổi lịch hoặc hủy đặt chỗ khi được yêu cầu rõ ràng cho các tài nguyên dự định.
- Quản lý lịch trình, loại sự kiện, nhóm hoặc webhook thông qua Cal.com API v2.
- Làm việc trong một dự án Go đã nhập
github.com/psyb0t/go-calcom. - Sử dụng Openclaw Skills để hướng dẫn việc thực hiện các thao tác lập lịch Cal.com bằng các phương thức Go có kiểu dữ liệu thay vì đoán các điểm cuối (endpoints).
- Không sử dụng gói này cho các dự án không phải Go hoặc khi cần một client được bảo trì bởi Cal.com.
Cách thức hoạt động của go-calcom
- Cài đặt module Go và kiểm tra tài liệu gói được tạo để tìm ID thao tác chính xác, kiểu tham số, mô hình và mô tả điểm cuối.
- Đọc các tham số đường dẫn (path), truy vấn (query) và tiêu đề (header) bắt buộc của thao tác. Điền các trường
Authorizationbắt buộc và sử dụngCalApiVersioncụ thể của điểm cuối khi cần thiết. - Tạo client bằng
calcom.NewClientWithResponses, chỉ sử dụnghttps://api.cal.comhoặc một triển khai khác khi được định cấu hình rõ ràng. Các đường dẫn được tạo đã bao gồm/v2. - Thực hiện yêu cầu với một context và phương thức thao tác được tạo. Thêm trình chỉnh sửa yêu cầu (request editor) nếu cần để đặt tiêu đề xác thực Bearer.
- Kiểm tra lỗi truyền tải và giải mã, sau đó kiểm tra
StatusCode()và trường thành công được giải mã khớp, chẳng hạn nhưJSON200. Các trường thành công có thể là nil đối với các mã trạng thái khác; kiểm traBodyđể tìm lỗi API. - Coi các thay đổi (mutations) là thay đổi tài khoản: việc tạo, đổi lịch hoặc hủy đặt chỗ và chỉnh sửa lịch trình, loại sự kiện, nhóm hoặc webhook chỉ nên diễn ra khi được yêu cầu.
Cài đặt go-calcom
Cài đặt chuỗi công cụ Go và thêm module từ trong dự án Go của bạn:
go get github.com/psyb0t/go-calcom
Đặt CALCOM_API_KEY trong môi trường chạy; không bao giờ mã hóa cứng (hardcode), cam kết (commit) hoặc ghi nhật ký thông tin đăng nhập hoặc tiêu đề yêu cầu. Định cấu hình mã thông báo Bearer và tạo client, ví dụ:
token := "Bearer " + os.Getenv("CALCOM_API_KEY")
auth := calcom.WithRequestEditorFn(func(_ context.Context, req *http.Request) error {
req.Header.Set("Authorization", token)
return nil
})
client, err := calcom.NewClientWithResponses("https://api.cal.com", auth)
Sử dụng go doc để khám phá tên thao tác và kiểu dữ liệu thay vì đoán. URL cơ sở của API không được chứa phân đoạn đường dẫn /v2 bổ sung vì các đường dẫn được tạo đã bao gồm phân đoạn này.
go doc github.com/psyb0t/go-calcom ClientWithResponsesInterface
go doc github.com/psyb0t/go-calcom BookingsController20240813GetBookingsParams
go doc -all github.com/psyb0t/go-calcom
Các tham số tiêu đề thao tác bắt buộc phải được điền ngay cả khi trình chỉnh sửa yêu cầu đặt tiêu đề cuối cùng. Sử dụng phiên bản API được ghi lại của từng điểm cuối; /v2/me không chỉ định tiêu đề phiên bản. Tham khảo tài liệu gói tại pkg.go.dev để biết thêm chi tiết.
Lược đồ dữ liệu & Hệ thống phân loại của go-calcom
Client sử dụng các kiểu Go được tạo dựa trên tài liệu OpenAPI Cal.com API v2 công khai; nó không định nghĩa kho lưu trữ dữ liệu cục bộ hoặc tạo tệp dự án tại thời gian chạy.
| Khu vực | Tổ chức |
|---|---|
| Gói | Thư mục gốc của module, được nhập là github.com/psyb0t/go-calcom và được đặt tên là calcom |
| Thao tác | Các phương thức được tạo có tên từ ID thao tác OpenAPI nguồn, bao gồm tên bộ điều khiển (controllers) và phiên bản điểm cuối |
| Tham số | Các cấu trúc (structs) cụ thể cho thao tác được tạo cho các tham số truy vấn và tiêu đề; tham số đường dẫn được truyền theo thứ tự đã khai báo của phương thức |
| Xác thực và quản lý phiên bản | Các trường Authorization và, nếu được chỉ định, CalApiVersion trên các cấu trúc tham số thao tác |
| Phản hồi | Các trường cụ thể theo trạng thái có kiểu dữ liệu như JSON200 hoặc JSON201; các trường này có thể là nil đối với các mã trạng thái khác |
| Mô hình | Các mô hình yêu cầu và phản hồi được tạo cho các tài nguyên API được hỗ trợ; các trường tùy chọn hoặc có thể có giá trị null có thể là con trỏ, và các trường số là float64 |
| Tệp và siêu dữ liệu | Không có tệp nào được đọc hoặc ghi bởi client. Phạm vi bao phủ tuân theo tài liệu nguồn có tiêu đề Cal.diy API v2, phiên bản thông số kỹ thuật 1.0.0; hãy xác minh tài liệu trực tuyến trước khi giả định rằng mọi thao tác API được lưu trữ đều được bao gồm. |
Tính năng Nâng cao của go-calcom
- Các phương thức
WithResponseđược tạo hiển thị các trường phản hồi đã giải mã cụ thể theo trạng thái cũng như thông tin trạng thái và nội dung (body). - Các hook của trình chỉnh sửa yêu cầu cho phép người gọi tùy chỉnh các yêu cầu HTTP đi, bao gồm việc thiết lập tiêu đề Authorization.
- Các cuộc gọi nhận thức context hỗ trợ vòng đời yêu cầu Go tiêu chuẩn và các mẫu hủy.
- Các kiểu tham số cụ thể của điểm cuối tài liệu hóa các tiêu đề bắt buộc và ngăn chặn việc phụ thuộc vào một phiên bản API toàn cục duy nhất.
- Tên thao tác được tạo và nhận xét Go doc cung cấp một giao diện có thể khám phá; sử dụng
go dochoặc pkg.go.dev để kiểm tra toàn bộ bề mặt phương thức và mô hình. - Kỹ năng nhấn mạnh việc xử lý thông tin đăng nhập an toàn và coi các thay đổi về đặt chỗ, lịch trình, loại sự kiện, nhóm và webhook là các thao tác thay đổi tài khoản rõ ràng.
SKILL.md
Đang tải
Các kỹ năng Openclaw liên quan
go-klavis
go-klavis là ứng dụng khách Go được tạo tự động, không chính thức, dùng để khám phá máy chủ Klavis MCP, gọi công cụ và quản lý các tài nguyên API liên quan.
go-intercom
go-intercom là ứng dụng khách Go được tạo tự động, không chính thức, cho phép truy cập dữ liệu hỗ trợ khách hàng và workspace của Intercom thông qua các phương thức REST API có kiểu.
go-unstructured
go-unstructured cung cấp các Go client có kiểu, được tạo tự động và không chính thức cho các thao tác Unstructured Platform và phân vùng tài liệu multipart.
go-polar
go-polar cung cấp cho các dự án Go ứng dụng khách có kiểu để quản lý tài nguyên và thao tác của Polar API.
go-mistral
go-mistral cung cấp cho các ứng dụng Go quyền truy cập có kiểu vào các endpoint REST API của Mistral AI thông qua các phương thức máy khách được tạo tự động.
go-browser-use
Dùng go-browser-use để xây dựng các tích hợp Go có kiểu dữ liệu cho Browser Use Cloud API v4, từ các lượt chạy tác tử đến phiên trình duyệt và tệp.
Đặc sắc*
