:lobster: 宝宝都能学会的 CLI Proxy API + OpenClaw 完整部署教程

写个详细的部署教程 全程无脑

:clipboard: 你需要什么

• 云服务器：1~2 台（配置不能低于 2H2G）
• Telegram 账号
• OpenAI 订阅会员 或 Antigravity 账号（有 API Key 更好）

:warning: 注意注意注意

组件 最低配置 推荐配置
CLI Proxy API 1H1G 1H1G
OpenClaw 1H2G 2H4G
一台部署 2H4G 4H6G
重要：配置 CLI Proxy API 的服务器 IP 最好是家宽（未被 OpenAI 封锁）

:desktop_computer: 测试环境

用途 VPS 配置
CLI Proxy API netcup 1o机 1H1G
OpenClaw netcup VPS 500 G12 2H4G

CLI Proxy API 服务器建议使用家宽 IP（为方便我使用已有的普通ip云服务器）

系统：Debian 12

:rocket: 第一部分：CLI Proxy API 部署

1. 系统准备

# 更新系统
apt update && apt upgrade -y

# 安装依赖
apt install -y curl wget git sudo ca-certificates gnupg

2. 安装 Docker

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(. /etc/os-release && echo $VERSION_CODENAME) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
systemctl enable docker && systemctl start docker

3. 创建配置文件

# 创建目录
mkdir -p /root/auth-dir

# 创建配置文件
cat > /root/config.yaml << 'EOF'
port: 8317
management:
  password: "你的面板密码"
remote-management:
  allow-remote: true
  secret-key: "你的面板密码"
auth-dir: "/root/.cli-proxy-api"
api-keys:
  - kpi_你的API密钥
debug: true
usage-statistics-enabled: true
EOF

说明：api-keys 可以随便写，后续可在面板中修改

4. 启动容器

docker run -d \
  --name cliproxy \
  --restart always \
  -p 8317:8317 \
  -v /root/config.yaml:/CLIProxyAPI/config.yaml \
  -v /root/auth-dir:/root/.cli-proxy-api \
  eceasy/cli-proxy-api:latest

5. 访问面板

浏览器打开：http://你的IP:8317/management.html

输入你设置的面板密码即可登录。

 

image

image1879×449 32 KB

 

6. OAuth 登录（以 OpenAI 为例）

  1. 点击 Codex Auth 登录按钮
  2. 打开弹出的链接，登录你的 GPT 账号
  3. 选择个人或团队工作空间
  4. 确认授权，复制页面上的 URL
  5. 粘贴 URL 并提交
  6. 看到 认证成功 提示即可
    image

    image1906×504 37.5 KB
    image

    image1599×811 38.4 KB
    image

    image1885×853 94.3 KB

:warning: IP 被OpenAI封锁的解决方案

测试 IP 是否被 OpenAI 封锁

curl -v https://auth.openai.com
curl -v https://api.openai.com/v1/models

:warning:如果连接失败，说明你中奖了，IP被Openai封:locked:了，换一台或者使用代理。

安装 WARP 代理（可选）

# 添加源
curl -fsSL https://pkg.cloudflareclient.com/pubkey.gpg | gpg --dearmor -o /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ bookworm main" | tee /etc/apt/sources.list.d/cloudflare-client.list

# 安装
apt update && apt install -y cloudflare-warp

# 配置
warp-cli registration new
warp-cli mode proxy
warp-cli connect
# 输入 y 确认

使用 WARP 代理重启容器

# 删除旧容器
docker rm -f cliproxy

# 获取宿主机 IP
HOST_IP=$(ip -4 addr show docker0 | grep -oP '(?<=inet\s)\d+(\.\d+){3}')

## 重新启动带代理的新容器

docker run -d \
  --name cliproxy \
  --restart always \
  -p 8317:8317 \
  -e ALL_PROXY="socks5://${HOST_IP}:40000" \
  -v /root/config.yaml:/CLIProxyAPI/config.yaml \
  -v /root/auth-dir:/root/.cli-proxy-api \
  eceasy/cli-proxy-api:latest

验证添加的代理是否生效 容器和本地都要检查

# 检查宿主机出口 IP
curl --proxy socks5://127.0.0.1:40000 https://api.ipify.org

# 检查容器出口 IP
docker exec cliproxy wget -qO- https://api.ipify.org

代理生效后，重新执行 OAuth 登录即可。

:rocket: 第二部分：OpenClaw 部署

1. 创建 Telegram Bot

    1. 在 Telegram 搜索 @BotFather
    1. 发送 /newbot
    1. 按提示设置 Bot 名称（必须以 bot 结尾，如 kairo929_bot）
    1. 复制获得的 Token（如 8536190245:AAGNfsfpTn…）

