OpenClaw（原名 Clawdbot/Moltbot）是一款开源的 AI 智能体（Agent）网关，它最大的特点是“能动手干活”。与传统的聊天机器人不同，OpenClaw 可以直接在你的设备上执行命令、操作文件、管理浏览器，甚至帮你自动完成复杂的流程化任务。

本教程将手把手教你如何从零开始安装 OpenClaw，并重点配置阿里云百炼（通义千问）或DeepSeek等国内大模型，解决网络访问和 API 调用难题。

环境准备

系统要求

  • 操作系统：Linux (Ubuntu 20.04+ / Debian 11+ / CentOS 7+)、macOS Monterey (12.0)+、Windows 10/11 (需 WSL2)。
  • Node.js：版本必须 ≥ 22.x。这是硬性要求，低版本无法运行。
  • 硬件：建议 2GB 以上内存，5GB 以上存储空间。

安装 Node.js 版本大于 22 (Linux 示例)

如果你的系统没有 Node.js 22，请先执行以下命令安装：

# Ubuntu/Debian 系统
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# CentOS/RHEL 系统
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs
# 验证安装
node --version  # 应显示 v22.x.x
npm --version   # 应显示 10.x.x

安装 OpenClaw

方法一：官方一键安装（推荐）

这是最快捷的方式，脚本会自动处理所有依赖。

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

方法二：国内镜像安装（解决网络问题）

如果官方源下载慢或失败，可以使用国内社区维护的镜像版本（openclaw-cn），该版本已内置中文界面和国内镜像源。

# 安装社区版
npm install -g openclaw-cn@latest
# 或者使用 pnpm
pnpm add -g openclaw-cn@latest

配置向导（Onboarding）

安装完成后，运行以下命令进入交互式配置向导：

openclaw onboard --install-daemon

注意：如果你使用的是社区版，命令为 openclaw-cn onboard --install-daemon。

配置过程中，请按以下关键步骤操作：

  1. 风险确认：看到 I understand this is powerful and inherently risky. Continue? 时，输入 Yes 确认。
  2. 引导模式：选择 QuickStart（快速开始）。
  3. 模型提供商（核心步骤）：
    • 在 Model/auth provider 列表中，选择 DeepSeek 或 Anthropic（用于配置阿里云百炼，见下文详解）。
    • 注意：不要选择 OpenAI 或 Google，除非你有海外代理。
  4. 通道选择：初次使用建议选择 Skip for now，后续再配置 Telegram 或飞书。
  5. 技能配置：同样选择 Skip for now，后续在 Web 界面添加更直观。

配置完成后，OpenClaw 会自动启动守护进程，并提示你访问 Web 控制台（通常为 http://localhost:18789）。

配置国内大模型（重点）

OpenClaw 本身不提供 AI 能力，需要接入大模型作为“大脑”。以下是两种主流的国内模型配置方法。

方案 A：配置阿里云百炼（通义千问）

阿里云百炼提供了与 OpenAI API 兼容的接口，非常适合 OpenClaw。

1. 获取 API Key

  • 访问 https://bailian.console.aliyun.com/。
  • 完成实名认证（新用户有免费额度）。
  • 进入“密钥管理”，点击“创建 API Key”，记录下生成的 Access Key ID 和 Access Key Secret。

2. 配置 OpenClaw

打开终端，执行以下命令（将 your_id 和 your_secret 替换为你的实际密钥）：

# 设置百炼 API 密钥
openclaw config set models.providers.bailian.accessKeyId "your_id"
openclaw config set models.providers.bailian.accessKeySecret "your_secret"
# 设置默认模型为通义千问（推荐使用 Turbo 或 Plus 版本）
openclaw config set agents.defaults.model.primary "bailian/qwen3-turbo-2026-01-23"
# 重启服务使配置生效
systemctl --user restart openclaw-gateway

方案 B：配置 DeepSeek

DeepSeek 提供免费的 API 额度，对个人开发者非常友好。

  1. 访问 https://platform.deepseek.com/api_keys 获取 API Key。
  2. 在 OpenClaw 配置向导中，选择 DeepSeek 作为提供商，并填入 API Key。
  3. 或者在配置文件中设置默认模型为 deepseek/deepseek-reasoner。

访问与使用

  1. 打开控制台：在浏览器中访问 http://localhost:18789（如果安装在服务器上，请将 localhost 替换为服务器 IP）。
  2. 开始对话：在聊天界面中，你可以直接给 OpenClaw 下达指令，例如：
    • “请帮我列出当前目录下所有的 .log 文件。”
    • “请读取 /etc/hosts 文件的内容并总结。”
    • “请用 Python 写一个爬虫脚本，抓取百度首页的标题。”

常见问题（FAQ）

Q1: 安装时卡住或报错 “Network Error”

A：这通常是因为网络连接 GitHub 或 npm registry 不稳定。解决方法：

  • 使用国内镜像源：npm config set registry https://registry.npmmirror.com
  • 或者直接使用社区版 openclaw-cn，它内置了国内源。

Q2: 模型调用失败，提示 “Invalid API Key”

A：请检查你的 API Key 是否填写正确，以及对应的云服务商账户是否有余额或免费额度。阿里云百炼需要完成实名认证才能调用。

Q3: 如何配置 Telegram 或飞书？

A：OpenClaw 支持多种通讯渠道。配置方法如下：

  • Telegram：搜索 @BotFather 创建机器人，获取 Token，然后在 OpenClaw 配置中填入。
  • 飞书：在飞书开放平台创建应用，获取 App ID 和 App Secret，选择 Feishu/Lark 通道进行配置。

通过以上步骤，你应该已经成功搭建了一个属于你自己的、能干活儿的 AI 智能体。现在，尝试让它帮你自动处理那些繁琐的任务吧！