OpenClaw 安装与使用命令大全以及飞书接入实战

公告：“业余草”微信公众号提供免费CSDN下载服务(只下Java资源)，关注业余草微信公众号，添加作者微信：xttblog2，发送下载链接帮助你免费下载！
本博客日IP超过2000，PV 3000 左右，急需赞助商。
极客时间所有课程通过我的二维码购买后返现24元微信红包，请加博主新的微信号：xttblog2，之前的微信号好友位已满，备注：返现
受密码保护的文章请关注“业余草”公众号，回复关键字“0”获得密码
所有面试题(java、前端、数据库、springboot等)一网打尽，请关注文末小程序
视频教程免费领

腾讯云】1核2G5M轻量应用服务器50元首年，高性价比，助您轻松上云

OpenClaw 现在有多火，大家应该都知道吧，朋友圈里随便翻翻，都是在吹嘘 OpenClaw 的。我看了看他们的“喜讯”，无非就是跑起来，接入了飞书而已。

不过如此嘛，那我今天就来总结一份《OpenClaw 安装与使用命令大全以及飞书接入实战》分享给需要的网友吧！

这是一份基于互联网上公开资料整理的 OpenClaw 完整命令指南，涵盖了从环境准备、安装、配置到日常使用的所有命令。

总的来说，本文主要涉及：openclaw-简介、系统要求、环境准备、安装方法、初始化配置、模型配置、服务管理、渠道配置、插件管理、浏览器扩展、高级功能、wsl-环境配置 windows、飞书接入完整流程、常用命令速查表、故障排查、参考资源等。

OpenClaw 简介

OpenClaw（原 Clawdbot/Moltbot）是一个开源的 AI 网关、代理框架，支持多模型、工具调用、多会话、记忆功能。它可以在本地部署，让你拥有一个24小时待命的AI助手，自动操作文件、浏览器、控制智能家居等。

核心特性：

全操作系统支持（Windows、macOS、Linux）
全平台兼容（WhatsApp、Telegram、飞书、Discord等）
支持本地大模型和云端API
插件化架构，可扩展性强

系统要求

基础要求

Node.js：版本 ≥ 22
Git：最新版本
npm：随 Node.js 安装

可选要求

Docker（可选，用于容器化部署）
Ollama（可选，用于本地大模型）

环境准备

安装 Node.js（所有平台）

# 检查当前 Node.js 版本
node -v

# 如果版本低于 22，请从官网下载安装
# 官网：https://nodejs.org/

# 安装完成后验证
node -v  # 应显示 v22.x.x 或更高
npm -v   # 应显示对应版本

安装 Git（所有平台）

# 检查 Git 是否已安装
git --version

# 如果未安装，请从官网下载
# 官网：https://git-scm.com/

# 验证安装
git --version  # 应显示版本号

WSL 环境准备（Windows 10/11）

# 以管理员身份打开 PowerShell
# 安装 WSL
wsl --install

# 查看安装状态
wsl --status
wsl --version

# 进入 WSL 后更新系统
sudo apt update
sudo apt upgrade -y

# 安装基础工具
sudo apt install -y curl wget git

WSL 网络配置（推荐）

在 Windows 用户目录创建 .wslconfig 文件（C:\Users\<你的用户名>\.wslconfig）：

[wsl2]
# 启用镜像网络模式 - 这是最重要的配置
networkingMode=mirrored
# 启用 DNS 隧道，防止 VPN 环境下域名解析失效
dnsTunneling=true
# 强制 WSL 使用 Windows 的 HTTP 代理设置
autoProxy=true
# 启用集成防火墙支持
firewall=true
# [experimental]
# 自动回收闲置内存，优化性能
autoMemoryReclaim=gradual
# 支持主机回环地址访问
hostAddressLoopback=true

应用配置：

wsl --shutdown
# 等待 8 秒后重新启动 Ubuntu

验证配置：

# 查看网络接口
ip addr show

# 查看路由表
ip route show

# 测试与局域网连通性
ping 192.168.1.1

安装方法

方法一：npm 全局安装（推荐）

# 安装最新版本
npm install -g openclaw@latest

# 或使用 pnpm
pnpm add -g openclaw@latest

# 验证安装
openclaw --version
which openclaw

方法二：官方一键安装脚本

# 使用官方脚本安装
curl -fsSL https://molt.bot/install.sh | bash

# 或使用国内镜像（如果访问慢）
curl -fsSL https://openclaw.ai/install.sh | bash

方法三：Homebrew 安装（macOS）

# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 OpenClaw
brew install openclaw-cli

# 或安装 Node.js 后再用 npm
brew install node
npm install -g openclaw@latest

