安装使用 OpenClaw

前面几篇文章讲了 Claude CodeCodex 这类终端里的 AI 编程助手,它们都是你坐在电脑前敲命令时用的工具。这篇文章介绍一个有点不一样的东西:OpenClaw。

OpenClaw 的图标是一只小龙虾(官方的说法是龙虾 🦞),所以下文我都叫它「小龙虾」。它是一个开源项目,GitHub 地址是 openclaw/openclaw

很多人看到又冒出来一个 Agent 工具,第一反应都是:这玩意儿跟 Claude Code 有啥区别,编程能力更强吗?

先把话说在前面:要论编程能力,小龙虾是比不过 Claude Code、Codex 的。后两个是模型厂商针对编程场景反复打磨过的生产级工具,小龙虾这种轻量级开源 Agent 比不了。

它的价值压根不在编程能力,而在换了一套和 Agent 打交道的方式。正常用 Claude Code、Codex,你得坐在电脑前敲键盘发号施令,离开电脑就用不了。小龙虾做的事情,是把 Agent 接到飞书、Telegram、WhatsApp、Slack 这些聊天软件上,你在手机上发条消息就能让它干活。

这就像你雇了个 24 小时待命的远程实习生,随时随地在手机上甩任务给它,它自己跑去执行,再把结果发回聊天窗口。

甚至这个实习生能力不够强也没关系,小龙虾可以反过来调用 Claude Code、Codex 这些专业 Agent 来干活,自己只当个和你交互的传声筒。关于这套「远程控制」的设计思路,LLM 和 Agent 的核心术语和原理 里有更展开的讨论。

所以你可以这么理解小龙虾:它是一个自托管的网关(Gateway),跑在你自己的机器上,一头连着聊天软件,一头连着 AI Agent。整个过程跑在你自己的设备上,模型 API 也是你自己配的。

这里要提醒一句部署位置的事。小龙虾常驻后台运行,你又是通过聊天软件远程指挥它,没法像坐在终端前用 Claude Code 那样实时盯着它每一步干了什么。而它本质上拿到了所在机器的操作权限,所以我不建议把它直接装在你的主力开发机上。

比较稳妥的做法是单独找一台机器来跑它,比如一台云服务器,或者一台闲置的旧电脑,相当于把整台机器的权限都交给它,之后再按需把相关文件、凭证放到这台机器上。

这样就起到了隔离的作用,万一它误删文件、乱改东西,也不会波及你的主力机。你的主力机还是你自己坐在电脑前,用 Claude Code 这类 Agent 干活,更安全可控。

小龙虾默认引导你登录 OpenAI、Anthropic 等官方账号,但和前面几篇文章的情况一样,国内用户更方便的做法是接入中转站的模型 API。下面就一步步把它装起来,并接入中转站的 GPT 模型。

安装

小龙虾要求本机已经装好 Node.js,官方推荐 Node 24。如果还没装 Node,去 Node.js 官网 下载安装即可。

用 npm 全局安装:

npm install -g openclaw@latest

装完后运行下面的命令启动配置向导:

openclaw onboard

接下来就是一连串交互式的配置过程,跟着向导一步步选就行。配置大模型时需要中转站的 API key,我们先把它准备好。

创建 API key

和前面 安装使用 Codex 时一样,我们用中转站来接入模型。中转站的原理就是一个代理,帮你把请求转发到官方接口,配置思路在 Codex 那篇文章里已经讲过,这里不再重复。

我一直用的是 aicode007.com 这个中转站,下面以它为例。

访问 https://aicode007.com/keys 页面,选择 GPT 模型创建一个 apikey,把 apikey 秘钥(sk- 开头的那串字符)复制下来备用:

拿到 apikey 之后,回到刚才启动的配置向导,继续往下走。

配置大模型

向导第一步会确认这是个人使用的实例。小龙虾默认按个人单用户设计,如果要给多人共享得额外做权限收紧,这里直接选 Yes 即可:

◆  I understand this is personal-by-default and shared/multi-user use requires
│  lock-down. Continue?
│  ● Yes / ○ No

接着选择配置模式,选推荐的 QuickStart,用一套合理的默认值快速跑起来,细节之后随时能改:

