> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fortapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

> OpenClaw 个人 AI 助手对接 FortAPI

[OpenClaw](https://github.com/openclaw/openclaw) 是一个跑在自己设备上的"个人 AI 助手"，可以通过 Telegram、WhatsApp、Discord、Signal、iMessage 等渠道使用。它默认支持多家模型供应商，**Anthropic 兼容**或 **OpenAI 兼容** 两种方式都能对接 FortAPI。

## 前置条件

<Steps>
  <Step title="FortAPI 账号 + API key">
    控制台 → **令牌** → **创建令牌**。详见 [API key 与安全](/zh/authentication)。
  </Step>

  <Step title="Node.js ≥ 18">
    ```bash theme={null}
    node --version
    ```

    没装：[nodejs.org](https://nodejs.org)。
  </Step>

  <Step title="操作系统">
    macOS / Linux 原生支持。Windows 推荐用 **WSL2**。
  </Step>
</Steps>

## 安装 OpenClaw

```bash theme={null}
npm install -g openclaw@latest
```

确认版本：

```bash theme={null}
openclaw --version
```

## 配置 FortAPI 端点

OpenClaw 走的是 Anthropic SDK，所以最简单的对接方式是设置 **`ANTHROPIC_BASE_URL`** + **`ANTHROPIC_API_KEY`** 两个环境变量，再在 `~/.openclaw/openclaw.json` 里指定要用的模型。

### 方法一：env + config 组合（推荐）

<Steps>
  <Step title="先跑一次 onboarding 创建配置目录">
    ```bash theme={null}
    openclaw onboard
    ```

    跟着向导走完。中途问到 "选择模型提供商" 时随便选一个（比如 Anthropic API key），key 可以先随便填一个占位，下一步会改。这一步是为了创建 `~/.openclaw/` 目录和初始配置。
  </Step>

  <Step title="编辑 openclaw.json">
    打开 `~/.openclaw/openclaw.json`（不存在就新建），改成：

    ```json5 theme={null}
    {
      env: {
        ANTHROPIC_BASE_URL: "https://www.fortapi.com",
        ANTHROPIC_API_KEY: "sk-你的FortAPI令牌",
      },
      agents: {
        defaults: {
          model: { primary: "anthropic/你的模型名" }, // 可用模型名见主站价格页面
        },
      },
    }
    ```

    <Warning>
      `ANTHROPIC_BASE_URL` 末尾 **不要** 加 `/v1`。
    </Warning>
  </Step>

  <Step title="重启 gateway">
    如果你之前装了 daemon：

    ```bash theme={null}
    openclaw onboard --install-daemon
    ```

    或者手动起：

    ```bash theme={null}
    openclaw gateway:start
    ```
  </Step>
</Steps>

### 方法二：shell 环境变量

懒得改配置文件，直接：

<Tabs>
  <Tab title="macOS / Linux">
    把这几行加进 `~/.zshrc` 或 `~/.bashrc`：

    ```bash theme={null}
    export ANTHROPIC_BASE_URL="https://www.fortapi.com"
    export ANTHROPIC_API_KEY="sk-你的KEY"
    ```

    然后 `source` 一下或者新开终端。
  </Tab>

  <Tab title="WSL2">
    同上，加进 WSL 里的 `~/.bashrc`。
  </Tab>
</Tabs>

`~/.openclaw/openclaw.json` 里依然要写 `agents.defaults.model` 指定具体模型，否则跑起来会问你选哪个。

## 第一次验证

启动并发一条消息：

```bash theme={null}
openclaw agent --message "用一句中文打招呼" --local
```

正常拿到回复 + FortAPI 控制台 → **日志** 看到对应的模型调用 = 成功。

如果你已经接好 Telegram / Discord 等渠道，直接在那边发消息也会用 FortAPI 处理。

## 选不同模型

改 `~/.openclaw/openclaw.json`：

```json5 theme={null}
{
  agents: {
    defaults: {
      model: { primary: "anthropic/你的模型名" }, // 可用模型名见主站价格页面
    },
  },
}
```

OpenClaw 用 `<provider>/<model-id>` 的命名格式。常用：

| 模型 ID                     | 用途      |
| ------------------------- | ------- |
| `anthropic/claude-sonnet` | 默认主力    |
| `anthropic/claude-opus`   | 复杂任务    |
| `anthropic/claude-haiku`  | 轻量 / 快速 |

完整列表在主站 [价格](https://www.fortapi.com) 页。

## 常见问题

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    * `ANTHROPIC_API_KEY` 填的是 **FortAPI** 令牌（`sk-...`），不是 Anthropic 官方 key。
    * 检查 FortAPI 控制台 → **令牌**，确认 key 没禁用、白名单没把这个模型排除。
  </Accordion>

  <Accordion title="404 / model not found">
    * 模型 ID 拼写要带 `anthropic/` 前缀，例如 `anthropic/claude-sonnet`。
    * `ANTHROPIC_BASE_URL` 末尾不要加 `/v1`。
  </Accordion>

  <Accordion title="openclaw onboard 卡住 / 一直转圈">
    * 检查能否 `curl -I https://www.fortapi.com` 通。
    * 退出 onboarding（Ctrl+C），手工编辑 `~/.openclaw/openclaw.json`，下次启动会读这个文件。
  </Accordion>

  <Accordion title="如何同时挂多个供应商做容灾">
    OpenClaw 支持 `models.providers` 配多个 provider + fallback 链。先跑通 FortAPI 单 provider，需要时参考 [官方配置文档](https://docs.openclaw.ai/gateway/configuration) 加 fallback。
  </Accordion>

  <Accordion title="想用 OpenAI 兼容协议而不是 Anthropic">
    在 `openclaw.json` 配一个自定义 provider：

    ```json5 theme={null}
    {
      models: {
        providers: {
          fortapi: {
            api: "openai",
            baseUrl: "https://www.fortapi.com/v1",
            apiKey: "sk-你的KEY",
            models: ["你的模型名"], // 可用模型名见主站价格页面
          },
        },
      },
      agents: {
        defaults: { model: { primary: "fortapi/你的模型名" } }, // 可用模型名见主站价格页面
      },
    }
    ```
  </Accordion>
</AccordionGroup>

## 进阶：渠道接入

OpenClaw 的核心价值在 "通过 IM 调用 Claude"。配好 FortAPI 之后，接 Telegram / Discord / Signal 等渠道按 [OpenClaw 渠道文档](https://docs.openclaw.ai/channels) 操作即可，模型调用自动走 FortAPI。