OpenClaw 配置指南

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

📋 简介

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

⚠️ 适用环境

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

🔗 相关链接

• 官方网站：https://openclaw.ai/

✨ 功能特点

• ✅ 终端 TUI 交互：本地 SSH 直接使用
• ✅ Web Dashboard：浏览器可视化管理
• ✅ Telegram Bot：手机远程操作
• ✅ 多供应商网关：统一对接 Claude / OpenAI / Gemini
• ✅ 请求代理与重试：自动容错

🛠️ 安装与初始化

第一步：运行安装脚本

登录服务器 SSH 或在 macOS 终端中运行：

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

耐心等待安装流程结束。

第二步：初始化配置

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

1. 选择存放目录（默认 ~/.openclaw/）
2. 是否启用 Web Dashboard（推荐启用）
3. 是否启用 Telegram Bot（可选）
4. 填写初始管理员账号 / 密码

⚙️ 渠道与模型配置

第一步：编辑配置文件

nano ~/.openclaw/config.json

第二步：填入 API Key

在 providers 字段下新增本站配置：

{
  "providers": {
    "my-proxy": {
      "type": "anthropic-messages",
      "baseURL": "https://api.nassaapi.xyz",
      "apiKey": "sk-你的Claude分组Key",
      "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 gateway restart

第四步：验证配置

openclaw gateway status

看到 Running 且渠道显示为 Active 即可。

🌐 浏览器访问 Dashboard

获取 Dashboard URL

安装完成后，终端会提示 Dashboard 地址，类似：

Dashboard: http://<server-ip>:8080
Admin: admin
Password: xxxxxxxx

在浏览器打开即可。

🤖 配置 Telegram Bot（可选）

第一步：与 Bot 对话

在 Telegram 中搜索你在初始化时创建的 Bot，发送 /start。

第二步：获取 Pairing Code

在服务器执行：

openclaw telegram pair

会输出一个 6 位配对码。

第三步：授权配对

在 Telegram Bot 中发送配对码，成功后即可远程操作。

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

对 GPT-5 系列模型，可以在配置中加入：

{
  "extra": {
    "model_reasoning_effort": "xhigh"
  }
}

提升复杂任务的推理深度。

常见问题

安装脚本执行失败？

• 检查服务器是否能访问 openclaw.ai
• 检查磁盘空间是否充足（建议 ≥ 2GB）
• 使用国内镜像源可能需要单独处理

遇到 403 Your request was blocked 怎么办？

补齐 headers 中的 User-Agent / Accept 字段（见上方配置示例），然后 openclaw gateway restart 重启。

Gateway 重启后模型仍不可用？

• 检查 config.json 格式是否正确（JSON 语法错误导致解析失败）
• 检查 API Key 是否正确（sk- 开头）
• 查看日志：openclaw logs -f

更多问题

请查阅 疑难杂症 或 常见问题 (FAQ)。