callxyq 使用文档

Appearance

OpenClaw 配置指南 ​

多平台 AI 编程代理，支持终端 TUI、Web Dashboard 和 Telegram Bot

📋 简介

OpenClaw 是一款功能丰富的 AI 编程代理工具，支持终端 TUI 交互、Web Dashboard 管理和 Telegram Bot 远程访问。适合需要在服务器环境中运行 AI 编程助手的开发者。

⚠️ 适用环境

此教程适合 Linux 云服务器 和 macOS 系统用户。

使用 callxyq 渠道时，建议按供应商类型补齐 headers 字段。对于 Claude Opus 4.6 这类 anthropic-messages 配置，推荐使用下面这组请求头：

json
{
  "authHeader": true,
  "headers": {
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
    "Accept": "application/json",
    "Accept-Language": "en-US,en;q=0.9"
  }
}
  • authHeader: true 表示 OpenClaw 会自动把 apiKey 作为认证头带上
  • User-Agent、Accept、Accept-Language 建议保持示例格式，不要随意删改
  • 修改后执行 openclaw gateway restart 重启网关生效

详见下方 完整配置实例。

🔗 相关链接 ​

资源地址
OpenClaw 官网https://openclaw.ai

✨ 功能特点 ​

  • ✅ 终端 TUI：命令行交互界面，适合 SSH 环境
  • ✅ Web Dashboard：浏览器可视化管理面板
  • ✅ Telegram Bot：支持通过 Telegram 远程对话
  • ✅ 多模型支持：Claude、GPT、Gemini 等多种模型
  • ✅ Gateway 网关：内置网关服务，支持反向代理
  • ✅ Skill 扩展：可通过 Dashboard 安装扩展技能

🛠️ 安装与初始化 ​

第一步：运行安装脚本 ​

登录服务器 SSH 或在 macOS 终端中运行以下命令：

bash
curl -fsSL https://openclaw.ai/install.sh | bash

耐心等待安装流程结束。

第二步：初始化配置 ​

安装过程中会依次出现以下选项，按照说明操作：

步骤选择说明
启动方式QuickStart快速开始模式
供应商设置Skip for now先跳过，后续手动编辑配置文件
适配器选择anthropic选择 Anthropic 适配器
模型选择opus-4.5或选择你需要的模型
社交适配器按需选择如 Telegram（可选）
Skill 安装跳过后续可通过 Dashboard 安装
Hook 选择全选使用空格键全选后回车确认
Shell 补全yes安装命令行自动补全

⚙️ 渠道与模型配置 ​

第一步：编辑配置文件 ​

打开 OpenClaw 的配置文件进行编辑：

bash
vim ~/.openclaw/openclaw.json

参照下方 完整配置实例 填入你的供应商和模型信息。

第二步：填入 API Key ​

在 models.providers 中配置供应商信息，将 apiKey 替换为你在 callxyq 控制台 创建的 API Key。若使用 Claude Opus 4.6 这类 anthropic-messages 配置，保持 authHeader: true 即可，无需再手动写 Authorization。

💡 提示：请确保在 callxyq.xyz 创建令牌时，额度设置正确。带 plan 后缀的是身份组，请勿直接调用。

第三步：重启网关 ​

bash
openclaw gateway restart

第四步：验证配置 ​

运行以下命令进入 TUI 界面测试模型是否正常：

bash
openclaw tui

测试成功后输入 /quit 退出 TUI。

🌐 浏览器访问 Dashboard ​

获取 Dashboard URL ​

在控制台运行命令获取 Dashboard URL，在浏览器中访问即可进入管理面板。

⚠️ 服务器用户注意

如果你在远程服务器运行 OpenClaw，需要：

1. 配置反向代理

使用 Nginx 或其他反向代理工具反代 OpenClaw 服务，并设置 SSL 证书。

2. 修改配置文件

编辑 ~/.openclaw/openclaw.json，在 gateway 字段下添加：

json
{
  "controlUi": {
    "allowInsecureAuth": true
  }
}

3. 重启网关

bash
openclaw gateway restart

访问带有 Token 的 Dashboard URL 即可进入后台界面。

🤖 配置 Telegram Bot（可选） ​

如果安装时选择了 Telegram 适配器，可以通过以下步骤配置 Bot 访问权限：

第一步：与 Bot 对话 ​

在 Telegram 中找到你通过 @BotFather 创建的机器人，发起对话。

第二步：获取 Pairing Code ​

首次对话后会收到一个 Pairing Code。

第三步：授权配对 ​

在控制台运行以下命令完成授权：

bash
openclaw pairing approve telegram 你的Pairing_Code

配对成功后，即可通过 Telegram Bot 与 OpenClaw 进行远程对话。

📄 完整配置实例 ​

以下是一份接入 callxyq 渠道的 openclaw.json 完整配置参考（路径：~/.openclaw/openclaw.json），同时包含 Claude、Codex 与 GPT 的配置示例：

💡 说明

配置中的 sk-xxxx、你的-gateway-token、你的-telegram-bot-token 都是占位符，请替换为你自己的密钥，不要把真实密钥直接写进文档或公开截图中。

