# Hướng dẫn cấu hình OpenClaw

> Dùng openclaw.json để kết nối OpenClaw với giao diện Anthropic Messages của LLMoxy.

Trang web: [https://openclaw.ai](https://openclaw.ai)

Mã nguồn: [GitHub openclaw/openclaw](https://github.com/openclaw/openclaw) · Bản mirror trong nước (Trung Quốc): [Gitee OpenClaw-CN](https://gitee.com/OpenClaw-CN/openclaw-cn)

OpenClaw (đổi tên từ Clawdbot) cấu hình mô hình bằng tệp `openclaw.json` cục bộ. Nếu cài plugin hoặc SDK thất bại, hãy đổi tên gói thành OpenClaw rồi thử lại.

Trước khi bắt đầu, hãy chuẩn bị một [mã thông báo LLMoxy](https://vi.llmoxy.com/docs/get-started/get-token), nên dùng nhóm **auto**.

## Cài đặt

```bash
npm i -g openclaw
```

Vị trí tệp cấu hình:

| Hệ điều hành | Đường dẫn |
| --- | --- |
| Windows | `%USERPROFILE%\.openclaw\openclaw.json` |
| macOS / Linux | `~/.openclaw/openclaw.json` |

Cũng có thể tải trực tiếp mẫu đầy đủ, thay khóa rồi ghi đè lên các tệp trên:

- [openclaw.json bản Windows](https://vi.llmoxy.com/docs-assets/migrated/tutorial-openclaw/file-01.json)
- [openclaw.json bản macOS](https://vi.llmoxy.com/docs-assets/migrated/tutorial-openclaw/file-02.json)

## Kết nối LLMoxy

Gộp hai đoạn dưới đây vào `openclaw.json` hiện có. Địa chỉ tương thích Anthropic **không có** `/v1`.

```json
{
  "models": {
    "providers": {
      "claude": {
        "baseUrl": "https://llmoxy.com",
        "apiKey": "API Key LLMoxy của bạn",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-5-5",
            "name": "claude-opus-5-5",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "claude/claude-opus-5-5" },
      "models": {
        "claude/claude-opus-5-5": { "alias": "claude-opus-5-5" }
      }
    }
  }
}
```

Khi dùng giao diện với mục "máy chủ tùy chỉnh / mô hình tùy chỉnh", hãy điền cùng bộ giá trị:

| Trường | Giá trị |
| --- | --- |
| `baseUrl` / Điểm cuối API | `https://llmoxy.com` |
| `api` | `anthropic-messages` |
| `apiKey` | Mã thông báo LLMoxy |
| ID mô hình | `claude-opus-5-5` |

![Mô hình tùy chỉnh](https://vi.llmoxy.com/docs-assets/migrated/tutorial-openclaw/image-01.png)

## Khởi động

```bash
openclaw gateway
```

Mở `http://localhost:18789` trong trình duyệt.

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

**Cài đặt thất bại, không tìm thấy gói**
Kho mã đã được đổi tên. Khi cài đặt và dùng plugin hãy dùng `openclaw`, đừng dùng `clawdbot` nữa.

**Dùng chế độ tương thích OpenAI thay vì Anthropic**
Đổi `api` thành `openai-completions`, đổi `baseUrl` thành `https://llmoxy.com/v1`.

Đây là bản markdown của https://vi.llmoxy.com/docs/code-tutorials/openclaw.
