前面几篇文章讲了 Claude Code 和 Codex 这类终端里的 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 启动验证,确认能在终端和飞书里正常对话,小龙虾就算彻底跑起来了。