[AI应用] OpenClaw(龙虾) 概述

0 序

image

Openclaw vs Hermes vs Cursor vs Codex vs Qoder vs Trae vs Claude Code vs CodeBuddy - Google Trends

1 概述: OpenClaw/龙虾

简介

  • OpenClaw（中文社区叫"龙虾"）是一个【开源、自托管的 AI 智能体网关】，由奥地利开发者 Peter Steinberger 于 2025 年 11 月作为周末项目发起，不到 5 个月就成了 GitHub 全球增速第一的仓库。

截止 2026.8.4 在 Github 开源社区： 38 万 star

  • 它不是一个聊天机器人，而是一套跑在你自己机器或服务器上的"AI 操作系统"——通过 Gateway 把 WhatsApp、Telegram、Discord、Slack、飞书、钉钉等 20+ 消息渠道，连接到 Claude、GPT、Gemini、DeepSeek 或本地 Ollama 等任意大模型，让 AI 真正去执行任务，而不只是给建议。

区别: OpenClaw vs 普通 AI 助手

  • 真执行，不草稿：说"发邮件"就真的发出去，"加日历"就真的写入，能操作浏览器、读写文件、跑 shell 命令
  • 持久记忆：用知识图谱记住你的偏好、项目和历史对话，跨渠道共享，不会"下次见面就忘"
  • 完全自托管：MIT 协议开源，数据全留本地，API key 不出本机，支持离线运行
  • 多渠道入口：同一个 AI 大脑，在 WhatsApp / Telegram / Discord / 飞书里都能调
  • 技能可扩展：通过 Skills 系统接任意 API，社区有 ClawHub 技能市场；也支持 MCP、子智能体编排、Cron 定时任务和 Heartbeat 主动心跳

典型用法

ChatGPT/大模型 是只张嘴的顾问，OpenClaw 是能干活的员工。

  • 个人助理：早间简报、邮件分类与自动回复、日历管理、航班值机
  • 开发助手：代码审查、PR 描述生成、CI/CD 监控、Bug 自动修复并开 PR
  • 企业自动化：客服收件箱、知识库问答、团队协作记忆
  • 内容运营：选题、多平台发布、数据复盘
  • 智能家居：通过 Home Assistant 控制灯光、温控、门锁

核心优势

  • 自托管 + 数据自控：MIT 开源，跑在自己机器/服务器上，对话、密钥、记忆全留本地，适合有数据主权要求的个人和团队
  • 真执行，不止问答：能清收件箱、发邮件、管日历、浏览网页、填表单、读写文件、跑命令，是"有手的 AI"而非"顾问"
  • 多渠道统一入口：一个 Gateway 同时接 WhatsApp / Telegram / Discord / Slack / 飞书 / 钉钉等，在常用聊天软件里直接驱动
  • 模型无关：可切 Claude / GPT / Gemini / DeepSeek / 本地 Ollama 等，不被单一厂商锁定
  • 持久记忆 + 技能生态：Markdown 长期记忆越用越懂你；ClawHub 技能市场可一键装数千个插件扩能力

主要短板

  • 部署门槛高：需要克隆 GitHub 仓库、配 Python/Node 环境、装依赖、填 API 密钥，不是"一键启动"的消费品，普通用户很容易卡在安装阶段
  • Token 烧钱快：自身不内置模型，每次任务都要调用外部大模型；一个"日历整理+邮件回复"的中型任务约耗 5k–1w token，长期记忆单日可达 10w token 以上，按国内主流模型资费单日基础消耗上百元
  • 安全风险突出：为了自主执行，必须授予读写本地文件、操作浏览器、执行终端命令的高权限，曾被曝出权限绕过与远程代码执行漏洞，恶意技能包可控制用户设备
  • 稳定性不足：长任务、多子 Agent 并行时内存占用大，普通电脑易卡顿崩溃；上下文压缩后可能丢失关键指令，曾有用户因此被批量删除 200 多封邮件
  • "能想不会做"：长链条推理强，但遇到弹窗、页面加载失败等真实环境异常时缺乏实时感知与自主纠错能力，执行反馈闭环断裂

它是给开发者用的"手动挡越野车"——能力强，但贵、重、危险/不安全、不稳，普通人贸然上主力机容易踩坑 。