json
{
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-callxyq-xyz/claude-opus-4-6"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "compaction": {
        "mode": "safeguard"
      },
      "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace"
    }
  },
  "models": {
    "providers": {
      "custom-callxyq-xyz": {
        "baseUrl": "https://callxyq.xyz/v1",
        "apiKey": "sk-你的密钥",
        "api": "anthropic-messages",
        "headers": {
          "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
          "Accept": "application/json",
          "Accept-Language": "en-US,en;q=0.9"
        },
        "authHeader": true,
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6 (Custom)",
            "reasoning": false,
            "input": [
              "text",
              "image"
            ],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          }
        ]
      },
      "callxyq-codex": {
        "baseUrl": "https://callxyq.xyz/v1",
        "apiKey": "sk-你的密钥",
        "api": "openai-completions",
        "headers": {
          "User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal",
          "Authorization": "Bearer sk-你的密钥"
        },
        "models": [
          {
            "id": "gpt-5.4",
            "name": "GPT 5.4 (Codex)",
            "contextWindow": 200000,
            "maxTokens": 32000,
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          }
        ]
      },
      "callxyq-gpt": {
        "baseUrl": "https://callxyq.xyz/v1",
        "apiKey": "sk-你的密钥",
        "api": "openai-responses",
        "headers": {
          "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36",
          "Accept": "application/json"
        },
        "models": [
          {
            "id": "gpt-5.4",
            "name": "gpt-5.4 (Custom Provider)",
            "reasoning": false,
            "input": [
              "text"
            ],
            "contextWindow": 272000,
            "maxTokens": 32000,
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          }
        ]
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "你的-gateway-token"
    },
    "port": 18789,
    "bind": "loopback",
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "auth": {
    "profiles": {}
  },
  "plugins": {
    "entries": {
      "telegram": {
        "enabled": true
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的-telegram-bot-token"
    }
  },
  "logging": {
    "level": "trace",
    "consoleLevel": "debug",
    "consoleStyle": "pretty"
  },
  "commands": {
    "restart": true
  },
  "skills": {
    "install": {
      "nodeManager": "npm"
    }
  }
}

关键字段说明 ​

字段说明
agents.defaults.model.primary默认使用的模型，格式为 供应商名/模型ID
agents.defaults.maxConcurrent主代理最大并发数
agents.defaults.subagents.maxConcurrent子代理最大并发数
agents.defaults.compaction.mode上下文压缩模式，safeguard 为安全模式
agents.defaults.workspace工作区目录路径，按你的系统修改
models.providers模型供应商配置，可配置多个供应商
models.providers.*.baseUrlAPI 基础地址，callxyq 统一为 https://callxyq.xyz/v1
models.providers.*.apiKey对应分组的 API Key
models.providers.*.api接口协议，Claude Opus 4.6 示例使用 anthropic-messages，Codex 示例使用 openai-completions，GPT 示例使用 openai-responses
models.providers.*.headers请求头；Claude Opus 4.6 示例建议保留 User-Agent、Accept、Accept-Language，Codex 需包含 User-Agent 和 Authorization，GPT 示例需保留 User-Agent 与 Accept
models.providers.*.authHeader仅在 Claude 这类 anthropic-messages 供应商中启用，表示自动使用 apiKey 作为认证头
gateway.port网关监听端口，默认 18789
gateway.bind绑定模式，loopback 仅本机访问
channels.telegram.botTokenTelegram Bot Token，通过 @BotFather 获取
logging.level日志级别，排查问题时可设为 trace

🧠 设置 GPT 推理强度（推荐） ​

如果你把 OpenClaw 的默认模型切到 GPT 5.x / Codex 系列，建议顺手把推理强度调高。

默认推理强度通常偏低，建议改为 high 或 xhigh。做法是在 agents.defaults 节点下，和 maxConcurrent 同级增加一行 "thinkingDefault": "xhigh"。

示例：

json
{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "thinkingDefault": "xhigh",
      "model": {
        "primary": "callxyq-gpt/gpt-5.4"
      }
    }
  }
}

修改保存后，执行以下命令重启网关或主进程即可生效：

bash
openclaw gateway restart

⚠️ 注意事项

  • Claude Opus 4.6 配置建议开启 authHeader: true：这样无需手动维护 Authorization
  • User-Agent 建议保持示例中的格式，确保请求正常识别
  • GPT 渠道建议使用 openai-responses：如果使用 GPT 提供商配置，按上面的示例保留 Accept: application/json
  • workspace 路径：Windows 用户使用 \\ 双反斜杠，Linux/macOS 用户使用 / 正斜杠（如 /root/.openclaw/workspace）
  • cost 全部设为 0：通过 callxyq 中转使用时无需在本地计费

常见问题 ​

安装脚本执行失败？ ​

  • 确认网络连接正常，能访问 openclaw.ai
  • 确认系统已安装 curl 和 bash
  • 如果在国内服务器，可能需要配置代理

遇到 403 Your request was blocked 怎么办？ ​

如果请求返回 403 Your request was blocked，通常说明 Claude 供应商配置里的请求头不完整。对于 Opus 4.6 这类 anthropic-messages 配置，建议至少保留下面这些字段：

json
{
  "authHeader": true,
  "headers": {
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
    "Accept": "application/json",
    "Accept-Language": "en-US,en;q=0.9"
  }
}

🚨 重要

  • authHeader: true 需要开启，否则可能无法自动携带认证信息
  • User-Agent、Accept、Accept-Language 尽量保持示例格式，否则请求可能被拦截
  • 配置完成后执行 openclaw gateway restart 重启网关

Gateway 重启后模型仍不可用？ ​

  • 检查 API Key 是否正确填入
  • 确认 Key 对应的分组支持你选择的模型
  • 查看 OpenClaw 日志排查具体错误

更多问题 ​

登录 callxyq.xyz，创建 API 密钥后重试；如仍有问题，请查看 FAQ 或联系售后支持。

和谐、友善、互助、开心

Copyright © 2025 callxyq