OpenClaw 配置指南 工具

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

📋 简介

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

⚠️ 适用环境

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

• OpenClaw 官网：https://openclaw.ai

功能特点

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

安装与初始化

STEP 1 运行安装脚本

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

STEP 2 初始化配置

安装过程中会依次出现以下选项：

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

渠道与模型配置

STEP 1 编辑配置文件

vim ~/.openclaw/openclaw.json

STEP 2 填入 API Key

在配置文件中，将 apiKey 和 headers.Authorization 替换为你在 CC Code 控制台创建的 API Key。

🚨 遇到 403 Your request was blocked？

使用 CC Code 渠道时，必须在供应商配置中添加 headers 字段，否则请求会被拦截返回 403：

"headers": {
  "User-Agent": "claude-cli/2.0.76 (external, cli)",
  "Authorization": "Bearer sk-xxxx"
}

• Authorization 的值必须与 apiKey 一致，格式为 Bearer sk-你的密钥
• User-Agent 必须保持示例中的格式，不可省略或随意修改

STEP 3 重启网关

openclaw gateway restart

DONE ✓ 验证配置

openclaw tui

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

完整配置示例

以下是一份接入 CC Code 渠道的 openclaw.json 配置参考（路径：~/.openclaw/openclaw.json）：

{
  "models": {
    "providers": {
      "cc-code": {
        "apiKey": "sk-您的CC Code密钥",
        "baseUrl": "https://ai.cccode.org",
        "headers": {
          "User-Agent": "claude-cli/2.0.76 (external, cli)",
          "Authorization": "Bearer sk-您的CC Code密钥"
        }
      }
    }
  }
}

💡 支持的分组

OpenClaw 使用「逆向分组」的 API Key。请在创建专属 Key 时选择逆向分组。

浏览器访问 Dashboard

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

⚠️ 服务器用户注意

如果你在远程服务器运行 OpenClaw，需要使用 Nginx 或其他反向代理工具反代服务，并设置 SSL 证书。

配置 Telegram Bot（可选）

1. 在 Telegram 中找到你通过 @BotFather 创建的机器人，发起对话
2. 首次对话后会收到一个 Pairing Code
3. 在控制台运行以下命令完成授权：

openclaw pairing approve telegram 你的Pairing_Code