OpenClaw 是一个开源的个人 AI 助手平台,支持通过多种消息渠道与 AI 交互。通过配置可接入阿里云百炼的千问系列模型。
OpenClaw 原名 Moltbot/Clawdbot,部分命令可能尚未完成迁移。如果在使用新命令(如 openclaw dashboard)时遇到 command not found: openclaw 的错误,请切换回旧命令(如 clawdbot dashboard 或 moltbot dashboard)来执行操作。
模型支持与选型
OpenClaw 通过 OpenAI 兼容接口支持阿里云百炼的文本生成模型。支持的模型列表如下:
文本生成-千问 | |
文本生成-千问-开源版 | |
文本生成-第三方模型 |
如果您需要频繁使用 OpenClaw 或希望降低使用成本,推荐订阅以下套餐:
Coding Plan:固定月费订阅模式,每月提供最多 90,000 次请求额度,适合高频次编码需求。
配置步骤
1. 开通阿里云百炼
注册账号:若无阿里云账号,需首先注册。
如遇问题,请参见注册阿里云账号。
开通阿里云百炼:使用阿里云主账号前往阿里云百炼大模型服务平台,阅读并同意协议后,将自动开通阿里云百炼,如果未弹出服务协议,则表示您已经开通。
如果开通服务时提示"您尚未进行实名认证",请先进行实名认证。
首次开通百炼后,您可领取新人免费额度(有效期:百炼开通后90天内),用于模型推理服务。免费额度领取方法和详情,请查看新人免费额度页面。
超出额度或期限将产生费用,开启消费限额功能将避免此情况下产生费用,具体费用请以控制台的实际报价和最终账单为准。
2. 安装 OpenClaw
环境要求
OpenClaw 需要 Node.js 22 或更高版本。可通过以下命令检查 Node.js 版本:
node --version如果未安装或版本过低,请访问 Node.js 官网下载安装。
安装方式
macOS / Linux
推荐使用官方安装脚本:
curl -fsSL https://openclaw.ai/install.sh | bash或通过 npm 全局安装:
npm install -g openclaw@latestWindows
在 PowerShell 中执行:
iwr -useb https://openclaw.ai/install.ps1 | iex或通过 npm 全局安装:
npm install -g openclaw@latest完成初始配置向导
首次安装后,OpenClaw 会自动启动配置向导,帮助您快速完成初始设置。您也可以手动执行openclaw onboard命令进行配置。
配置项 | 建议配置 |
I understand this is powerful and inherently risky. Continue? | 选择 Yes |
Onboarding mode | 选择 QuickStart |
Model/auth provider | 选择 Skip for now(稍后配置百炼模型) |
Filter models by provider | 选择 All providers |
Default model | 选择 Keep current |
Select channel (QuickStart) | 选择 Skip for now(稍后配置渠道) |
Configure skills now? (recommended) | 选择 No |
Enable hooks? | 按空格键选中选项,按回车键进入下一步 |
How do you want to hatch your bot? | 选择 Do this later |
接下来,需要为 OpenClaw 配置百炼模型以启用 AI 对话能力。
3. 配置百炼模型
在 OpenClaw 接入阿里云百炼模型服务,需要配置以下参数:
请确保 Base URL 、API Key、模型都归属于同一地域下。
Base URL | 按地域区分:
|
API Key | 百炼访问凭证,用于身份验证和计费,请前往密钥管理(北京)或密钥管理(新加坡)或密钥管理(弗吉尼亚)页面获取。 |
模型 ID | 指定接入的模型,如 不同地域支持的模型有所差异,如美国(弗吉尼亚)地域暂不支持 |
配置参数时需要关闭思考模式("reasoning": false),否则会导致回复内容为空。
OpenClaw 提供了两种配置方式,推荐使用 Web 控制台配置。
方式一:Web 控制台配置
OpenClaw 提供了基于 Web 的编辑器来修改 openclaw.json 配置文件。
启动 Web 控制台
在终端中运行以下命令:
openclaw dashboard浏览器会自动打开 OpenClaw 的控制台页面(通常是
http://127.0.0.1:18789)。如果浏览器没有自动打开,请手动访问该地址。
进入配置页面
在左侧菜单栏中依次选择:,点击菜单下方的Raw。
添加百炼配置
在左侧菜单栏中选择,复制以下配置信息,替换原
"agents": {...},部分,并将DASHSCOPE_API_KEY替换为您的百炼 API Key。请确保 baseUrl 和您的百炼 API Key 归属于同一地域。当前
reasoning参数仅支持设置为false。"models": { "mode": "merge", "providers": { "bailian": { "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1", "apiKey": "DASHSCOPE_API_KEY", "api": "openai-completions", "models": [ { "id": "qwen3-max-2026-01-23", "name": "qwen3-max-thinking", "reasoning": false, "input": [ "text" ], "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 262144, "maxTokens": 65536 } ] } } }, "agents": { "defaults": { "model": { "primary": "bailian/qwen3-max-2026-01-23" }, "models": { "bailian/qwen3-max-2026-01-23": { "alias": "qwen3-max-thinking" } }, "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 } } },保存并应用配置
配置完成后,单击右上角 Save 保存配置,单击 Update。
方式二:编辑配置文件
如果您更习惯直接编辑配置文件,可以按以下步骤操作。配置文件位于 ~/.openclaw/openclaw.json,OpenClaw 启动时会自动读取。
打开配置文件
使用文本编辑器打开配置文件。如果文件不存在,编辑器会自动创建:
# 您也可以使用其他编辑器,如vim。 # vim ~/.openclaw/openclaw.json nano ~/.openclaw/openclaw.json添加百炼配置
复制并粘贴以下配置内容,将
DASHSCOPE_API_KEY替换为百炼 API Key:当前
reasoning参数仅支持设置为false。{ "meta": { "lastTouchedVersion": "2026.2.1", "lastTouchedAt": "2026-02-03T08:20:00.000Z" }, "models": { "mode": "merge", "providers": { "bailian": { "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1", "apiKey": "DASHSCOPE_API_KEY", "api": "openai-completions", "models": [ { "id": "qwen3-max-2026-01-23", "name": "qwen3-max-2026-01-23", "reasoning": false, "input": ["text"], "contextWindow": 262144, "maxTokens": 65536 }, { "id": "qwen3-coder-plus", "name": "qwen3-coder-plus", "reasoning": false, "input": ["text"], "contextWindow": 131072, "maxTokens": 32768 } ] } } }, "agents": { "defaults": { "model": { "primary": "bailian/qwen3-max-2026-01-23" } } }, "gateway": { "mode": "local", "auth": { "mode": "token", "token": "test123" } } }保存配置文件
如果使用 nano 编辑器:
按
Ctrl+X退出编辑器。提示保存时按
Y确认。按
Enter确认文件名。
如果使用 vim 编辑器:
按
Esc确保退出插入模式。输入
:wq并按Enter保存并退出。
验证配置
可以使用以下命令查看配置文件内容,确认配置正确:
cat ~/.openclaw/openclaw.json
4. 开始对话
命令行
请在云服务器或本地终端中执行以下命令,即可通过命令行的方式开始对话。
openclaw tui
Web 界面
请在云服务器或本地终端中执行以下命令,即可通过 Web 界面的方式开始对话。
openclaw dashboard
常见问题
问题 1:提示找不到模型或回复为空
请确认:
模型 ID 拼写正确。
配置中的
provider名称与引用时一致(如配置中是bailian,引用时应为bailian/qwen3-max-2026-01-23)。配置中的
reasoning参数必须设置为false。
问题 2:执行 openclaw 命令时提示 "command not found"
可能是以下原因导致的:
OpenClaw 安装没有成功。请在云服务器或本地终端执行
openclaw --version,若输出版本号证明安装成功。OpenClaw 更名过程中部分命令尚未完全迁移。可以尝试:
使用旧命令
moltbot或clawdbot替代。重新安装最新版本:
npm install -g openclaw@latest。