适用场景

  • 开发者 / 运维：代码审查、PR 自动开、CI/CD 触发、日志分析、服务器巡检
  • 隐私敏感的个人或小团队：把邮件、日历、文件管理、知识库等个人事务自动化，数据不出本机
  • 需要多渠道接入的产品/客服：一个后台同时服务多个 IM，统一路由、统一治理
  • 要调用内部系统 / 私有 API 的团队：托管平台接不进来的内网工具，自托管网关能打通
  • 定时自动化任务：靠内置 Cron + Heartbeat 让 AI 无人值守跑日常监控、资讯抓取、报表推送

适合"想把 AI 真正变成 7×24 在岗员工、且愿意自己掌控数据和部署"的开发者和团队；只想开箱即聊天的普通用户，ChatGPT / 豆包更省事。

  • 小结: 谁适合用

开发者和高级用户——它需要 Node 24（或 22 LTS 22.16+）、对应模型的 API key，一行命令 npm i -g openclaw && openclaw onboard 五分钟可跑起来。由于 OpenClaw 默认拥有较高的系统权限，如果配置不当，可能导致计算机和 API 密钥暴露；多用户共用一个开启工具的智能体时，等于共享了同一份操作授权，所以官方明确说它"【不是默认的多租户安全边界】"，需要自己做好安全加固。
简单说：如果你想拥有一个"数据完全在自己手里、能真的动手干活、还能塞进日常聊天软件里"的 AI 员工，OpenClaw 是目前开源界最完整的方案；如果你只是想要个对话玩具，ChatGPT 或豆包更省事。

2 原理架构篇

进程组件

OpenClaw 运行时的进程模型非常简洁——"1 个常驻主进程 + 按需派生的子进程"，不是一堆微服务 。

常驻主进程：Gateway

Gateway/网关的作用 *

  • 唯一的【常驻进程】是一个 Node.js 进程，叫 Gateway，默认监听 127.0.0.1:18789（WebSocket + HTTP 复用同一端口）。网关是 OpenClaw 的 WebSocket 服务器（通道、节点、会话、钩子）。它承担全部核心职责 ：
  • Channel Adapters：维护 WhatsApp / Telegram / Discord / Slack / 飞书等渠道的长连接
  • Session Manager：解析发送者身份与对话上下文
  • Queue：按会话串行化 Agent 运行，避免并发冲突
  • Agent Runtime：组装上下文、调用 LLM、执行工具调用
  • Control Plane：暴露 WebSocket API 供 Dashboard / CLI / App 连接控制
  • 一台机器只跑一个 Gateway，所有渠道和客户端都连它 。

它有前台调试（openclaw gateway）和守护进程（openclaw gateway start）2种运行模式 。

Dashboard 组件 := Control UI ∈ Gateway 进程 *

  • Dashboard : 不是独立进程，是 Gateway 在同一端口上"顺手"提供的一个网页前端。

官方定义： 使用一个短暂的一次性浏览器配对链接打开控制界面（Control UI）。成功完成交接后，该浏览器将拥有自己的持久设备凭证。因此，重新打开仪表板不再依赖共享的网关令牌。
官方文档写得很清楚：Control UI（也就是 Dashboard）是一个由 Gateway 提供服务的小型 Vite + Lit 单页应用，默认跑在 http://<host>:18789/，并在同一端口上直接连接 Gateway 的 WebSocket。

  • 进程层面：只有 Gateway 一个常驻 Node.js 进程，Dashboard 没有自己的 OS 进程
  • 端口层面：Gateway 默认在 18789 端口上多路复用三种流量——WebSocket 控制面、HTTP API、以及 Control UI，靠【协议嗅探区分】
  • 浏览器里的 Dashboard：本质是连回 Gateway 的 WebSocket 客户端，跟 CLI、macOS App、iOS/Android Node 是同一类"客户端"角色，只不过它以网页形式呈现
  • 生命周期：关掉浏览器标签页 ≠ 停掉 Gateway；反过来 【Gateway】 一停，Dashboard 页面立刻报"无法连线"

