快速开始

5 分钟内完成安装并开始使用 AI Agent

1. 注册账户

访问 用户中心，注册一个账户。注册后自动获得 API Key 和体验额度。

2. 一键安装

在你的电脑上执行以下命令：

Windows (PowerShell):

$env:OPENCLAW_KEY="你的API Key"; irm https://lhyijian.xyz/install.ps1 | iex

Linux / macOS:

curl -fsSL https://lhyijian.xyz/install.sh | bash -s -- 你的API_Key

安装脚本会自动完成 Node.js 安装、OpenClaw CLI 配置、API 代理设置、QQ Bot 插件安装。

3. 启动使用

# 启动 Gateway
openclaw gateway --port 15454

# 新终端窗口，进入交互式 TUI
openclaw tui

# 或发送单条消息
openclaw agent -m "帮我写一个 Python 脚本"

API 参考

完全兼容 OpenAI Chat Completions API 格式

Base URL

https://lhyijian.xyz/v1

认证

所有代理请求需要在 Header 中传入 API Key：

Authorization: Bearer sk-proxy-your-key-here

POST /v1/chat/completions

发起一次 Chat 对话。支持流式和非流式。

curl https://lhyijian.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-proxy-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-4-flash",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
  }'

GET /v1/models

获取所有可用模型列表。

curl https://lhyijian.xyz/v1/models

Python SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://lhyijian.xyz/v1",
    api_key="sk-proxy-your-key",
)

resp = client.chat.completions.create(
    model="glm-4-flash",
    messages=[{"role": "user", "content": "你好！"}],
)
print(resp.choices[0].message.content)

响应头

Header	说明
X-Balance-Warning	余额低于阈值时返回警告信息

错误码

HTTP	Code	说明
401	invalid_api_key	API Key 无效或已过期
402	insufficient_balance	余额不足
403	model_not_allowed	API Key 无权使用该模型
429	rate_limited	请求频率超限
502	provider_error	上游服务商错误

模型与定价

所有价格单位为 CNY / 百万 tokens

实际价格以 /v1/models 返回为准。管理员可通过后台调整模型定价。

QQ 机器人配置

用 QQ 远程操控你的电脑

前置条件

• 已完成 OpenClaw 一键安装
• 有一个 QQ 号用于注册 QQ 开放平台

Step 1: 注册 QQ 开放平台

访问 q.qq.com，使用 QQ 号登录，创建一个 QQ 机器人应用。

创建后，在应用管理页面复制 AppID 和 AppSecret。

Step 2: 安装 QQ Bot 插件

如果已通过一键安装脚本安装，此步可跳过。手动安装：

openclaw plugins install @sliverp/qqbot@latest

Step 3: 配置连接

openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"

Step 4: 启动并测试

openclaw gateway --port 15454

启动后，打开手机 QQ，找到你的机器人，发送一条消息测试。

飞书机器人配置

用飞书远程操控你的电脑，支持私聊和群聊

前置条件

• 已完成 OpenClaw 一键安装（方式 A），或已安装 Python 3.7+（方式 B）
• 拥有飞书企业帐号或开发者测试企业帐号

Step 1: 创建飞书应用

访问 open.feishu.cn/app，创建一个「企业自建应用」。

在「凭证与基础信息」页面复制 App ID 和 App Secret。

Step 2: 配置权限和能力

• 在「权限管理」中开通 im:message、im:message:send_as_bot、im:chat
• 在「应用能力」中启用机器人能力
• 在「事件订阅」中选择「使用长连接接收事件」，先不添加事件，直接保存
• 在「版本管理与发布」中创建版本并发布应用

Step 3: 接入方式

方式 A：OpenClaw 飞书插件（推荐）

openclaw plugins install @openclaw/feishu
openclaw channels add --channel feishu

或手动编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "YOUR_APP_SECRET"
        }
      }
    }
  }
}

方式 B：独立 Python 脚本

pip install lark-oapi httpx
curl -O https://lhyijian.xyz/feishu_bot.py
python feishu_bot.py --app-id cli_xxx --app-secret YOUR_SECRET --api-key sk-proxy-xxx

支持环境变量配置：FEISHU_APP_ID、FEISHU_APP_SECRET、OPENCLAW_API_KEY。

内置命令：/reset（重置对话）、/model（查看模型）、/help（帮助）。

Step 4: 启动并测试

openclaw gateway --port 15454

启动后，在飞书中找到你的机器人，发送一条消息测试。群聊中需要 @机器人名称 触发。

常见问题

常见问题

遇到问题？先看看这里