接入 OpenClaw
OpenClaw 是一个开源的个人 AI 助手，可以接入飞书、微信等常用聊天工具，可以通过 Skill 扩展能力。官网：https://openclaw.ai
安装 OpenClaw
Linux / macOS 用户
在终端执行以下命令安装：
curl -fsSL https://openclaw.ai/install.sh | bashWindows 用户
在 PowerShell 中执行以下命令安装：
iwr -useb https://openclaw.ai/install.ps1 | iex三种配置方式对比
| 方式 | 核心操作 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|---|
| 配置向导 | 运行 openclaw onboard，选择 Custom Provider |
新手入门，快速添加兼容 OpenAI 协议的 API | 交互式引导，无需手动编辑文件 | 只能配置基础选项 |
| 手动编辑配置文件 | 修改 ~/.openclaw/openclaw.json |
配置多个模型，自定义高级参数 | 功能强大，配置灵活 | 需要手动编写 JSON |
| 环境变量代理 | 设置 OPENAI_BASE_URL 等变量 |
全局替换所有 API 请求指向 | 配置简单，生效快 | 灵活性相对较低 |
方法一：使用配置向导
这是最推荐新手的做法，在终端运行：
openclaw onboard然后按照提示操作：
- 遇到提示：
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?请选择 Yes。 - 遇到提示：
Setup mode推荐选择 QuickStart。 - 遇到提示：
Model/auth provider请选择 Custom provider。 - 遇到提示：
Provider ID (Endpoint ID)输入自定义标识符，例如pingtoken。 - 遇到提示：
Base URL输入https://pingtoken.cn/v1（必须以 /v1 结尾）。 - 遇到提示：
Model ID输入deepseek-v4-flash。 - 遇到提示：
API Key填入你的 PingToken API Token。 - 遇到提示：
Compatibility选择openai。 - 后续配置（消息频道、Skill 等）请根据需求配置，新手可以先选择 Skip for now。
方法二：手动编辑配置文件
如果你需要精细控制，可以手动编辑配置文件 ~/.openclaw/openclaw.json：
{
"models": {
"providers": {
"pingtoken": {
"baseUrl": "https://pingtoken.cn/v1",
"apiKey": "${YOUR_API_TOKEN}",
"api": "openai-completions",
"models": [
{
"id": "deepseek-v4-flash",
"name": "DeepSeek V4 Flash",
"contextWindow": 128000,
"maxTokens": 8192,
"reasoning": false,
"input": ["text"]
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "pingtoken/deepseek-v4-flash"
}
}
}
}将 ${YOUR_API_TOKEN} 替换为你的 PingToken API Token。
配置说明：
providers里的键值是供应商唯一标识，引用模型时使用供应商ID/模型ID格式。apiKey建议使用环境变量引用，避免明文写在配置文件里。contextWindow和maxTokens建议按模型实际能力填写。
方法三：通过环境变量代理
这种方式通过设置环境变量，将所有默认指向 OpenAI 的请求重定向到 PingToken。
创建 .env 文件：
OPENAI_API_KEY="YOUR_API_TOKEN"
OPENAI_BASE_URL="https://pingtoken.cn/v1"
OPENAI_MODEL="deepseek-v4-flash"编写启动脚本 start.sh：
#!/bin/bash
export $(grep -v '^#' .env | xargs)
openclaw gateway验证配置是否生效
- 列出所有可用模型：运行
openclaw models list，检查新增的模型是否在列表中。 - 切换默认模型：运行
openclaw models set pingtoken/deepseek-v4-flash。 - 重启网关：运行
openclaw gateway restart使配置生效。
关键提醒
- API 兼容性：OpenClaw 原生支持 OpenAI 和 Anthropic 的 API 格式。对于其他格式的服务，推荐使用 OneAPI 等网关工具转换为 OpenAI 格式后再接入。
- 上下文窗口：在手动配置时，建议根据模型的实际能力准确填写
contextWindow和maxTokens，否则可能影响 OpenClaw 的任务切分和记忆能力。 - 谨慎操作：修改配置文件前最好备份一下，因为 JSON 格式很严格，一个逗号或括号错了都可能导致网关无法启动。
开始使用
打开 Web UI，在 Chat 页面进行交互：
openclaw dashboard在终端中打开 TUI：
openclaw tui在终端中与 OpenClaw 对话：
openclaw terminal