2. （不是必须）添加 Swap（如果你的内存 ≤ 2G）

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

3. 安装 Node.js 和 Git

curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs git

4. 安装 OpenClaw

npm install -g openclaw

5. 配置 OpenClaw

# 创建目录
mkdir -p /root/.openclaw/workspace

# 生成 Gateway Token
GATEWAY_TOKEN=$(openssl rand -hex 24)

写入配置文件

替换以下内容：

  1. kpi_你的API密钥 → 你在 CLI Proxy API 设置的密钥
  2. CLIProxyAPI服务器IP:8317 → CLI Proxy API 的地址（记得后面加/v1)
  3. 你的Bot_Token → 从 BotFather 获取的 Token

Codex Quota Openai配置模板

cat > /root/.openclaw/openclaw.json << EOF
{
  "env": {
    "CLIPROXY_API_KEY": "kpi_你的API密钥"
  },
  "models": {
    "mode": "merge",
    "providers": {
"cliproxy": {
        "baseUrl": "http://CLIProxyAPI服务器IP:8317/v1",
        "apiKey": "kpi_你的API密钥",
        "api": "openai-completions",
        "models": [
          {"id": "gpt-5", "name": "GPT-5", "contextWindow": 200000, "maxTokens": 8192},
          {"id": "gpt-5.1", "name": "GPT-5.1", "contextWindow": 200000, "maxTokens": 8192},
          {"id": "gpt-5.2", "name": "GPT-5.2", "contextWindow": 200000, "maxTokens": 8192}
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "cliproxy/gpt-5",
        "fallbacks": ["cliproxy/gpt-5.1"]
      },
      "workspace": "~/.openclaw/workspace"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Bot_Token"
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "token": "${GATEWAY_TOKEN}"
    }
  }
}
EOF

Antigravity Quota 配置模板

cat > /root/.openclaw/openclaw.json << 'EOF'
{
  "env": {
    "CLIPROXY_API_KEY": "kpi_你的API密钥"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cliproxy": {
        "baseUrl": "http://CLIProxyAPI服务器IP:8317/v1",
        "apiKey": "kpi_你的API密钥",
        "api": "openai-completions",
        "models": [
          {"id": "gemini-3-flash-preview", "name": "gemini-3-flash-preview", "contextWindow": 200000, "maxTokens": 8192},
          {"id": "gemini-3-pro-preview", "name": "gemini-3-pro-preview", "contextWindow": 200000, "maxTokens": 8192},
          {"id": "gemini-claude-opus-4-5-thinking", "name": "gemini-claude-opus-4-5-thinking", "reasoning": true, "contextWindow": 200000, "maxTokens": 8192}
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {"primary": "cliproxy/gemini-3-flash-preview", "fallbacks": ["cliproxy/gemini-3-pro-preview"]},
      "workspace": "~/.openclaw/workspace"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Bot_Token"
    }
  },
  "gateway": {
    "mode": "local"
  }
}
EOF

6. 启动 OpenClaw

# 启用 linger
loginctl enable-linger root

# 设置环境变量
export XDG_RUNTIME_DIR=/run/user/$(id -u)
export DBUS_SESSION_BUS_ADDRESS=unix:path=${XDG_RUNTIME_DIR}/bus

# 安装并启动服务
openclaw gateway install
systemctl --user daemon-reload
systemctl --user enable openclaw-gateway
systemctl --user start openclaw-gateway

# 检查状态
sleep 5
systemctl --user status openclaw-gateway

7. 配对 Telegram

  1. 在 Telegram 给你的 Bot 发送任意消息
  2. Bot 会回复一个配对码
  3. 在服务器上执行
    openclaw pairing approve telegram <去除括号填入配对码>

 

image

image604×257 53.8 KB

 

:tada: 完成！

总结

  • 如果你使用一台云服务器部署 最好2H4G以上 1H2G会一直爆内存（别问我怎么知道的）且IP属性较好的 我自用使用的是vircs的4H8G（无推广）
  • 当然你也可以使用比如netcup家的服务器 再配合站内佬友免费提供的家宽IP 对你的CLIProxyAPI服务器进行代理 或者使用我提供的方案 但会降智！（注意因为容器是独立的 所以还要为容器配置代理）
  • 配置文件格式严格按照我提供的模板设置 或者修改
  • 配置完成后 一定要和你的机器人绑定 设置白名单一定要设

好了配置完了可以让BOT跑个定时任务 有任何问题可以直接询问BOT 比如换模型查看可以配置的插件等

游玩过程中注意安全 设置服务器白名单只让OpenClaw访问你的API 里面的数据有泄露风险 一定要注意

 

image

image535×648 30.4 KB