登录/注册
OpenClaw 接入教程
开源工具更新时间：2026-03-10产品简介
OpenClaw（原 Clawdbot / Moltbot）是一款开源的个人 AI 助手平台，支持通过多种消息渠道与 AI 进行交互。通过海鲸AI，您可以快速接入 Claude、Gemini、千问等多种模型，开启智能对话体验：
- 多渠道交互：支持命令行（TUI）、Web 界面、钉钉等多种对话方式
- 丰富的模型选择：兼容 Claude、Gemini、千问、DeepSeek 等主流模型
- OpenAI 兼容接口：通过海鲸AI标准 API 格式对接
- 灵活的成本控制：按需付费，新用户可获得免费额度
重要说明
OpenClaw 原名 Moltbot / Clawdbot，部分命令可能尚未完成迁移。如果在使用新命令（如 openclaw dashboard）时遇到 command not found: openclaw 的错误，请切换回旧命令（如 clawdbot dashboard 或 moltbot dashboard）来执行操作。
支持的模型
OpenClaw 通过海鲸AI的 OpenAI 兼容接口支持多种 AI 模型，具体如下：
| 分类 | 支持的模型 |
|---|---|
| Claude 系列 | Claude Sonnet 4.5、Claude Opus 4.5、Claude Haiku 4 |
| Gemini 系列 | Gemini 2.5 Pro、Gemini 2.5 Flash |
| 千问系列 | 千问 Max、千问 Plus、千问 Flash、千问 Coder、Qwen3 |
| 其他模型 | DeepSeek、Kimi、GLM、MiniMax |
查看完整模型列表及定价，请访问 模型列表。
推荐方案
| 方案 | 说明 |
|---|---|
| 按需付费 | 按实际使用量付费，灵活无绑定 |
前置准备
在开始配置前，请确保：
- 已注册海鲸AI账号（如无账号，请先访问 海鲸AI控制台 注册）
- 已在 API 管理页面生成 API Key
- 确保账户有足够余额或免费额度
安装 OpenClaw
环境要求
OpenClaw 需要 Node.js 22 或更高版本。通过以下命令检查当前版本：
bash
node --version如果未安装或版本过低，请访问 Node.js 官网 下载安装。
安装方式
bash
curl -fsSL https://openclaw.ai/install.sh | bashpowershell
iwr -useb https://openclaw.ai/install.ps1 | iexbash
npm install -g openclaw@latest初始配置向导
首次安装后，OpenClaw 会自动启动配置向导。您也可以手动执行以下命令进入配置：
bash
openclaw onboard按照以下建议完成初始设置：
| 配置项 | 建议选择 |
|---|---|
| I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? | 选择 Yes |
| Onboarding mode | 选择 QuickStart |
| Model/auth provider | 选择 Skip for now（稍后配置海鲸AI模型） |
| Filter models by provider | 选择 All providers |
| Default model | 选择 Keep current |
| Select channel (QuickStart) | 选择 Skip for now（稍后配置渠道） |
| Search provider | 选择 Skip for now（稍后配置） |
| Configure skills now? | 选择 No |
| Enable hooks? | 按空格键选中选项，按回车键进入下一步 |
| How do you want to hatch your bot? | 选择 Do this later |
配置海鲸AI模型
完成初始设置后，需要为 OpenClaw 配置海鲸AI模型以启用 AI 对话能力。
配置参数说明
| 参数 | 说明 |
|---|---|
| Base URL | https://api.atalk-ai.com/v2 |
| API Key | 海鲸AI访问凭证，用于身份验证和计费 |
| 模型 ID | 指定接入的模型，如 claude-sonnet-4-6、qwen3.5-plus |
方式一：Web 控制台配置（推荐）
1. 启动 Web 控制台
bash
openclaw dashboard浏览器会自动打开控制台页面（通常是 http://127.0.0.1:18789）。如果浏览器没有自动打开，请手动访问该地址。
2. 进入配置页面
在左侧菜单栏中依次选择：配置 > RAW（或 Config > RAW）。
3. 添加海鲸AI配置
复制以下配置信息，替换原 "agents": {...} 部分，并将 YOUR_API_KEY 替换为您的海鲸AI API Key：
重要提示
- 将
YOUR_API_KEY替换为您的海鲸AI API Key。 - 以下示例使用
claude-sonnet-4-6和qwen3.5-plus模型，您可以根据需要替换为其他模型。 - 如需使用其他模型，请在
providers.haijing.models中添加模型定义（reasoning参数需设为false），在agents.defaults.models中添加"haijing/模型ID": {}条目。
json
"models": {
"mode": "merge",
"providers": {
"haijing": {
"baseUrl": "https://api.atalk-ai.com/v2",
"apiKey": "YOUR_API_KEY",
"api": "openai-completions",
"models": [
{
"id": "claude-sonnet-4-6",
"name": "claude-sonnet-4-6",
"reasoning": false,
"input": ["text", "image"],
"contextWindow": 200000,
"maxTokens": 65536
},
{
"id": "qwen3.5-plus",
"name": "qwen3.5-plus",
"reasoning": false,
"input": ["text", "image"],
"contextWindow": 1000000,
"maxTokens": 65536
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "haijing/claude-sonnet-4-6"
},
"models": {
"claude-sonnet-4-6": {},
"qwen3.5-plus": {}
}
}
}4. 保存并应用配置
配置完成后，单击右上角 Save 保存配置，然后单击 Update 应用。
方式二：编辑配置文件
您也可以直接编辑 openclaw.json 配置文件，写入上述 JSON 配置内容并保存。
开始对话
Web 界面模式
在终端中执行以下命令，通过 Web 界面开始对话：
bash
openclaw dashboard
命令行模式（TUI）
在终端中执行以下命令，通过命令行界面开始对话：
bash
openclaw tui
切换模型
临时切换（当前会话生效）
在 TUI 界面中输入以下命令即可临时切换模型：
/model qwen3.5-plus界面返回提示 model set to qwen3.5-plus 即表示生效。
永久切换（所有新会话生效）
修改配置文件中的 agents.defaults.model.primary 字段为目标模型：
json
{
"agents": {
"defaults": {
"model": {
"primary": "haijing/claude-sonnet-4-6"
}
}
}
}常见问题
Q1：提示找不到模型或回复为空
请逐项确认以下配置：
- 模型 ID 拼写正确
- 配置中的 provider 名称与引用时一致（例如配置中为
haijing，引用时应为haijing/claude-sonnet-4-6） reasoning参数必须设置为false- 若返回 400 状态码（无响应体），表示账户余额不足，请先
充值后再试
Q2：执行 openclaw 命令时提示 "command not found"
可能原因及解决方案：
| 原因 | 解决方案 |
|---|---|
| 安装未成功 | 执行 openclaw --version 验证，若输出版本号则安装成功 |
| 命令尚未迁移 | 尝试使用旧命令 moltbot 或 clawdbot 替代 |
| 版本过旧 | 重新安装最新版本：npm install -g openclaw@latest |