OpenClaw 轻松上手
完成 OpenClaw 基础配置，小白也能轻松使用龙虾盒子。
工具准备
- 鼠标和键盘
- HDMI 显示器
-
网络（WiFi和以太网选择任意一个即可）
-
API KEY（OpenClaw需搭配Ai 模型服务商）
OpenClaw 配置
1. 验证 Node.js 环境（必做）,OpenClaw 依赖 Node.js，先确认环境正常，避免后续报错。打开系统终端，输入以下命令并按下键盘回车。
按照图示步骤进行操作，正常结果：终端显示 v22.x.x（x 为任意数字，只要开头是 v22 就没问题）。
2. 启动 OpenClaw 配置（核心步骤），终端输入以下命令，按回车执行命令，终端会进入配置引导界面，全程按提示操作即可，无需手动输入其他内容。
这里选择键盘方向键选择YES并按下键盘回车。
3. 使用键盘方向键，选择QuickStart，按下键盘回车。
Note
选项解释:
QuickStart：快速启动模式，自动生成基础配置，后续想改参数再用 openclaw configure 调整。
Manual：手动配置模式，需要手动填一堆参数，小白容易填错，跳过即可！
4. 选择 OpenClaw 要对接的 AI 模型服务商，不同选项对应不同的 API 配置方式，按下面指引操作即可：这里我们选择DeepSeek 模型服务商（请根据自身喜好和对应API KEY进行选择）。
Note
常见推荐选项（按国内易用性排序）：
Moonshot AI (Kimi K2.5)：国内常用，API 申请简单
Qwen：通义千问，阿里旗下模型
OpenAI：GPT 系列模型（需要境外网络）
Anthropic：Claude 系列模型
5. 确认服务商后，终端会提示你输入对应的 API Key（不同服务商叫法略有不同，本质都是一串密钥）：输入你的 API Key并按回车确认。
Tip
部分服务商还会要求输入模型名称（比如 deepseek-chat），按提示输入即可。
6. 确认默认模型（对应截图步骤）：确认 OpenClaw 要使用的 默认 DeepSeek 模型，小白直接按默认操作即可，无需额外修改。截图中已经自动选中了 Keep current (deepseek/deepseek-chat)，这是最适合日常使用的默认模型，回车键确认即可。
7. 选择 OpenClaw 要对接的 消息聊天渠道，可以按下面两种方式操作：这里我们选择Skip for now。
Tip
方案一：先跳过通道配置（推荐，先完成基础配置）
如果暂时不想配置具体聊天渠道，直接用上下方向键移动到最下方的 Skip for now，按回车键确认即可。
这样会先完成核心配置，后续需要时再用 openclaw configure 重新添加渠道。
方案二：选择常用渠道（以飞书为例）
如果要配置国内常用渠道，推荐选择 Feishu/Lark（飞书），操作步骤：
用上下方向键（↑/↓）移动绿色圆点到 Feishu/Lark（飞书）按回车键确认，按终端提示输入飞书机器人的 App ID、App Secret 等信息。
8. 配置网页搜索（对应截图步骤）：选择 OpenClaw 的联网搜索能力，这里我们选择 DuckDuckGo Search，它是完全免费、无需 API Key 的搜索服务，直接按回车键确认即可。
Tip
方案一：使用默认免费搜索（推荐）
优点：不用额外申请密钥，开箱即用，适合小白快速完成配置。
方案二：跳过搜索配置
如果暂时不需要联网搜索功能，用上下方向键移动到最下方的 Skip for now，按回车键确认即可。
优点：最快完成核心配置，后续需要联网能力时再通过 openclaw configure 补充设置。
9. 配置技能（对应截图步骤）：选择是否配置 OpenClaw 的扩展技能，这里我们选择No。
Note
方案一：先跳过技能配置（推荐，快速完成核心流程）
用方向键选择 No，按回车键确认即可。
优点：跳过复杂的依赖安装，最快完成基础配置，后续需要时再通过 openclaw configure 补充技能。
方案二：配置技能（推荐进阶用户）
保持默认选中 Yes，按回车键确认，终端会自动安装技能所需依赖。
注意：依赖安装时间较长，且部分技能在 Armbian 系统上可能不兼容（Skills status 中 Unsupported on this OS 显示 7 个技能不支持当前系统）。
10. 配置 Hooks（对应截图步骤），选择是否启用 自动化钩子（Hooks）。使用键盘方向键选中，空格选择，键盘回车确认，我们选择 Skip for now直接跳过，最快完成配置：
跳过复杂的自动化配置，不影响核心 AI 对话、搜索功能，后续需要时再通过 openclaw configure 补充设置。
11. 配置完成后，Openclaw 会自动打开浏览器进入对话框（如果您的系统未自动进入对话框或无浏览器，请阅读下文）。
OpenClaw 本地运行
1. 启动OpenClaw 服务。
2. 本地访问OpenClaw，获取带有token的链接，复制到本地浏览器进行访问。
OpenClaw 局域网访问
Note
此处为手动修改配置文件教程，较为繁琐，可使用另一种方式，在本地运行成功后，可以直接与OpenClaw对话，让OpenClaw自行配置为可通过局域网访问。
1. 启动网关生成配置文件。
2. 生成配置文件后停止网关。
3. 输入命令，找到图中位置，修改网关访问权限。
将bind处改为lan，并修改以下配置，修改完成后，按住键盘Ctrl+X，点击键盘Y，Enter保存并退出。
"gateway": {
"port": 18789,
"mode": "local",
"bind": "lan",
"controlUi": {
"allowedOrigins": ["*"],
"dangerouslyDisableDeviceAuth": true
},
3. 重启网关，这个窗口不要关闭。
4. 再新建一个系统终端，获取龙虾盒子IP。
4. 获取带有Token的链接，将127.0.0.1替换为上一步中获取的龙虾盒子ip。复制到其他电脑浏览器或手机浏览器中（龙虾盒子和其他设备必须处于同一局域网中）。
5.将替换完成的链接粘贴至浏览器，OpenClaw启动界面，可以进行对话了。
Note
在同一个局域网中的设备都可通过连接访问龙虾盒子，如何判断处于同一局域网中
龙虾盒子ip为192.168.77.220，其他设备ip为192.168.77.10，可以访问龙虾盒子；其他设备为192.168.1.10，无法访问。
Open Claw 更新
Note
在实际OpenClaw更新操作中，可能存在多种失败情况，请根据自身报错信息查找解决方案。
1. OpenClaw 版本过低情况下，我们可以进行更新。
2. 配置完成后，可能会出现服务重启失败问题，输入以下命令进行修复。
报错信息为配置模式不正确
根据报错信息，输入以下命令
3. 再次启动网关服务并检查服务运行状态。
Tip
Runtime: running (pid 375914, state active, sub running) 表示网关正常运行。
4. 生成带有token的链接。
如需通过局域网访问，请将此链接复制到浏览器中，并将127.0.0.1更改为您的实际IP。
