---
title: OpenClaw 使用教程
sidebarTitle: OpenClaw
description: 安装 OpenClaw Agent，配置无限星河AI接口、模型和鉴权，并了解技能与自动化的使用边界。
---

OpenClaw 是一个可以连接技能、通讯工具和本地文件的 AI Agent。它比普通聊天软件复杂，不熟悉配置文件的用户建议先使用 Chatbox 或 Cherry Studio。

## 安装 OpenClaw

按照 [OpenClaw 安装说明](https://docs.openclaw.ai/) 完成安装，然后运行：

```bash
openclaw onboard
```

![OpenClaw 初始化](/images/tutorials/openclaw/openclaw-choose-gateway.png)

## 配置 API Key

Windows PowerShell：

```powershell
$env:INFISTAR_API_KEY = "你的_API_Key"
```

macOS 或 Linux：

```bash
export INFISTAR_API_KEY="你的_API_Key"
```

## 配置模型

打开 `%USERPROFILE%\.openclaw\openclaw.json` 或 `~/.openclaw/openclaw.json`，加入下面的配置并替换模型 ID：

```json5
{
  models: {
    mode: "merge",
    providers: {
      infistar: {
        baseUrl: "https://infistar.cc/v1",
        apiKey: "${INFISTAR_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "模型广场中的原始模型ID",
            name: "模型广场中的原始模型ID"
          }
        ]
      }
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "infistar/模型广场中的原始模型ID"
      }
    }
  }
}
```

## 检查配置

运行：

```bash
openclaw models list
```

看到 `infistar/模型ID` 就表示模型已被识别。第一次使用时不要直接授权删除文件、安装软件或发送外部消息。

## 遇到问题

- **配置文件打不开**：确认文件名是 `openclaw.json`，不是旧版 `config.yaml`。
- **没有显示模型**：确认默认模型写成 `infistar/原始模型ID`。
- **提示 401**：重新设置 `INFISTAR_API_KEY`。
- **提示 404**：`baseUrl` 应为 `https://infistar.cc/v1`。