🤖 OpenClaw - 自托管 AI 智能助手平台¶

本页介绍如何将 OpenClaw 配置为通过 本站网关 访问模型，包括安装、配置以及对接本站的完整步骤。

项目介绍¶

OpenClaw 是一个开源、自托管的个人 AI 助手平台，将消息应用连接到运行在你自己硬件上的 AI 代理。专为开发者和高级用户设计，无需交出数据控制权即可拥有自主 AI 助手。

官方主页： https://openclaw.ai
项目文档： https://docs.openclaw.ai
GitHub： https://github.com/moltbot/moltbot

OpenClaw 完全开源（MIT 协议），你可以在 GitHub 仓库浏览源码、提交 Issue 或参与贡献。

核心特性¶

多渠道集成¶

全平台覆盖：支持飞书、Discord、Slack、Microsoft Teams 等多种主流即时通讯平台
单一网关：通过一个 Gateway 进程统一管理所有渠道
语音支持：支持 macOS/iOS/Android 语音交互
Canvas 界面：可渲染交互式 Canvas 界面

自托管与数据安全¶

完全自托管：运行在你自己的机器或服务器上
开源透明：MIT 开源协议，代码完全透明
数据本地化：上下文和技能存储在你的本地计算机，而非云端

智能代理能力¶

持续运行：支持后台常驻运行，拥有持久记忆
计划任务：支持 cron 定时任务
会话隔离：按代理/工作区/发送者隔离会话
多代理路由：支持多代理协同工作
工具调用：原生支持工具调用和代码执行

1️⃣ 在控制台创建令牌¶

打开控制台令牌页面：https://api-cs-al.naci-tech.com/console/token
点击「创建令牌」。

2️⃣ 安装 OpenClaw¶

环境要求：

Node.js 22 或更高版本
一个 AI 模型 API 密钥（即本站令牌）

npm install -g openclaw@latest

安装完成后运行引导向导：

openclaw onboard

3️⃣ 配置 OpenClaw 对接本站¶

配置文件位置¶

OpenClaw 的配置文件位于 ~/.openclaw/config.json，可通过引导向导自动生成，也可以手动编辑。

配置示例¶

以下是使用本站作为模型提供商的配置示例，将 $API_KEY 替换为你在控制台创建的令牌：

{
  "models": {
    "providers": {
      "agtcloud": {
        "baseUrl": "https://api-cs-al.naci-tech.com/v1",
        "apiKey": "$API_KEY",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4o",
            "name": "gpt-4o",
            "api": "openai-completions",
            "input": ["text", "image"],
            "contextWindow": 128000,
            "maxTokens": 16384
          },
          {
            "id": "claude-3-5-sonnet-20241022",
            "name": "claude-3-5-sonnet",
            "api": "openai-completions",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "agtcloud/gpt-4o",
        "fallbacks": ["agtcloud/claude-3-5-sonnet-20241022"]
      }
    }
  }
}

关键配置说明¶

配置项	说明
`models.providers.agtcloud.baseUrl`	agtcloud 网关地址，需包含 `/v1`
`models.providers.agtcloud.apiKey`	在控制台创建的 agtcloud 令牌
`models.providers.agtcloud.models`	模型列表，可按需添加 agtcloud 支持的任意模型
`agents.defaults.model.primary`	默认主模型，格式为 `provider/model-id`
`agents.defaults.model.fallbacks`	备选模型列表，主模型不可用时自动切换

提示： 具体可用的模型 ID 可在 agtcloud 控制台的「渠道管理」中查看，或参考接口文档。

4️⃣ 启动服务¶

配置完成后，启动 OpenClaw：

openclaw start

启动后即可通过配置的渠道（如飞书、Discord 等）与 AI 助手进行交互。

5️⃣ 验证是否通过本站网关¶

在配置的渠道中向 OpenClaw 发送一条消息。
返回到本站控制台，在「使用日志」中确认对应调用是否已经记录，并且分组为 openclaw。

如果能在控制台看到调用记录，说明 OpenClaw 已经成功通过本站网关进行访问。