按需子进程：Agent 执行时派生

  • Gateway 主进程内部的大多数组件都是线程级子系统，不是独立 OS 进程。真正通过 spawn() 新建操作系统子进程的，只有这些按需场景 ：
  • bash 工具执行：Agent 调用 shell 命令时派生 bash 子进程
  • 媒体处理：处理音视频时派生 ffmpeg 子进程
  • Agent Turn：每次 Agent 推理-执行循环按需创建，完成即释放

也就是说，平时你 ps 看到的 OpenClaw 相关进程主要就是 Gateway 自己；只有它真的去"动手"执行 shell 或转码时，才会短暂多出 bash / ffmpeg 【子进程】。

外部连接方（非 OpenClaw 派生进程）

这些是与 Gateway 通过 WebSocket 通信的独立客户端，不属于 Gateway 的进程树 ：

  • CLI 工具（openclaw ... 命令）
  • macOS 菜单栏 App / iOS / Android 节点
  • Web Dashboard（Control UI）

它们由系统各自拉起，通过 ws://127.0.0.1:18789 连回 Gateway，Gateway 重启后它们需要重连。

3 部署运维篇

安装 On Windows

  • step1 安装 NodeJs
C:\Users\xxx> node --version
v25.9.0

C:\Users\xxx> npm -v
11.12.1

//查看全局默认的依赖安装包(node_modules)的存储路径
C:\Users\xxx> npm root -g
D:\Program_Files\nodejs\node-v25.9.0-win-x64\node_modules
  • step2 安装 openclaw
npm install -g openclaw@latest
  • step3 启动运行

启动过程中涉及配置模型信息等操作。

C:\Users\xxx> openclaw onboard --install-daemon

C:\Users\xxx> openclaw gateway status

OpenClaw 2026.7.1-2 (0790d9f) — I'm the middleware between your ambition and your attention span.

|
o
Service: Scheduled Task (registered)
File logs: ~\AppData\Local\Temp\openclaw\openclaw-2026-08-05.log
Command: D:\Program_Files\nodejs\node-v25.9.0-win-x64\node.exe D:\Program_Files\nodejs\node-v25.9.0-win-x64\node_modules\openclaw\dist\index.js gateway --port 18789
Service file: ~\.openclaw\gateway.cmd
Service env: OPENCLAW_GATEWAY_PORT=18789

Config (cli): ~\.openclaw\openclaw.json
Config (service): ~\.openclaw\openclaw.json

Gateway: bind=loopback (127.0.0.1), port=18789 (service args)
Probe target: ws://127.0.0.1:18789
Dashboard: http://127.0.0.1:18789/
Probe note: Loopback-only gateway; only local clients can connect.

Runtime: running (pid 7796, Gateway process detected for gateway port 18789.)
Gateway process is running and owns the gateway port, so this is not a warm-up delay. Check the probe credentials/config, or restart the gateway and inspect its logs if it stays unresponsive.
Connectivity probe: failed
Probe target: ws://127.0.0.1:18789
  timeout
Capability: unknown

Port 18789 is already in use.
- pid 7796: D:\Program_Files\nodejs\node-v25.9.0-win-x64\node.exe  D:\Program_Files\nodejs\node-v25.9.0-win-x64\node_modules\openclaw\dist\index.js gateway --port 18789 (127.0.0.1:18789)
Listening: 127.0.0.1:18789
Troubles: run openclaw status
Troubleshooting: https://docs.openclaw.ai/troubleshooting

C:\Users\xxx> openclaw dashboard
  • 此时，即可访问 OpenClaw 了

运维操作

  • 启动运行
  • 方式1
//1 运行网关组件:
openclaw gateway start
或 openclaw gateway restart
或 openclaw gateway --port 18789