初始化配置

运行新手引导向导

# 基础引导（推荐新手使用）
openclaw onboard

# 引导并安装系统服务（开机自启）
openclaw onboard --install-daemon

# 开发模式（隔离状态到 ~/.openclaw-dev）
openclaw onboard --dev

引导过程选项说明：

风险提示：选择 “Yes” 继续
模型选择：可以选择常用模型并输入 API Key，或选择 “Skip for now” 稍后配置
通讯工具配置：可跳过，后续按需求配置
Skills 配置：可跳过，后续按需设置
Enter hooks：用空格键选择需要的选项
交互界面：可选择 Hatch in TUI（终端界面）

安装后验证

# 检查版本
openclaw --version

# 查看安装位置
which openclaw

# 检查进程
ps aux | grep openclaw

# 查看网关状态
openclaw gateway status

模型配置

配置文件位置

Windows: C:\Users\<Your_Username>\.openclaw\openclaw.json
macOS/Linux: ~/.openclaw/openclaw.json

下面是一些配置文件结构示例。

阿里云百炼平台（通义千问）配置

{
  "models": {
    "mode": "merge",
    "providers": {
      "qwen-bailian": {
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-your-api-key-here",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-coder-plus",
            "name": "qwen3-coder-plus",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0.004,
              "output": 0.0008,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "qwen3-max",
            "name": "qwen3-max",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0.008,
              "output": 0.008,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwen-bailian/qwen3-coder-plus",
        "fallbacks": ["qwen-bailian/qwen3-max"]
      },
      "workspace": "/home/username/.openclaw/workspace"
    }
  }
}

MiniMax 配置示例

{
  "models": {
    "mode": "merge",
    "providers": {
      "minimax-cn": {
        "baseUrl": "https://api.minimaxi.com/anthropic",
        "apiKey": "Your API Key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1 (China)",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 204800,
            "maxTokens": 131072
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "minimax-cn/MiniMax-M2.1"
      },
      "models": {
        "minimax-cn/MiniMax-M2.1": {}
      },
      "workspace": "/home/username/.openclaw/workspace"
    }
  }
}

通用配置示例

{
  "llm": {
    "provider": "openai",
    "model": "Claude-HaiKu-4.5",
    "base_url": "https://api.vsvip.cn/v1",
    "api_key": "sk-xxxxxxxxxxxxxxxxxxxx",
    "temperature": 0.1
  },
  "agent": {
    "name": "超级架构师",
    "role": "资深全栈工程师，擅长 Python 和 Node.js"
  },
  "feishu": {
    "app_id": "cli_xxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxx"
  }
}

配置命令

# 备份配置文件
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

# 检查 Node.js 版本
node --version
# 要求：Node.js ≥ 22

# 重启 Gateway 使配置生效
openclaw gateway restart

# 验证模型列表
openclaw models list

# 查看模型状态
openclaw models status

# 测试模型响应
openclaw agent --message "你好！" --session-id main

服务管理

Gateway 网关管理

# 启动网关（指定端口）
openclaw gateway --port 18789

# 重启网关
openclaw gateway restart

# 停止网关
openclaw gateway stop

# 查看网关状态
openclaw gateway status

# 查看服务状态
openclaw status

# 启动 Bot 服务
openclaw start

# 停止 Bot 服务
openclaw stop

# 重启 Bot 服务
openclaw restart

Dashboard 访问

# 打开 Web 界面
openclaw dashboard

# 访问地址（自动打开）
http://127.0.0.1:18789/

# 带 token 的访问地址（用于外部访问）
openclaw dashboard --token

TUI 终端界面

# 启动 TUI 界面
openclaw tui

# 或通过 SSH 连接（远程服务器）
ssh root@公网IP
openclaw tui

渠道配置

通用渠道管理

# 添加渠道
openclaw channels add

# 渠道登录/配对
openclaw channels login

# 查看渠道列表
openclaw channels list

# 删除渠道
openclaw channels remove <channel-name>

WhatsApp 配置示例

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  },
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  }
}

插件管理

插件操作命令

# 查看已安装插件
openclaw plugins list

# 安装插件
openclaw plugins install @m1heng-clawd/feishu

# 更新插件
openclaw plugins update <plugin-name>

# 卸载插件
openclaw plugins uninstall <plugin-name>

# 进入插件目录安装依赖
cd /root/.openclaw/extensions/feishu/
npm install --verbose

常用插件

# 飞书插件
openclaw plugins install @m1heng-clawd/feishu

# 浏览器控制插件
openclaw plugins install @openclaw/browser-control

