OpenClaw配置完全指南：从零搭建个人AI助手

Zzydzyg0618

220人浏览 · 2026-06-01 18:38:50

Zzydzyg0618 · 2026-06-01 18:38:50 发布

OpenClaw是2026年最火的AI Agent平台，GitHub星标250K+，各大厂商纷纷推出自己的"龙虾"产品。

1. OpenClaw概述

OpenClaw（俗称"龙虾AI"）是一个开源的AI Agent平台，GitHub星标已达250K+，超越React成为当前增速最快的开源框架之一。

核心数据：

GitHub星标：250K+
npm周下载量：150万次
全球活跃用户：40万
贡献者：1274人
ClawHub生态：5700+技能模块

核心优势：

开源免费，可自定义部署
支持20+AI提供商（DeepSeek、Moonshot、OpenRouter等）
支持12+消息渠道（飞书、企业微信、QQ、钉钉等）
本地运行，数据隐私有保障

2. 各大厂商的OpenClaw产品

2026年春节后，各大厂商纷纷推出自己的OpenClaw产品，形成"百虾争鸣"的局面。

2.1 腾讯系产品

产品名称	定位	特点
WorkBuddy	企业端	嵌入企业微信，面向企业协同
QClaw	个人端	嵌入QQ/微信，个人使用
微信ClawBot	一键接入	微信官方插件，扫码即用
腾讯云Lighthouse	云端部署	一键部署OpenClaw
腾讯文档Skills	办公场景	无缝集成腾讯文档

微信ClawBot接入：

# 1. 更新微信到最新版
# 2. 在微信"设置—插件"中找到ClawBot
# 3. 扫码或复制命令接入

2.2 百度系产品

产品名称	定位	特点
DuClaw	零部署服务	首购17.8元/月，支持多模型
百度云OpenClaw	云端部署	一键部署，轻量应用服务器
红手指Operator	手机端	2020年收购的红手指团队

DuClaw配置：

# 访问百度智能云控制台
# 选择"AI代理"类别下的"OpenClaw"应用模板
# 一键部署

2.3 阿里系产品

产品名称	定位	特点
HiClaw	开源Team版	阿里云通义实验室出品
Copaw	个人智能体工作台	阿里云推出
飞书妙搭	企业级	字节跳动飞书部门
JVSClaw	手机端	阿里云无影团队

2.4 华为系产品

产品名称	定位	特点
AgentArts	一站式开发平台	企业级智能体开发
小艺Claw	手机/平板	2026年3月25日开启预约
OfficeClaw	办公场景	2026年下半年发布
CodeClaw	写代码	2026年下半年发布

2.5 其他厂商产品

产品名称	厂商	特点
KimiClaw	月之暗面	2026年2月16日发布
MaxClaw	MiniMax	OpenClaw与自研模型结合
AutoClaw	智谱	OpenClaw与自研模型结合
ArkClaw	字节跳动火山云	2026年3月9日发布
360安全龙虾	360安全	2026年3月14日发布
有道龙虾LobsterAI	网易有道	2026年2月11日发布

2.6 产品选择建议

使用场景	推荐产品
个人使用	QClaw、微信ClawBot
企业办公	WorkBuddy、飞书妙搭
开发者	HiClaw、AgentArts
零基础用户	DuClaw、腾讯云Lighthouse
手机端	小艺Claw、JVSClaw

3. 环境准备与安装

3.1 系统要求

要求	规格
Node.js	≥ 22.12.0（推荐v24）
包管理器	npm、pnpm或bun
操作系统	macOS、Linux、Windows（WSL2推荐）
内存	建议4GB+
存储	建议2GB+可用空间

3.2 安装OpenClaw

方式一：一键安装（推荐新手）

macOS / Linux / WSL2：

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

Windows（PowerShell）：

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

方式二：npm安装（已有Node.js 22+）

npm install -g openclaw@latest
openclaw onboard --install-daemon

方式三：源码安装（开发者）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

方式四：中国插件安装（推荐国内用户）

# 安装OpenClaw China全渠道插件
openclaw plugins install @openclaw-china/channels
openclaw china setup

3.3 验证安装

openclaw --version      # 确认CLI可用
openclaw doctor         # 检查配置问题
openclaw gateway status # 验证Gateway运行状态

