Reading System

收录整理

OpenClaw 5分钟上手:把你的电脑变成本地AI智能体

调用第三方AI API,数据要上传云端,隐私顾虑和费用账单让人头疼。OpenClaw是一个开源本地AI智能体框架,安装简单、支持多渠道、MCP扩展丰富,GitHub 4个月突破25万星。本文手把手教你在5分钟内把电脑变成专属AI助手。

2026 年 3 月 30 日5 分钟Alex
OpenClaw 5分钟上手:把你的电脑变成本地AI智能体

背景与痛点

调用第三方AI API,数据要上传到云端,隐私顾虑、费用账单、网络延迟……你有没有想过:能不能在本地跑一个自己的AI助手,用自己的模型,跑在自己的机器上,还不影响日常使用?

OpenClaw 正是为解决这个问题而生。它是一个开源的本地AI智能体框架,支持多渠道(QQ/飞书/微信/Telegram)、支持MCP扩展、可以外接各种大模型API,最关键的是——安装和使用都非常简单。

4个月内GitHub突破25万星,被开发者称为"养虾",已经在Hacker News、Reddit等平台刷屏。


核心概念

OpenClaw的核心架构是Gateway(网关) + Agent(智能体) + Channel(渠道):

  • Gateway:运行在本机的守护进程,统一管理Agent和渠道连接
  • Agent:实际执行任务的"大脑",调用LLM处理对话
  • Channel:对接各个聊天平台(QQ、飞书等),负责收消息和发消息

它支持MCP协议(Model Context Protocol),意味着你可以像搭积木一样扩展各种工具——网页搜索、文件处理、代码执行等。


实操步骤

第一步:安装OpenClaw

推荐用npm全局安装(需要Node.js 18+):

# 全局安装 OpenClaw CLI
npm install -g openclaw

# 验证安装
openclaw --version

如果你用Linux/macOS,也可以用curl一键脚本安装:

curl -fsSL https://get.openclaw.io | sh

第二步:初始化配置

# 启动初始化向导
openclaw init

向导会引导你填写:

  • 数据存放目录(默认~/.openclaw)
  • 默认渠道(选QQ或飞书)
  • LLM Provider(支持OpenAI/MiniMax/Claude等)

初始化完成后,配置文件在~/.openclaw/config.yaml。

第三步:配置模型(以MiniMax为例)

打开~/.openclaw/config.yaml,找到providers段落:

providers:
  minimax:
    apiKey: "your-minimax-api-key"
    model: "MiniMax-M2.7"
    baseUrl: "https://api.minimax.chat/v1"

💡 没有API Key?你可以先注册MiniMax开发者平台,新用户有免费额度。

第四步:配置QQ渠道(go-cqhttp模式)

OpenClaw支持接入现有的QQ机器人。这里以单向说话模式为例(适合不想搭建go-cqhttp的用户):

channels:
  qq:
    enabled: true
    # 填入你的QQ号(接收消息的账号)
    account: 123456789
    # 消息接收模式
    reverse_ws: true
    # 外接go-cqhttp地址(可选)
    # wsUrl: "ws://localhost:8080/ws"

第五步:启动Gateway

# 前台启动(适合调试)
openclaw gateway start

# 后台启动(适合长期运行)
openclaw gateway start --daemon

看到以下输出说明启动成功:

🚀 OpenClaw Gateway 已启动
📡 监听渠道: qq, feishu
🤖 默认Agent: minimax
🌐 MCP扩展: 已加载 3 个

第六步:验证——发送第一条消息

在QQ给机器人发一条消息:

你好

正常情况下,机器人会在几秒内回复。


效果展示

以配置MiniMax模型为例,对话效果示例:

你:帮我写一个Python快速排序
Bot:当然可以!以下是一个简洁的快速排序实现:

def quicksort(arr):
    if len(arr) <= 1:
        return arr
    pivot = arr[len(arr) // 2]
    left = [x for x in arr if x < pivot]
    middle = [x for x in arr if x == pivot]
    right = [x for x in arr if x > pivot]
    return quicksort(left) + middle + quicksort(right)

# 测试
print(quicksort([3, 6, 8, 10, 1, 2, 1]))
# 输出: [1, 1, 2, 3, 6, 8, 10]

适用场景与局限

适用场景:

  • 个人/团队内部助手,不希望对话数据上云
  • 有多个渠道(QQ/飞书)需要统一接入的场景
  • 想用自己API Key降低成本,同时享受Agent能力

局限:

  • 本地运行对硬件有要求(内存建议16GB+)
  • go-cqhttp等QQ方案需要自行搭建反向代理服务
  • 部分高级MCP扩展需要额外配置

快速上手资源

  • GitHub:https://github.com/openclaw/openclaw
  • 官方文档:https://docs.openclaw.io
  • MCP扩展市场:https://openclaw.io/plugins
  • Discord社区:搜索"OpenClaw"加入讨论

作者:Alex | 原创首发