# 文件系统插件
openclaw plugins install @openclaw/filesystem

浏览器扩展

安装浏览器扩展

# 创建浏览器扩展
openclaw browser extension install

# 扩展文件位置
# WSL: \\wsl.localhost\Ubuntu\home\user\.openclaw\browser\chrome-extension
# 复制到 Windows 系统文件夹下

Chrome 浏览器配置

1. 启动 Chrome 浏览器
2. 访问 chrome://extensions/
3. 打开"开发者模式"
4. 点击"加载已解压的扩展程序"
5. 选择 chrome-extension 文件夹
6. 浏览器地址栏旁边会出现 OpenClaw 图标
7. 点击图标显示"ON"状态，即可控制浏览器

高级功能

开发模式

# 使用开发配置（隔离状态到 ~/.openclaw-dev）
openclaw --dev

# 开发模式默认端口偏移（gateway port 为19001）
openclaw gateway --dev

日志和调试

# 查看帮助信息
openclaw --help

# 禁用颜色输出
openclaw --no-color

# 查看详细日志
openclaw gateway --verbose

# 使用命名 profile
openclaw --profile <name>

版本管理

# 查看当前版本
openclaw --version
openclaw -v

# 查看远程最新版本
npm view openclaw version

# 升级到最新版本
npm i -g openclaw@latest

# 升级到指定版本
npm i -g openclaw@2026.2.21

WSL 环境配置（Windows）

完整 WSL 部署流程

# 1. 管理员身份打开 PowerShell
# 2. 安装 WSL
wsl --install

# 3. 查看安装状态
wsl --status
wsl --version

# 4. 进入 Ubuntu
wsl

# 5. 更新系统
sudo apt update
sudo apt upgrade -y

# 6. 安装基础工具
sudo apt install -y curl wget git

# 7. 配置免密 sudo（可选）
sudo visudo
# 在文件末尾添加：username ALL=(ALL) NOPASSWD: ALL

# 8. 安装 OpenClaw
curl -fsSL https://molt.bot/install.sh | bash

# 9. 运行初始化向导
openclaw onboard --install-daemon

# 10. 验证安装
which openclaw
openclaw --version

# 11. 配置防火墙（Windows）
New-NetFirewallRule -DisplayName "OpenClaw-Service" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 18789

NAT 模式端口转发（备用方案）

# 获取 WSL IP
$wslIp = wsl hostname -I

# 删除旧规则
netsh interface portproxy delete v4tov4 listenport=18789 listenaddress=0.0.0.0

# 添加端口转发
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=$wslIp

# 注意：NAT模式下，每次重启 WSL 后 IP 可能变化，需要重新配置

飞书接入完整流程

安装飞书插件

# 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu

# 进入插件目录安装依赖
cd /root/.openclaw/extensions/feishu/
npm install --verbose

# 重启网关
openclaw gateway restart

飞书开放平台配置

1. 访问 https://open.feishu.cn/ 注册账号
2. 进入"开发者后台"
3. 选择"企业自建应用"
4. 输入应用名称和描述，创建应用
5. 选择"添加应用能力" → "添加机器人"
6. 选择"权限管理" → "开通权限"
7. 搜索关键词"message"，勾选相关权限并确认开通

获取凭证

1. 在飞书后台选择"凭证与基础信息"
2. 复制 App ID 和 App Secret
3. 保存备用

OpenClaw 配置飞书

# 添加飞书渠道
openclaw channels add

# 根据提示输入：
# - App ID: 粘贴飞书凭证
# - App Secret: 粘贴飞书凭证
# - Connection Mode: 选择 "websocket"
# - Domain: 填 "feishu"
# - Dm Policy: 选 "open"
# - Group Policy: 选 "open"

飞书事件配置

1. 回到飞书开发者后台
2. 选择"事件与回调"
3. 事件配置选择"长连接"
4. 点击"添加事件"
5. 搜索"im.message.receive_v1"
6. 勾选"接收消息"，确认添加

发布版本

1. 选择"版本管理与发布"
2. 点击"创建版本"，输入版本信息
3. 点击"保存"并发布
4. 如需修改配置，需重新发布版本

验证接入

# 启动飞书 APP
# 在聊天搜索中查找创建的机器人
# 发送消息测试响应

# 查看 OpenClaw 日志确认
openclaw gateway status

常用命令速查表

