Tài liệu

Các Agent & Tools khác

Cấu hình tích hợp Techopenclaw cho VS Code, Windsurf, Cline, Aider, Continue và các công cụ khác.

Tôi chỉ phân biệt theo OS ở những chỗ shell syntax hoặc file path thực sự khác nhau; các bước thao tác trong UI giữ nguyên.

VS Code — Claude Code Extension

Tích hợp cấu hình vào file settings.json của VS Code (Cmd/Ctrl+Shift+P → "Preferences: Open Settings (JSON)"):

$HOME/Library/Application Support/Code/User/settings.json

Đường dẫn settings.json của VS Code thay đổi theo OS; phần JSON cấu hình bên dưới giữ nguyên.

"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_KEY" },
  { "name": "ANTHROPIC_BASE_URL", "value": "https://api.techopenclaw.com" },
  { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "gpt-5.4" },
  { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "gpt-5.4" },
  { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "gemini-3.1-pro" },
  { "name": "API_TIMEOUT_MS", "value": "3000000" }
]

Claude Code extension dùng endpoint Anthropic-compatible tại https://api.techopenclaw.com.

Windsurf

Giao diện Windsurf hiện không hỗ trợ tùy chỉnh Base URL trực tiếp. Đối với các mô hình BYOK (được gắn nhãn "BYOK"), truy cập Windsurf Settings → AI Settings và nhập API Key tương ứng.

Để tùy chỉnh endpoint đầy đủ, nên sử dụng Cline hoặc Cursor vì hỗ trợ sẵn Custom Base URL.

Cline

Từ giao diện Cline, truy cập Settings và cấu hình các thông số sau:

Base URL cần dùng là https://api.techopenclaw.com/v1.

API Provider:  OpenAI Compatible
Base URL:       https://api.techopenclaw.com/v1
API Key:        YOUR_KEY
Model ID:       gpt-5.4

Dùng đúng base URL trên để Cline gọi Techopenclaw API endpoint.

Sử dụng Provider OpenAI Compatible (không chọn "OpenAI") để hiển thị trường khai báo Base URL.

Continue

Hiệu chỉnh file cấu hình ~/.continue/config.yaml và thêm danh mục LLM:

~/.continue/config.yaml

Path Continue bên dưới áp dụng cho file cấu hình user-level theo OS.

Base URL cần dùng là https://api.techopenclaw.com/v1.

models:
  - name: Techopenclaw Claude Sonnet
    provider: openai
    model: gpt-5.4
    apiBase: https://api.techopenclaw.com/v1
    apiKey: YOUR_KEY
  - name: Techopenclaw GPT
    provider: openai
    model: gpt-5.4
    apiBase: https://api.techopenclaw.com/v1
    apiKey: YOUR_KEY

Dùng đúng base URL trên để Continue gọi Techopenclaw API endpoint.

Aider

Khởi tạo hoặc hiệu chỉnh file ~/.aider.conf.yml:

~/.aider.conf.yml

Path Aider bên dưới là file cấu hình tại home directory của user theo OS.

Base URL cần dùng là https://api.techopenclaw.com/v1.

openai-api-base: https://api.techopenclaw.com/v1
openai-api-key: YOUR_KEY
model: gpt-5.4

Dùng đúng base URL trên để Aider gọi Techopenclaw API endpoint.

Hoặc khai báo thông qua biến môi trường:

export OPENAI_API_BASE="https://api.techopenclaw.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
aider --model gpt-5.4

Nếu bạn chạy cmd.exe thay vì PowerShell, dùng block Windows cmd.exe tương ứng hoặc setx để lưu biến môi trường user-level.

Aider ưu tiên biến OPENAI_API_BASE (thay vì OPENAI_BASE_URL). Yêu cầu thêm tiền tố openai/ vào tên mô hình để định tuyến qua Custom Endpoint.

Codex CLI

Cấu hình tham số openai_base_url tại ~/.codex/config.toml:

~/.codex/config.toml

Path Codex CLI bên dưới là config user-level; nội dung config.toml không đổi theo OS.

Base URL cần dùng là https://api.techopenclaw.com/v1.

model            = "gpt-5.4"
openai_base_url  = "https://api.techopenclaw.com/v1"

Dùng đúng base URL trên để Codex CLI gọi Techopenclaw API endpoint.

Sau đó, thiết lập API Key:

export OPENAI_API_KEY="YOUR_KEY"
export OPENAI_BASE_URL="https://api.techopenclaw.com/v1"

Gemini CLI

Gemini CLI giao tiếp qua chuẩn API gốc. Techopenclaw hỗ trợ endpoint tương thích Gemini tại /v1beta:

npm install -g @google/gemini-cli

Lệnh cài đặt Gemini CLI dùng chung cho macOS, Linux và Windows PowerShell khi Node.js/npm đã sẵn sàng.

export GEMINI_API_KEY="YOUR_KEY"
export GEMINI_API_BASE_URL="https://api.techopenclaw.com"

Hỗ trợ biến GEMINI_API_BASE_URL khả dụng từ phiên bản gemini-cli v0.1.9 (08/2025). Cập nhật qua lệnh npm update -g @google/gemini-cli nếu cấu hình không hoạt động.

Amp Code

Bước 1 — Cấu hình UI: Thiết lập Amp Access Token và GitHub PAT trong giao diện User Settings.

Bước 2 — Định tuyến Endpoint: Hiệu chỉnh ~/.config/amp/settings.json:

~/.config/amp/settings.json

JSON cấu hình Amp Code không thay đổi theo OS, chỉ khác nơi lưu file.

{
  "amp.url": "https://api.techopenclaw.com"
}

Bước 3 — Xác thực: Hiệu chỉnh ~/.local/share/amp/secrets.json:

~/.local/share/amp/secrets.json

{
  "apiKey@https://api.techopenclaw.com": "YOUR_KEY"
}

Mọi mô hình LLM đều hỗ trợ giao tiếp qua cả hai định dạng endpoint — Techopenclaw sẽ tự động xử lý định tuyến (Automatic Routing).

OpenCode

Hiệu chỉnh ~/.config/opencode/opencode.json (Global) hoặc ./opencode.json (Local Project).

~/.config/opencode/opencode.json

OpenCode config là JSON thuần nên không cần phân biệt shell, chỉ cần phân biệt path global theo OS.

Định dạng Anthropic — /v1/messages — npm: @ai-sdk/anthropic

Base URL cần dùng là https://api.techopenclaw.com/v1.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic-compat": {
      "name": "Anthropic",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.techopenclaw.com/v1",
        "apiKey": "toc-....."
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT 5.3",
          "attachment": true,
          "reasoning": true,
          "limit": { "context": 200000, "output": 128000 }
        }
      }
    }
  }
}

Dùng đúng base URL trên để OpenCode gọi Techopenclaw API endpoint.