//2 另开一窗口:
openclaw dashboard
(默认浏览器会自动打开管理界面（通常为  http://127.0.0.1:18789 ），可在此配置代理、查看任务或与 AI 交互。)
或 openclaw dashboard --no-open
(打印网址但不打开浏览器)
或 openclaw dashboard --json
(在不打开浏览器、使用剪贴板、提示或启动网关的情况下，打印一个可读的连接对象)
或 openclaw dashboard --yes
(在需要时【无需提示】即可启动/安装网关)

或 守护进程模式一键启动: openclaw onboard --install-daemon

使用 --install-daemon 参数可将 OpenClaw 注册为系统服务，让网关在后台持续运行，无需每次手动启动

image

image

  • 配置与修改

配置文件使用 JSON5 格式，支持注释和末尾逗号，可直接编辑。
修改配置后，网关会 热重载 自动生效，无需重启。
若需重新进入向导，可运行：

openclaw configure

image

  • 停止运行
openclaw gateway stop
openclaw daemon stop
  • 查看状态
C:\Users\xxx> openclaw gateway status
o
Service: Scheduled Task (registered)
File logs: ~\AppData\Local\Temp\openclaw\openclaw-2026-08-05.log
Command: D:\Program_Files\nodejs\node-v25.9.0-win-x64\node.exe D:\Program_Files\nodejs\node-v25.9.0-win-x64\node_modules\openclaw\dist\index.js gateway --port 18789
Service file: ~\.openclaw\gateway.cmd
Service env: OPENCLAW_GATEWAY_PORT=18789

Config (cli): ~\.openclaw\openclaw.json
Config (service): ~\.openclaw\openclaw.json

Gateway: bind=loopback (127.0.0.1), port=18789 (service args)
Probe target: ws://127.0.0.1:18789
Dashboard: http://127.0.0.1:18789/
Probe note: Loopback-only gateway; only local clients can connect.

CLI version: 2026.7.1-2 (D:\Program_Files\nodejs\node-v25.9.0-win-x64\node_modules\openclaw\openclaw.mjs)
Gateway version: 2026.7.1-2

Runtime: running (pid 27452, Gateway process detected for gateway port 18789.)
Connectivity probe: ok
Capability: read-only

Listening: 127.0.0.1:18789
Troubles: run openclaw status
Troubleshooting: https://docs.openclaw.ai/troubleshooting


C:\Users\xxx> openclaw daemon status
o

OpenClaw 2026.7.1-2 (0790d9f) — I read logs so you can keep pretending you don't have to.

Service: Scheduled Task (registered)
File logs: ~\AppData\Local\Temp\openclaw\openclaw-2026-08-05.log
Command: D:\Program_Files\nodejs\node-v25.9.0-win-x64\node.exe D:\Program_Files\nodejs\node-v25.9.0-win-x64\node_modules\openclaw\dist\index.js gateway --port 18789
Service file: ~\.openclaw\gateway.cmd
Service env: OPENCLAW_GATEWAY_PORT=18789

Config (cli): ~\.openclaw\openclaw.json
Config (service): ~\.openclaw\openclaw.json

Gateway: bind=loopback (127.0.0.1), port=18789 (service args)
Probe target: ws://127.0.0.1:18789
Dashboard: http://127.0.0.1:18789/
Probe note: Loopback-only gateway; only local clients can connect.

Runtime: unknown
Connectivity probe: failed
Probe target: ws://127.0.0.1:18789
  connect ECONNREFUSED 127.0.0.1:18789
Capability: unknown

Troubles: run openclaw status
Troubleshooting: https://docs.openclaw.ai/troubleshooting
  • 查看帮助
openclaw gateway --help

主要功能

  • 设置
  • 支持配对移动设备
  • 对话
  • ...

概览

image

对话

image

设置

  • 设置
    image

  • AI与Agent
    image

4 实践指南

CASE 配置 model/模型

用命令 openclaw configure 或在 WEB GUI 上配置大模型LLM的方式，本节就不多赘述了。主要讲下直接编辑/配置 ~/openclaw/openclaw.json的方式

image

  • step1 配置 ~/openclaw/openclaw.json 的 models.providers

"ollama" / "siliconflow" 这些 provider 的名称是完全用户自主定义的，甚至可以写为中文。

  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "https://ollama.com",
        "apiKey": "xxxx.xxx-xxxxxx"
      },
      "siliconflow": {
        "baseUrl": "https://api.siliconflow.cn/v1",
        "api": "openai-completions",
        "apiKey": "sk-xxxxxxxhejfgdshjfxxxxxxxxxx",
        "authHeader": true,
        "auth": "api-key",
        "models": [
          {
            "id": "deepseek-ai/DeepSeek-V3",
            "name": "DeepSeek-V3",
            "contextWindow": 64000,
            "maxTokens": 4096
          },
          {
            "id": "Qwen/Qwen3-32B",
            "name": "Qwen3-32B",
            "contextWindow": 64000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
  • step2 配置 ~/openclaw/openclaw.json 的 agents.defaults.(models|model.primary)
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\xxxx\\.openclaw\\workspace",
      "models": {
        "anthropic/claude-opus-4-8": {},
        "siliconflow/Qwen/Qwen3-32B": {},
        "siliconflow/deepseek-ai/DeepSeek-V3": {}
      },
      "model": {
        "primary": "siliconflow/Qwen/Qwen3-32B"
      },
      "bootstrapMaxChars": 50000,
      "bootstrapTotalMaxChars": 300000,
      "contextInjection": "always"
    }
  },

模型名称的格式: ``//`

  • step3 重启 gateway
openclaw gateway restart

CASE 配置 tools/工具 : web search/网页检索 + web fetch/网页获取

  • 想让你的【智能体】（agent）具备【联网能力】？ OpenClaw 内置了2个轻量级网页工具：
  • web_search— 网页搜索。支持 Perplexity Search API、Brave Search API、Gemini（带 Google 搜索联网）、Grok 或 Kimi。
  • web_fetch — 网页获取（fetch）。 发起 HTTP 请求并提取可读内容（HTML → Markdown/文本）。

这2个工具适合大多数常规网页操作场景。 但请注意，它们不是浏览器自动化工具——如果你的目标网站重度依赖 JavaScript 渲染，或者需要登录才能访问内容，请改用浏览器工具。

  • Openclaw 在识别并执行一些需要基于浏览器做联网搜索的子任务时，需要基于 web search （Web搜索引擎）组件来实现。

具体的 web search 的实现厂商有很多，本章节仅选其中几个来做示范。

|  Search: 
|    Brave Search (Brave Search web results. · Brave Search API key required)
|    DuckDuckGo Search (experimental) (Free web search fallback with no API key required · key-free)
|    Exa Search (Neural + keyword search with date filters and content extraction · Exa API key required)
|    Firecrawl Search (Structured results with optional result scraping · Firecrawl API key required)
|    Gemini (Google Search) (Requires Google Gemini API key · Google Search grounding · Google Gemini API key required)
|    Grok (xAI) (Uses xAI OAuth or API key · xAI web-grounded responses · xAI API key required)
|    Kimi (Moonshot) (Requires Moonshot / Kimi API key · Moonshot web search · Moonshot / Kimi API key required)
|    MiniMax Search (Structured results via MiniMax Token Plan search API · MiniMax Token Plan key or OAuth token required)
|  > Ollama Web Search (Local Ollama host · requires ollama signin · key-free)
|    Parallel Search (LLM-optimized dense excerpts from web sources · Parallel API key required)
|    Parallel Search (Free) (Free web search via Parallel's hosted Search MCP — no API key required · key-free)
|    Perplexity Search (Requires Perplexity API key or OpenRouter API key · structured results · Perplexity API key required)
|    SearXNG Search (Self-hosted meta-search with no API key required · SearXNG Base URL required)
|    Tavily Search (Structured results with domain filters and AI answer summaries · Tavily API key required)
  • 如果对 ~/.openclaw/openclaw.json 文件很熟悉，可直接在该文件中进行操作；反之，则可通过交互式命令行进行:
openclaw configure --section web

image

方式1 配置 Ollama Search (云账号) 作为 OpenClaw 的 web search （免费/推荐）

  • 参考文献

https://docs.openclaw.ai/zh-CN/tools/web

  • step1 注册 ollama 官网账号，并创建 api key

https://ollama.com/settings/keys

image

  • step2 打开 ~/.openclaw/openclaw.json 文件
  • 配置 model.provider.ollama 信息 (ollama 的 host)
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "https://ollama.com",
        "apiKey": "xxxxx",
      },
      "siliconflow": {
          ...
      },
      ...
    }
  ...

