OpenClaw 安装与配置指南
OpenClaw 安装与配置指南
目录
系统要求
基础安装
1. 安装 Node.js 和 npm
2. 安装 OpenClaw
3. 初始化 OpenClaw
~/.openclaw/openclaw.json配置自定义模型
配置文件位置
~/.openclaw/openclaw.json1. 添加自定义模型提供商
openclaw.json，在 models.providers 中添加新的提供商配置：示例 1: OpenAI 兼容 API (如 CrazyRouter)
{
"models": {
"mode": "merge",
"providers": {
"crazyrouter": {
"baseUrl": "https://crazyrouter.com/v1",
"apiKey": "sk-your-api-key-here",
"api": "openai-completions",
"models": [
{
"id": "claude-opus-4-6",
"name": "Claude Opus 4.6",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
}示例 2: Anthropic 兼容 API (如 MiniMax)
{
"models": {
"providers": {
"minimax": {
"baseUrl": "https://api.minimax.io/anthropic",
"api": "anthropic-messages",
"models": [
{
"id": "MiniMax-M2.1",
"name": "MiniMax M2.1",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 15,
"output": 60,
"cacheRead": 2,
"cacheWrite": 10
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
}2. API 类型说明
openai-completions: OpenAI Chat Completions API 格式anthropic-messages: Anthropic Messages API 格式3. 设置默认模型
agents.defaults.model 中设置主模型：{
"agents": {
"defaults": {
"model": {
"primary": "crazyrouter/claude-opus-4-6"
}
}
}
}<provider>/<model-id>4. 配置 API 密钥
方法 1: 直接在配置文件中
{
"models": {
"providers": {
"your-provider": {
"apiKey": "your-api-key-here"
}
}
}
}方法 2: 使用环境变量
方法 3: 使用认证配置
{
"auth": {
"profiles": {
"provider:default": {
"provider": "your-provider",
"mode": "api_key"
}
}
}
}频道配置
1. Telegram 配置
获取 Bot Token
1.
2.
/newbot 创建新机器人3.
4.
配置 Telegram
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "your-bot-token-here",
"dmPolicy": "pairing",
"groupPolicy": "open",
"streamMode": "partial"
}
}
}dmPolicy: 私聊策略 (pairing 需要配对, open 开放)groupPolicy: 群组策略 (open 开放, whitelist 白名单)streamMode: 流式输出模式 (partial 部分流式, full 完整流式)2. Discord 配置
获取 Bot Token
2.
3.
4.
5.
配置 Discord
{
"channels": {
"discord": {
"enabled": true,
"token": "your-discord-bot-token",
"groupPolicy": "open"
}
}
}3. 飞书 (Feishu) 配置
创建飞书应用
安装飞书插件
配置飞书
{
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_your_app_id",
"appSecret": "your_app_secret",
"connectionMode": "websocket",
"dmPolicy": "pairing"
}
},
"plugins": {
"entries": {
"feishu": {
"enabled": true
}
}
}
}启动与管理
1. 启动 Gateway
2. 查看状态
3. 停止服务
4. 升级 OpenClaw
5. WebUI 访问
http://localhost:18789openclaw.json 的 gateway.auth.token 中查看常见问题
1. 422 Unsupported request body 错误
api 字段是否正确 (openai-completions 或 anthropic-messages)2. 端口已被占用
Address already in use3. 插件 ID 重复警告
Duplicate plugin ID: feishu4. 无法连接到 Gateway
disconnected [WS] unauthorized gateway token missing1.
openclaw health2.
3.
4.
127.0.0.1 而不是 localhost5. 模型调用失败
配置文件完整示例
{
"meta": {
"lastTouchedVersion": "2026.2.15",
"lastTouchedAt": "2026-02-18T00:00:00.000Z"
},
"models": {
"mode": "merge",
"providers": {
"openai": {
"baseUrl": "https://api.openai.com/v1",
"apiKey": "sk-your-openai-key",
"api": "openai-completions",
"models": [
{
"id": "gpt-4",
"name": "GPT-4",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 30,
"output": 60,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 4096
}
]
},
"anthropic": {
"baseUrl": "https://api.anthropic.com",
"apiKey": "sk-ant-your-key",
"api": "anthropic-messages",
"models": [
{
"id": "claude-3-5-sonnet-20241022",
"name": "Claude 3.5 Sonnet",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 3,
"output": 15,
"cacheRead": 0.3,
"cacheWrite": 3.75
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-3-5-sonnet-20241022"
},
"workspace": "~/.openclaw/workspace",
"maxConcurrent": 4
}
},
"channels": {
"telegram": {
"enabled": true,
"botToken": "your-telegram-bot-token",
"dmPolicy": "pairing",
"groupPolicy": "open"
}
},
"gateway": {
"port": 18789,
"mode": "local",
"bind": "loopback",
"auth": {
"mode": "token",
"token": "your-generated-token"
}
}
}有用的命令
参考资源
OpenClaw 版本: 2026.2.15
Modified at 2026-02-25 11:55:35