4. 核心概念解析

4.1 Gateway（网关）

Gateway是OpenClaw的核心组件，负责：

管理所有消息渠道连接
处理WebSocket通信
路由消息到正确的Agent

默认配置：

端口：18789
绑定：127.0.0.1（仅本机访问）
认证：Token模式

4.2 Agent（智能体）

Agent是具有独立人格和记忆的AI助手：

Session：每次对话会话
Workspace：Agent的工作区和记忆存储
Bootstrap文件：定义Agent的行为和人格

4.3 Skills（技能）

技能是扩展Agent能力的模块：

Bundled Skills：内置技能
Managed Skills：用户安装的技能（~/.openclaw/skills）
Workspace Skills：工作区专属技能（/skills）

5. 国内AI模型配置

5.1 DeepSeek（推荐国内用户）

{
  "profiles": [
    {
      "id": "deepseek",
      "type": "api-key",
      "provider": "openai",
      "apiKey": "sk-你的deepseek-key",
      "baseURL": "https://api.deepseek.com/v1",
      "model": "deepseek-chat"
    }
  ],
  "default": "deepseek"
}

获取API Key：

访问 https://platform.deepseek.com
注册账号并登录
点击"API Keys" → “创建”
支持支付宝充值

5.2 Moonshot（Kimi）

{
  "profiles": [
    {
      "id": "kimi",
      "type": "api-key",
      "provider": "openai",
      "apiKey": "sk-你的kimi-key",
      "baseURL": "https://api.moonshot.cn/v1",
      "model": "kimi-k2.5"
    }
  ],
  "default": "kimi"
}

获取API Key：

访问 https://platform.moonshot.cn
注册账号并登录
点击"API Key管理" → “新建”

5.3 OpenRouter（一个Key访问多家模型）

{
  "profiles": [
    {
      "id": "openrouter",
      "type": "api-key",
      "provider": "openai",
      "apiKey": "sk-or-你的openrouter-key",
      "baseURL": "https://openrouter.ai/api/v1",
      "model": "anthropic/claude-sonnet-4-20250514"
    }
  ],
  "default": "openrouter"
}

获取API Key：

访问 https://openrouter.ai
注册账号并登录
点击"Keys" → “Create Key”

5.4 七牛云MaaS（一个Key切换多个国内模型）

{
  "profiles": [
    {
      "id": "qiniu-maas",
      "type": "api-key",
      "provider": "openai",
      "apiKey": "你的七牛云api-key",
      "baseURL": "https://api.qnaigc.com/v1",
      "model": "deepseek-chat"
    }
  ],
  "default": "qiniu-maas"
}

5.5 国内模型对比

提供商	模型	价格	优势
DeepSeek	DeepSeek Coder	便宜	国内服务商，支付宝充值
Moonshot	Kimi K2.5	中等	长文本能力强
OpenRouter	多模型聚合	中等	一个Key访问多家模型
七牛云	多模型	便宜	国内服务商，多模型切换

6. 国内消息渠道配置

6.1 飞书（推荐国内用户首选）

飞书优势：

现代化办公体验
开发者友好
官方插件支持
中文文档和客服

配置步骤：

创建飞书应用
- 登录飞书开放平台：https://open.feishu.cn
- 创建企业自建应用
- 获取App ID和App Secret

配置OpenClaw

openclaw channels add
# 选择 Feishu，输入 App ID 和 App Secret

或手动编辑配置文件：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "botName": "我的AI助手"
    }
  }
}

安装飞书官方插件（推荐）

npx -y @larksuite/openclaw-lark@latest install

配置权限和事件
- 在飞书应用中开启机器人能力
- 使用「长连接接收消息」模式
- 订阅所需事件

飞书配置参考：

配置项	说明
`channels.feishu.enabled`	启用/禁用渠道
`channels.feishu.appId`	飞书应用App ID
`channels.feishu.appSecret`	飞书应用App Secret
`channels.feishu.streaming`	启用流式响应
`channels.feishu.threadSession`	启用话题会话

6.2 企业微信

配置步骤：

安装企业微信插件

# 方式一：安装聚合包（推荐）
openclaw plugins install @openclaw-china/channels
openclaw china setup

# 方式二：仅安装企业微信渠道
openclaw plugins install @openclaw-china/wecom