baseUrl 配置值也可换为Ollama私有化部署地址，如: http://<私有化部署的Host>:11434，此时 私有化部署的 Ollama apiKey 默认是没有的。（默认不开启 Api Key鉴权）

  • 配置 tools.web.search / plugins.entries.ollama
  "tools": {
    ...
    "web": {
      "search": {
        "provider": "ollama",
        "enabled": true,
        "openaiCodex": {}
      },
      "fetch": { "enabled": true }
    }
  },
  "plugins": {
    "entries": {
      "ollama": {
        "enabled": true
      }, ...
    }
  },
  ...
  • step3 安装 web_search 模块所依赖的 Web自动化组件，并重启
npm install -g @openclaw/web-automation

openclaw gateway restart
  • step4 在OpenClaw中享用基于联网检索的 AI Agent 任务

http://127.0.0.1:18789/chat?session=agent%3Amain%3Adashboard%3Acac998e0-xxx-xxxx-xxxx-xxxxbfd9xxxx

image

方式2 配置 Brave Search 作为 OpenClaw 的 web search （已收费 / 不推荐）

Z FAQ for OpenClaw

Q: OpenClaw vs. 国产Claw(QClaw / ArkClaw / AutoClaw等)相比，更建议使用国产化Claw，还是 OpenClaw？

  • 没有"国产一定更好"或"OpenClaw 一定更好"，只有"谁更适合你的场景"。