◆  Setup mode
│  ● QuickStart (recommended) (Recommended local setup. Change details later with
│  openclaw configure.)
│  ○ Manual setup
│  ○ Import from Claude

然后是选择模型提供商。列表里给的都是 OpenAI、Anthropic、Google 这些官方入口,我们要用中转站,所以选 More…

◆  Model/auth provider
│  ○ OpenAI
│  ○ Anthropic
│  ○ xAI (Grok)
│  ○ Google
│  ○ OpenRouter
│  ● More…
│  ○ Skip for now

在搜索框里输入 custom,找到 Custom Provider,它支持任意兼容 OpenAI 或 Anthropic 接口格式的端点,中转站正好属于这种:

◆  Model/auth provider

│  Search: custom (1 match)
│  ● Custom Provider (Any OpenAI or Anthropic compatible endpoint)
│  ↑/↓ to select • Enter: confirm • Type: to search

接下来填中转站的接口地址,也就是 aicode007 的 Base URL:

◆  API Base URL
│  https://api.aicode007.com

然后粘贴刚才复制的 apikey:

◇  How do you want to provide this API key?
│  Paste API key now

◆  API Key (leave blank if not required)
│  ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪

接口兼容性选 OpenAI Responses-compatible,这一项和 Codex 的配置wire_api = "responses" 是一个意思,走的都是 /responses 接口:

◆  Endpoint compatibility
│  ○ OpenAI-compatible
│  ● OpenAI Responses-compatible (Uses /responses)
│  ○ Anthropic-compatible
│  ○ Unknown (detect automatically)

最后填模型 ID,用 gpt-5.5

◆  Model ID
│  gpt-5.5

填完之后向导会自动验证一次,正常的话会显示 Verification successful。如果这里报错,说明前面填的 Base URL 或 API key 有问题,检查一下是否填对、网络是否通畅。

剩下两项是给这个配置起名字,保持默认或者随意填都行:

◇  Endpoint ID
│  custom-api-aicode007-com

◇  Model alias (optional)
│  aicode007-gpt-5.5
Configured custom provider: custom-api-aicode007-com/gpt-5.5

到这里模型就配好了。

配置通知渠道

模型配完之后,向导会让你选择把 Agent 接到哪个聊天软件上,也就是「通知渠道」。这一步是小龙虾的特色,配好之后你就能在聊天软件里直接和 Agent 对话了。

这里以飞书为例。

首先你得先有一个飞书账号,因为小龙虾扫码那一步实际上是去飞书开放平台创建一个自建应用(也就是给你当助手的那个 bot)。

如果你之前没用过飞书,去 飞书官网 用手机号注册,注册过程中按引导新建一个自己的团队,团队名随便填,一个人用免费版就够了。

飞书账号弄好之后,再到应用商店下载飞书手机 App,完成登录,后面扫码要用它。

继续配置 openclaw,在搜索框里输入 feishu,选择 Feishu/Lark

◆  Select channel (QuickStart)

│  Search: feishu (1 match)
│  ● Feishu/Lark (download from @openclaw/feishu)
│  ↑/↓ to select • Enter: confirm • Type: to search

选中后会自动下载飞书渠道的依赖,如果下载失败,确认一下网络是否通畅。

接下来选连接飞书的方式,扫码自动创建最方便:

◆  How do you want to connect Feishu?
│  ○ Enter App ID and App Secret manually
│  ● Scan a QR code to create a bot automatically

然后根据你的情况选择飞书的域名,中国用户选 feishu.cn,国际用户选 larksuite.com

◆  Which Feishu domain?
│  ● Feishu (feishu.cn) - China
│  ○ Lark (larksuite.com) - International

接下来终端里会显示一个二维码。打开手机端飞书 App,点右上角的 + 号,点「扫一扫」,扫描这个二维码就能自动创建一个智能助手,你可以给它起个名字。

最后是群聊策略,选 Allowlist(白名单模式),小龙虾只在你授权的会话里回复,避免在所有群里乱说话:

◆  Group chat policy
│  ● Allowlist - only respond in specific groups
│  ○ Open - respond in all groups (requires mention)
│  ○ Disabled - don't respond in groups

到这里飞书渠道就配好了。

不过现在你还不能直接在飞书里和小龙虾对话,因为本地的 Gateway 还没启动,要等后面所有配置都走完、Gateway 跑起来之后,整条链路才能打通。

