OpenClaw 安装与配置指南

系统要求

• Node.js 版本：≥ 22.0
• 操作系统：Windows 10+、MacOS 12+ 或 Linux(Ubuntu 20.04+、Debian 11+)
• 硬件要求：RAM 最低 2GB（推荐 4GB），磁盘空间至少 500Mb（推荐 1GB 以上）

快速安装 OpenClaw

1. 安装 Node.js（如已安装可跳过）

以 Ubuntu 20.04 为例：

# 添加 Node.js 源
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

2. 安装 OpenClaw

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

3. 验证安装

# 查看版本
openclaw --version

# 环境诊断
openclaw doctor

安装成功后，可通过浏览器访问 http://127.0.0.1:18789 进入 Web UI。

初始化配置

1. 基本配置

• 继续安装：选择 “Yes”
• 引导模式：选择 “QuickStart”

2. 模型配置

• 模型提供商：选择 “Volcano Engine”
• API Key 提供方式：选择 “Paste API key now”
• 输入 API Key：从火山引擎控制台获取
• 默认模型：选择 Coding Plan 支持的模型，如 “volcengine-plan/ark-code-latest”

3. 功能配置

• 选择通道：选择 “Skip for now”
• 配置技能：选择 “No”
• 启用钩子：按空格键选中，按回车键进入下一步
• 启动方式：选择 “Hatch in TUI”

配置工具

1. 自动化助手（推荐）

仅支持 MacOS、Linux 系统：

# 安装 Ark Helper
curl -fsSL https://lf3-static.bytednsdoc.com/obj/eden-cn/ylwslo-yrh/ljhwZthlaukjlkulzlp/install.sh | sh

# 验证安装
ark-helper --version

# 启动配置
ark-helper

按照界面提示完成套餐配置和工具配置。

2. 手动配置

# 打开 Web UI
openclaw dashboard

在左侧菜单栏选择配置 - All Settings - Raw，修改配置信息，将 <ARK_API_KEY> 替换为您自己的 API Key。

开始使用

# 打开 Web UI
openclaw dashboard

或在本地浏览器输入：http://127.0.0.1:18789/

切换模型

1. 全局配置（永久有效）

修改配置文件中的 agents.defaults.model.primary 为目标模型，修改后需要重新启动服务：

{
    "agents": {
        "defaults": {
            "model": {
                "primary": "volcengine-plan/doubao-seed-code"
            }
        }
    }
}

2. 当前会话切换模型（临时有效）

在终端执行 openclaw tui 后，通过 /model 切换模型。

接入飞书机器人

# 安装飞书插件
npx -y @larksuite/openclaw-lark-tools install

按照提示完成机器人创建和配置，在飞书中向机器人发送 /feishu start 验证安装成功。

参考文档

• 安装 OpenClaw | 手把手安装指南
• 飞书 - OpenClaw
• OpenClaw (原 Clawdbot)–火山方舟-火山引擎

---

注意：如果需要完整的教程文档，私信我哟。