这些国产 Claw 大多基于 OpenClaw 核心模块做了【差异化封装】——本质是一条技术路线的不同产品形态 。

按你的身份对号入座

1 开发者 / 技术极客 / 要深度定制 → 选 OpenClaw 原版

  • 完全开源（MIT），可看源码、可改代码、不受单一厂商商业策略限制
  • 社区生态最活跃，5000+ GitHub 技能随便装
  • 模型无关，Claude / GPT / Gemini / 本地 Ollama 随意切
  • 代价：部署门槛高（Node.js ≥ 22 + Docker + Git），需自担安全风险

2 微信 / QQ 重度用户 → 选 QClaw（腾讯）

  • 唯一真正打通微信直连，手机发消息、电脑执行
  • 本地一键安装，腾讯电脑管家还提供"隔离房"安全沙箱
  • 5000+ 预置技能，国产模型中文优化
  • 代价：生态相对封闭，定制能力受限；公测期免费

3 飞书生态 / 企业团队 → 选 ArkClaw（字节火山引擎）

  • 云端 SaaS，零部署运维，深度集成飞书套件
  • 企业级权限与安全管理，适合团队协作
  • 代价：数据在云端，可能产生订阅费用；强依赖飞书

4 零门槛本地派 / 数据敏感 → 选 AutoClaw（智谱）

  • 真·一键安装（下载→双击→完成，1 分钟内）
  • 本地运行数据不上云，预置 50+ 技能，多模型支持
  • 浏览器自动化能力强（AutoGLM 驱动）
  • 代价：技能生态不如原版丰富，模型调用按 Token 计费

一张表速查

你的核心诉求 首选 关键理由
完全控制权、深度定制 OpenClaw 开源、生态最大、模型无关
微信里直接操控电脑 QClaw 唯一微信直连
飞书协同、不想运维 ArkClaw 云端 SaaS + 飞书原生
本地运行 + 零门槛 AutoClaw 一键装、数据不出本机
企业级办公自动化 WorkBuddy（腾讯） 企业微信/钉钉/飞书全覆盖

反直觉de事实

  • 国产 Claw 不是来替代 OpenClaw 的，而是来补全它的。

OpenClaw 是"买食材自己做饭"——控制权最大但费事；国产 Claw 是"外卖"——开箱即用但自由度低 。
很多进阶用户的最终方案是组合使用：

OpenClaw 负责【深度定制】和【技术探索】 + 【QClaw/AutoClaw】 做日常主力 + 飞书场景挂 【ArkClaw】，三者互为备份、各取所长。
如果你的诉求是"我就想马上用起来"——直接选国产 Claw（微信党 QClaw，飞书党 ArkClaw，纯本地零门槛 AutoClaw）；如果你的诉求是"我要完全掌控、愿意折腾"——OpenClaw 原版仍是不可替代的起点。

无论选哪个，OpenClaw 系产品默认都被授予较高系统权限，国家互联网应急中心已发安全预警 。自用务必做好权限隔离，不要把高权限 Agent 暴露到公网。

Y 推荐文献

  • OpenClaw
  • 第三方网站（非官方）

X 参考文献

posted @ 2026-08-05 17:54  数据知音  阅读(8)  评论(0)    收藏  举报