其他配置

接下来是一些杂项配置,大部分用默认值或者先跳过就行,后面需要时随时能改。

先选网络搜索的提供商,让 Agent 具备联网搜索的能力。这里选免费的 Parallel Search (Free) 即可,它不需要额外的 API key:

◆  Search provider

│  Search: _
│  ○ Brave Search
│  ○ DuckDuckGo Search (experimental)
│  ○ Exa Search
│  ○ Firecrawl Search
│  ○ Gemini (Google Search)
│  ○ Grok (xAI)
│  ○ Kimi (Moonshot)
│  ○ MiniMax Search
│  ○ Ollama Web Search
│  ○ Parallel Search
│  ● Parallel Search (Free) (Free web search via Parallel's hosted Search MCP — no API key required · key-free)

然后是问你要不要现在预装 skill,先选 No,等小龙虾跑起来之后随时都能装:

◆  Configure skills now? (recommended)
│  ○ Yes / ● No

接下来几项是语音识别、地理位置查询之类的功能,需要单独的 API key,暂时用不上,都选 No

◇  Set GOOGLE_PLACES_API_KEY for goplaces?
│  ○ Yes / ● No

◇  Set OPENAI_API_KEY for openai-whisper-api?
│  ○ Yes / ● No

◇  Set ELEVENLABS_API_KEY for sag?
│  ○ Yes / ● No

最后是 Hooks,它能在 Agent 执行某些命令时自动触发一些动作(比如发起 /new 时把会话记忆保存下来)。暂时也不装,选 Skip for now,以后需要时再开启:

◇  Hooks ──────────────────────────────────────────────────────────────────╮
│                                                                          │
│  Hooks let you automate actions when agent commands are issued.          │
│  Example: Save session context to memory when you issue /new or /reset.  │
│                                                                          │
│  Learn more: https://docs.openclaw.ai/automation/hooks                   │
│                                                                          │
├──────────────────────────────────────────────────────────────────────────╯

◆  Enable hooks?
│  ◼ Skip for now
│  ◻ 🚀 boot-md
│  ◻ 📎 bootstrap-extra-files
│  ◻ 📝 command-logger
│  ◻ 🧹 compaction-notifier
│  ◻ 💾 session-memory

到这里所有配置就走完了。

启动并验证

配置走完,向导会问你想怎么启动 Agent,选 Hatch in Terminal 在终端里直接启动,顺便验证配置是否成功:

How do you want to hatch your agent?
│ ◼ Hatch in Terminal (recommended)

回车之后会进入一个交互式终端,跟 Claude Code、Codex CLI 的界面很像,你可以直接在终端里和小龙虾对话。

这一步会把本地的 Gateway 一起拉起来,前面配的飞书渠道也就跟着通了。

第一次进来它会主动跟你打招呼,问你想叫它什么、希望它是什么样的身份、用什么样的语气和你交流等等:

> Wake up, my friend!

Hey. I just came online. Who am I, and who are you?

We can keep it simple and figure out the basics together:
- what you want to call me
- what kind of "creature" I am
- the vibe you want from me
- a signature emoji

If you're stuck, I can suggest a few names and personalities.

你可以在这里告诉它一些信息,比如它叫什么名字、怎么称呼你。它会接着追问对话风格之类的问题,把你的要求都记下来,之后就按你说的方式工作。

聊完之后,输入 /exit 退出终端。

因为刚创建好还没有任何对话记录,这个智能助手不会出现在飞书的会话列表里。点飞书 App 右上角的放大镜图标,输入你刚才设置的助手名字,就能搜到它,点进去就能和小龙虾对话了。

总结

回顾一下,小龙虾和 Claude Code、Codex 这类终端工具的核心区别,是它把 AI Agent 接到了你日常用的聊天软件上:Agent 跑在你自己的机器上,你在手机飞书里发消息就能指挥它干活。

整个安装过程其实就三件事:用 npm 装好小龙虾、创建中转站的 API key、跟着 openclaw onboard 向导把模型和飞书渠道配好。配置里大部分选项保持默认或先跳过就行,等用熟了再按需开启搜索、skill、hooks 这些能力。

最后通过 Hatch in Terminal 启动验证,确认能在终端和飞书里正常对话,小龙虾就算彻底跑起来了。