配置OpenClaw

openclaw config set channels.wecom.enabled true
openclaw config set channels.wecom.mode ws
openclaw config set channels.wecom.botId your-bot-id
openclaw config set channels.wecom.secret your-secret

或手动编辑配置文件：

{
  "channels": {
    "wecom": {
      "enabled": true,
      "mode": "ws",
      "botId": "your-bot-id",
      "secret": "your-secret"
    }
  }
}

企业微信模式对比：

功能	智能机器人(wecom)	自建应用(wecom-app)
被动回复消息	✅	✅
主动发送消息	❌	✅
支持群聊	✅	❌
需要企业认证	❌	❌
配置复杂度	简单	中等

6.3 QQ机器人

配置步骤：

创建QQ机器人
- 访问QQ开放平台：https://q.qq.com
- 注册账号（不是QQ登录，需要单独注册）
- 创建机器人，获取机器人ID和密钥
- 配置IP白名单

安装QQ渠道插件

openclaw plugins install @openclaw-china/qqbot

配置OpenClaw

openclaw config set channels.qqbot.enabled true
openclaw config set channels.qqbot.appId your-app-id
openclaw config set channels.qqbot.clientSecret your-app-secret

QQ渠道配置项：

配置项	默认值	说明
`enabled`	true	是否启用QQ渠道
`appId`	-	QQ机器人AppID
`clientSecret`	-	QQ机器人AppSecret
`dmPolicy`	“open”	私聊策略
`groupPolicy`	“open”	群聊策略
`requireMention`	true	群聊是否必须@机器人

6.4 钉钉

配置步骤：

创建钉钉机器人
- 登录钉钉开放平台：https://open.dingtalk.com
- 创建企业内部应用
- 开启机器人能力
- 获取AppKey和AppSecret

安装钉钉渠道插件

openclaw plugins install @openclaw-china/dingtalk

配置OpenClaw

openclaw config set channels.dingtalk.enabled true
openclaw config set channels.dingtalk.appKey your-app-key
openclaw config set channels.dingtalk.appSecret your-app-secret

6.5 国内渠道对比

功能	飞书	企业微信	钉钉	QQ
即时通讯	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
文档协作	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐	⭐
开发者友好	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐
用户基础	⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
免费额度	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐
配置难度	简单	中等	简单	简单

6.6 多平台组合策略

策略1：工作+生活

工作：飞书/企业微信/钉钉
生活：QQ/微信

策略2：团队协作

内部沟通：飞书/企业微信
客户服务：钉钉/QQ

策略3：主次搭配（推荐）

主平台：飞书（日常使用）
辅平台：企业微信（客户沟通）

7. 常用命令速查

命令	说明
`openclaw onboard`	初始化配置向导
`openclaw configure`	修改配置
`openclaw china setup`	中国插件配置向导
`openclaw tui`	打开终端聊天界面
`openclaw dashboard`	打开Web控制面板
`openclaw doctor`	诊断系统环境
`openclaw status`	查看运行状态
`openclaw logs`	查看运行日志
`openclaw update`	更新到最新版本
`openclaw gateway run`	启动Gateway
`openclaw gateway status`	检查Gateway状态
`openclaw channels login --channel feishu`	登录飞书
`openclaw plugins install <plugin>`	安装插件
`openclaw security audit --deep`	深度安全审计

8. 常见问题与解决方案

问题1：openclaw命令找不到

原因： npm全局安装路径未加入PATH

解决：

# 检查npm全局路径
npm prefix -g

# 添加到PATH（~/.bashrc或~/.zshrc）
export PATH="$(npm prefix -g)/bin:$PATH"

# 重新打开终端

问题2：Gateway启动失败

原因： 端口被占用或配置错误

解决：

# 检查端口占用
lsof -i :18789

# 强制重启Gateway
openclaw gateway --force

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

问题3：AI模型不响应

原因： API密钥错误或网络问题

解决：

# 检查配置
openclaw doctor

# 重新配置模型
openclaw configure --section model

# 测试API连接
openclaw agent --message "测试" --local

问题4：飞书/企业微信不回复

原因： Token错误或权限配置问题

解决：

# 检查渠道配置
openclaw channels status

# 重新登录
openclaw channels login --channel feishu

# 检查权限配置
openclaw configure --section channels