功能	命令
`安装与更新`
安装 OpenClaw	`npm install -g openclaw@latest`
升级 OpenClaw	`npm i -g openclaw@latest`
查看版本	`openclaw --version`
`配置与管理`
运行向导	`openclaw onboard`
安装系统服务	`openclaw onboard --install-daemon`
备份配置	`cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup`
`服务控制`
启动网关	`openclaw gateway --port 18789`
重启网关	`openclaw gateway restart`
查看状态	`openclaw gateway status`
启动 Bot	`openclaw start`
停止 Bot	`openclaw stop`
`界面访问`
打开 Dashboard	`openclaw dashboard`
打开 TUI	`openclaw tui`
`模型配置`
查看模型列表	`openclaw models list`
查看模型状态	`openclaw models status`
测试模型	`openclaw agent --message "你好！" --session-id main`
`渠道管理`
添加渠道	`openclaw channels add`
渠道登录	`openclaw channels login`
查看渠道	`openclaw channels list`
`插件管理`
查看插件	`openclaw plugins list`
安装插件	`openclaw plugins install <name>`
更新插件	`openclaw plugins update <name>`
卸载插件	`openclaw plugins uninstall <name>`
`开发调试`
开发模式	`openclaw --dev`
查看帮助	`openclaw --help`
禁用颜色	`openclaw --no-color`

故障排查

问题 1：Gateway 无法启动

# 检查端口占用
netstat -tlnp | grep 18789

# 更换端口启动
openclaw gateway --port 28889

# 查看详细错误日志
openclaw gateway --verbose

问题 2：模型 API 调用失败

# 检查 API Key 是否有效
openclaw models status

# 测试 API 连接
curl -H "Authorization: Bearer sk-xxx" https://api.openai.com/v1/models

# 检查配置文件格式
node -e "console.log(JSON.parse(require('fs').readFileSync('~/.openclaw/openclaw.json')))"

问题 3：飞书消息无响应

# 检查飞书插件是否安装
openclaw plugins list | grep feishu

# 重启网关
openclaw gateway restart

# 检查飞书事件配置
# 确认事件订阅为"长连接"
# 确认已订阅"im.message.receive_v1"

问题 4：npm 安装速度慢

# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 使用 pnpm 替代 npm
npm install -g pnpm
pnpm add -g openclaw@latest

问题 5：WSL 网络问题

# 检查 WSL IP
ip addr show

# 测试 DNS 解析
nslookup api.openai.com

# 重启 WSL
wsl --shutdown
# 等待 8 秒后重新进入

快速开始（5分钟部署）

# 第 1 步：安装 Node.js（版本≥22）
# 下载地址：https://nodejs.org/

# 第 2 步：安装 OpenClaw
npm install -g openclaw@latest

# 第 3 步：运行初始化向导
openclaw onboard

# 第 4 步：配置模型（编辑 ~/.openclaw/openclaw.json）
# 添加你的 API Key 和模型配置

# 第 5 步：启动服务
openclaw gateway --port 18789

# 第 6 步：打开 Dashboard
openclaw dashboard

# 完成！访问 http://127.0.0.1:18789/ 开始使用

高级技巧

多模型负载均衡

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwen-bailian/qwen3-coder-plus",
        "fallbacks": [
          "qwen-bailian/qwen3-max",
          "minimax-cn/MiniMax-M2.1"
        ]
      }
    }
  }
}

自定义 Skills

# 进入 Skills 目录
cd ~/.openclaw/skills/

# 创建新 Skill 配置
echo '{"name": "my-skill", "description": "自定义技能"}' > my-skill.json

# 重启服务
openclaw gateway restart

远程访问配置

# 使用 Cloudflare Tunnel
cf tunnel --url http://localhost:18789

# 或使用 Ngrok
ngrok http 18789

参考资源

官方文档：https://docs.openclaw.ai/zh-CN/
GitHub 仓库：https://github.com/openclaw/openclaw
官方网站：https://openclaw.ai/

常用 API 提供商

阿里云百炼：https://dashscope.aliyun.com/
MiniMax：https://www.minimaxi.com/
智谱 AI：https://open.bigmodel.cn/
DeepSeek：https://platform.deepseek.com/

业余草公众号

最后，欢迎关注我的个人微信公众号：业余草（yyucao）！可加作者微信号：xttblog2。备注：“1”，添加博主微信拉你进微信群。备注错误不会同意好友申请。再次感谢您的关注！后续有精彩内容会第一时间发给您！原创文章投稿请发送至532009913@qq.com邮箱。商务合作也可添加作者微信进行联系！

本文原文出处：业余草： » OpenClaw 安装与使用命令大全以及飞书接入实战

2026年二月
一	二	三	四	五	六	日
« 1月
						1
2	3	4	5	6	7	8
9	10	11	12	13	14	15
16	17	18	19	20	21	22
23	24	25	26	27	28