安装 OpenClaw#

OpenClaw 是一个开源的自托管 AI 助手代理，通过 Gateway 架构连接 WhatsApp、Telegram、Slack、Discord 等消息平台，支持 Anthropic、OpenAI、Google 等多种模型。本教程将带你从零开始安装 OpenClaw 并配置 Du's API。

前置要求#

• Node.js 24（推荐）或 Node.js 22.16+（如果还没安装，请先查看 安装 Node.js）

验证 Node.js 是否已安装：

node --version

如果看到 v22.16.x 或更高版本号，即可继续。

安装步骤#

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

npm install -g openclaw@latest

sudo npm install -g openclaw@latest

pnpm add -g openclaw@latest
pnpm approve-builds -g

openclaw onboard --install-daemon

验证安装#

安装完成后，运行以下命令验证：

# 查看版本
openclaw --version

# 诊断配置问题
openclaw doctor

# 检查 Gateway 状态
openclaw gateway status

openclaw doctor 会检查 Node.js 版本、依赖、配置文件、网络连接等是否正常。

配置 Du's API#

安装完成后，需要配置 Du's API 作为模型提供商。OpenClaw 支持配置文件和环境变量两种方式。

方式一：配置文件（推荐长期使用）#

OpenClaw 的配置涉及两个层级：

• 全局配置：~/.openclaw/openclaw.json — 定义提供商和默认模型
• Agent 级别配置：~/.openclaw/agents/<agentId>/agent/models.json — Agent 级别的模型覆盖

API Key 推荐通过环境变量存储，在配置文件中使用 ${ENV_VAR} 语法引用，避免明文存储。

编辑 ~/.openclaw/openclaw.json，添加 Du's API 作为自定义提供商：

{
  models: {
    providers: {
      "dusapi-openai": {
        baseUrl: "https://api.dusapi.com/v1",
        apiKey: "${DUSAPI_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.4",
            name: "GPT-5.4",
            reasoning: true,
            input: ["text"],
            contextWindow: 1000000,
            maxTokens: 32000
          }
        ]
      }
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "dusapi-openai/gpt-5.4"
      },
      models: {
        "dusapi-openai/gpt-5.4": { alias: "GPT-5.4" }
      }
    }
  }
}

方式二：环境变量配置（快速上手）#

对于内置的 OpenAI 和 Anthropic 提供商，可以直接通过环境变量配置：

export OPENAI_BASE_URL="https://api.dusapi.com/v1"
export OPENAI_API_KEY="your-api-key-here"

export ANTHROPIC_BASE_URL="https://api.dusapi.com"
export ANTHROPIC_API_KEY="your-api-key-here"

nano ~/.zshrc
# 在文件末尾添加以上 export 命令，保存退出后执行：
source ~/.zshrc

验证配置#

# 诊断配置
openclaw doctor

# 查看已配置的模型
openclaw models list

# 测试 AI 响应
openclaw agent --message "Hello, can you hear me?"

如果看到 AI 回复输出，说明配置成功。

更新 OpenClaw#

# 更新到最新稳定版
npm update -g openclaw

# 或切换到指定频道
openclaw update --channel stable  # stable | beta | dev

卸载 OpenClaw#

npm uninstall -g openclaw

常见问题#

安装时报错 EACCES: permission denied#

方式一：使用 sudo

sudo npm install -g openclaw@latest

方式二：修改 npm 全局路径（推荐）

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g openclaw@latest

安装后提示「command not found: openclaw」#

1. npm 全局安装路径不在 PATH 中 — 运行 npm config get prefix，确保输出路径下的 bin 目录在你的 PATH 中
2. 需要重新打开终端 — 关闭当前终端窗口，重新打开一个试试

安装速度太慢#

npm install -g openclaw@latest --registry=https://registry.npmmirror.com

Gateway 启动失败#

# 检查 Gateway 状态
openclaw gateway status

# 运行诊断
openclaw doctor

确认端口 18789 没有被其他程序占用。

下一步#

• 查看 OpenClaw 配置指南 了解更多高级配置
• 查看模型列表了解所有可用模型