问题5：向导中途卡住

解决：

按Ctrl + C退出
重新运行openclaw onboard
之前的配置会保留，向导会从出错的地方继续

问题6：安全警告

原因： OpenClaw存在系统性安全缺陷

解决：

不要将Gateway暴露在公网
使用Token认证
定期运行openclaw security audit --deep
使用国内厂商的托管版本（如DuClaw、腾讯云Lighthouse）

9. 总结

本篇我们学习了：

✅ OpenClaw概述：什么是OpenClaw，核心数据
✅ 各大厂商产品：腾讯、百度、阿里、华为等
✅ 安装配置：四种安装方式，环境要求
✅ 核心概念：Gateway、Agent、Skills
✅ 国内AI模型：DeepSeek、Moonshot、OpenRouter、七牛云
✅ 国内渠道配置：飞书、企业微信、QQ、钉钉
✅ 常用命令：CLI命令速查
✅ 问题排查：常见问题解决方案

核心要点：

国内用户推荐使用DeepSeek或Moonshot作为AI模型
国内渠道推荐使用飞书作为首选平台
可以使用国内厂商的托管版本（如DuClaw、腾讯云Lighthouse）降低部署难度
注意安全问题，不要将Gateway暴露在公网

下一步建议：

探索Skills技能扩展
配置多个消息渠道
自定义Agent人格和记忆
设置自动化工作流（cron、hooks）

参考资源

相关文章：

觉得有用请点赞收藏！有问题欢迎在评论区讨论。 👍

AI编程社区

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

码道 · 寻艺——从零构建“非遗交互式对话平台“的完整实践

AI编程社区

码道：用 Python + FastAPI 快速构建一个学生信息管理接口：从零到 Swagger 在线文档

在日常开发和教学中，我们经常需要一套简单、可控、能快速上手的后端接口来演示"前后端分离"、练习 Restful API 设计，或者作为前端联调的 Mock 服务。传统做法往往是搭一套完整的 Web 工程：配置数据库、编写 DAO、引入 ORM、做请求分发……一套流程下来，光环境搭建就要花去不少时间，对于想快速验证想法、或者刚入门 API 开发的同学来说，显得过于沉重。

AI编程社区

码道：从零构建学生信息管理系统 API：FastAPI 内存版 CRUD 项目全解析

FastAPI 的强大，很大程度上来自 Pydantic 的校验能力。我们写下类型声明，FastAPI 在运行时自动把它变成边界检查器。name：字符串，长度限制 1 到 50；age：整数，限制在 6 到 120 之间（ge大于等于、le小于等于）；gender：字符串，用正则限定只能是"男"“女”“其他”；email：邮箱格式字符串；grade与major：可选字段，代表班级和专业方向。

AI编程社区

所有评论(0)

查看更多评论

Zzydzyg0618

@Zzydzyg0618

已为社区贡献1条内容

OpenClaw配置完全指南：从零搭建个人AI助手

Zzydzyg0618

目录

1. OpenClaw概述

2. 各大厂商的OpenClaw产品

2.1 腾讯系产品

2.2 百度系产品

2.3 阿里系产品

2.4 华为系产品

2.5 其他厂商产品

2.6 产品选择建议

3. 环境准备与安装

3.1 系统要求

3.2 安装OpenClaw

3.3 验证安装

4. 核心概念解析

4.1 Gateway（网关）

4.2 Agent（智能体）

4.3 Skills（技能）

5. 国内AI模型配置

5.1 DeepSeek（推荐国内用户）

5.2 Moonshot（Kimi）

5.3 OpenRouter（一个Key访问多家模型）

5.4 七牛云MaaS（一个Key切换多个国内模型）

5.5 国内模型对比

6. 国内消息渠道配置

6.1 飞书（推荐国内用户首选）

6.2 企业微信

6.3 QQ机器人

6.4 钉钉

6.5 国内渠道对比

6.6 多平台组合策略

7. 常用命令速查

8. 常见问题与解决方案

问题1：openclaw命令找不到

问题2：Gateway启动失败

问题3：AI模型不响应

问题4：飞书/企业微信不回复

问题5：向导中途卡住

问题6：安全警告

9. 总结

参考资源

所有评论(0)

温馨提示：您尚未绑定手机号

Zzydzyg0618