十分钟搞定龙虾安装教程(OpenClaw)

qwq 2026年3月10日 1.25k

0 评论

官方资源

• 官网：https://openclaw.ai/
• 中文文档：https://docs.openclaw.ai/zh-CN
• GitHub：https://github.com/openclaw/openclaw

- 技能仓库：https://clawhub.ai/

二.安装方法

系统要求

• 硬件：2GB RAM以上即可运行
• 系统：支持macOS/Windows/Linux

- 依赖：Node.js ≥22

1. 一键安装（推荐）

macOS/Linux

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

Windows

# PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

# CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

2. 手动安装

# npm安装
npm i -g openclaw --registry=https://registry.npmmirror.com
# pnpm安装
pnpm add -g openclaw
# 初始化并安装后台服务
openclaw onboard --install-daemon

3. 源码安装（开发模式）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
# 初始化并安装系统服务
pnpm openclaw onboard --install-daemon
# 开发模式（自动重载）
pnpm gateway:watch

三、初始化配置

安装完成后执行初始化向导：

openclaw onboard --install-daemon

配置流程

1. 风险确认：选择yes同意使用条款
2. 启动模式：选择QuickStart快速启动
3. 模型配置：选择AI供应商（支持Qwen、MiniMax、智谱等国内模型），API密钥配置文件路径：~/.openclaw/agents/<agentId>/agent/auth-profiles.json
4. 通道配置：选择聊天工具，无海外账号选最后一项
5. 端口配置：默认网关端口18789，无需修改
6. 技能选择：按需选择技能，可直接跳过
7. API配置：无相关API密钥选no
8. 钩子开启：开启三个系统钩子用于日志和会话记录

9. 启动UI：选择Open the Web UI自动打开聊天界面

配置完成后访问：http://127.0.0.1:18789/chat 即可开始使用。

四、基础操作

状态检查

# 查看整体状态
openclaw status
# 查看网关服务状态
openclaw gateway status
# 一键健康检查+自动修复
openclaw doctor
# 查看实时日志
openclaw logs --follow

网关管理

# 启动网关
openclaw gateway start
# 停止网关
openclaw gateway stop
# 重启网关（配置修改后必须执行）
openclaw gateway restart
# 前台运行（调试用）
openclaw gateway run --port 18789 --verbose

配置管理

# 查看配置文件路径
openclaw config file
# 读取配置项
openclaw config get <path>
# 修改配置项
openclaw config set <path> <value>
# 校验配置合法性
openclaw config validate

五、技能管理

技能是OpenClaw的功能扩展模块，通过ClawHub市场安装：

# 安装ClawHub工具
npm install -g clawhub
# 登录
clawhub login
# 搜索技能
clawhub search "关键词"
# 安装技能
clawhub install <技能名>
# 批量更新所有技能
clawhub update --all
# 列出已安装技能
openclaw skills list

六、插件管理

插件用于扩展网关核心能力：

# 查看已加载插件
openclaw plugins list
# 安装插件（示例：语音通话插件）
openclaw plugins install @openclaw/voice-call
# 启用插件
openclaw plugins enable <插件ID>
# 重启网关生效
openclaw gateway restart

七、通道配置

支持多聊天平台接入：

# 查看已连接通道
openclaw channels list
# 登录新通道（WhatsApp扫码登录）
openclaw channels login
# 添加通道（示例：Telegram）
openclaw channels add --channel telegram --token <Bot Token>
# 添加Discord通道
openclaw channels add --channel discord --token <Bot Token>
# 通道健康检查
openclaw channels status --probe

八、常用命令速查