香橙派3B部署OpenClaw(提供完整的教程文档)

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-fsSLhttps://deb.nodesource.com/setup_24.x|sudo-Ebash-# 安装 Node.jssudoapt-getinstall-ynodejs# 验证安装node--versionnpm--version

2. 安装 OpenClaw

curl-fsSLhttps://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 Helpercurl-fsSLhttps://lf3-static.bytednsdoc.com/obj/eden-cn/ylwslo-yrh/ljhwZthlaukjlkulzlp/install.sh|sh# 验证安装ark-helper--version# 启动配置ark-helper

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

2. 手动配置

# 打开 Web UIopenclaw dashboard

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

开始使用

# 打开 Web UIopenclaw 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-toolsinstall

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

参考文档

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

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