1. OpenClaw 龙虾安装前，先把这几个坑想清楚
OpenClaw 龙虾是一个跑在服务器上的开源 AI 助手框架，它能接大模型、连飞书、执行系统命令，相当于给你自己搭一个 7×24 小时在线的“数字员工”。适合谁？有台 Linux 服务器、想让 AI 在飞书群里干活、又不想被各种平台绑定的人。我实测下来，从零到飞书能回消息，核心就三件事：装好本体、填对 API Key、把守护进程跑起来。
但很多人卡在第一步就放弃了。原因不是命令难，而是几个隐藏的坑：安装脚本跑完直接进交互向导，风险确认界面默认选的是 No，方向键没按对就退出了；模型认证那步要填 API Key，但 OpenClaw 本身不带模型，你得自己准备；守护进程如果没装，关掉终端 AI 就下线了，飞书那边发消息永远没反应。
这篇按真实操作顺序走一遍：先装 OpenClaw，再用 TaoToken 统一 Key 接入模型，然后配飞书机器人，最后把守护进程和日志排查讲透。每一步都给可复制的命令和配置，你跟着敲就行。
2. TaoToken 前置：一个 Key 管住所有模型调用
OpenClaw 的模型认证环节，向导会列一堆服务商让你选。如果你每个模型都去单独注册、单独拿 Key、单独充值，管理成本很高。TaoToken 的思路是：用一个统一 Key 接入多家模型，OpenClaw 这边只填一次，后面换模型不用改配置。
具体怎么接？OpenClaw 支持 Custom Provider（自定义提供商），你把 TaoToken 的 API 地址填进去，Key 填 TaoToken 生成的，模型名按你要用的填。这样 OpenClaw 以为自己在调一个普通服务商，实际背后路由到不同模型。
先去 TaoToken 控制台拿 Key。打开 https://taotoken.net/api-keys ，登录后新建一个 API Key，复制出来备用。这个 Key 就是后面填进 OpenClaw 的那串字符。
注意：TaoToken 的 API 端点是不带 UTM 的干净地址https://taotoken.net/api，配置里填这个。官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，需要看文档或开 Coding Plan 从这边进。
如果你后面要长期跑编码类 Agent 任务，可以了解下 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，按套餐走比按量付费更可控。
3. 可复制配置：从安装到 config.toml 骨架
3.1 跑安装脚本
在服务器终端执行：
wget https://open-claw.org.cn/install-cn.sh sh install-cn.sh脚本跑完会直接进openclaw onboard交互向导。第一个界面是风险确认：
I understand this is powerful and inherently risky. Continue? │ ○ Yes / ● No默认停在 No 上，用方向键上移到 Yes，回车。这只是免责声明，因为 OpenClaw 要拿你的 API Key 并执行系统命令，必须你亲自授权。
3.2 安装模式选 QuickStart
向导问 Installation Mode，两个选项：
| 模式 | 说明 | 适合 |
|---|---|---|
| QuickStart | 只配模型认证 + Gateway 网关 | 新手、先跑通 |
| Advanced | 完整配工作区、网关、渠道、Skills、守护服务等 7 步 | 深度定制 |
选 QuickStart。纯命令行服务器先把核心链路跑通，后面随时openclaw configure补配。
3.3 模型认证填 TaoToken
到 Model / Auth 这步，列表里选Custom Provider（自定义提供商）。然后按提示填：
- API Base URL：
https://taotoken.net/api - API Key：粘贴你在 TaoToken 控制台复制的 Key
- Model：填你要用的模型名，比如
kimi-k2.5或deepseek-v3.2，按 TaoToken 文档里支持的写
填完向导会检测可用模型，选一个设为默认。
3.4 工作区、网关、守护进程
Workspace 直接回车用默认~/.openclaw/workspace。Gateway host 保持127.0.0.1，端口默认18789。向导会生成一个 Gateway 认证 Token，复制保存好，忘了可以用openclaw dashboard --no-open找回。
到 Daemon 这步：
Install gateway as a background daemon? (Y/n)选Y。这样网关以后台系统服务运行，关终端不停，开机自启。服务器 7×24 跑必须选 Y。
Skills 那步选n跳过，先精简跑通。
3.5 config.toml 骨架
向导写完后，配置文件在~/.openclaw/config.toml。核心结构长这样，你可以对照检查：
[gateway] host = "127.0.0.1" port = 18789 token = "向导生成的token" [model] provider = "custom" base_url = "https://taotoken.net/api" api_key = "你的TaoToken Key" model = "kimi-k2.5" [workspace] path = "~/.openclaw/workspace" [daemon] enabled = true改完配置记得openclaw restart生效。
4. 验证请求：飞书接入与成功结果
4.1 装飞书插件
openclaw plugins install @m1heng-clawd/feishu openclaw restart看到 success 字样即成功。
4.2 飞书开放平台建应用
浏览器开 https://open.feishu.cn/ ，管理员登录进开发者后台，创建企业自建应用，填个名字比如“我的龙虾助手”。进应用详情，添加应用能力选「机器人」。在「凭证与基础信息」里复制 App ID 和 App Secret。
4.3 开权限
左侧「权限管理」，搜索并开通：
| 权限 | 用途 |
|---|---|
| im:message | 收发消息 |
| im:message.p2p_msg:readonly | 读单聊消息 |
| contact:user.base:readonly | 获取用户基本信息 |
4.4 凭证填入 OpenClaw
openclaw feishu-connect按提示依次粘贴 App ID 和 App Secret，插件自动完成握手绑定。
4.5 发布并测试
回飞书开放平台，右上角「创建版本」，填版本号如 1.0.0，确认发布。不发布机器人不生效。
打开飞书客户端，进工作台搜你创建的应用名，点机器人头像发一条消息。几秒内收到 AI 回复，说明整条链路通了。
4.6 验证守护进程
openclaw gateway status看到 running 状态即守护进程正常。再关掉终端重新连，飞书发消息还能回，说明后台常驻生效。
5. 本篇常见错排查
端口被占用：lsof -i:18789查占用进程，杀掉或换端口，改 config.toml 里port后 restart。
飞书机器人不回消息：先openclaw logs --follow --level error看实时错误。常见原因是应用没发布、权限没开全、或者 App Secret 填错。重新openclaw feishu-connect走一遍。
模型调用报 401：TaoToken Key 填错或过期。去 https://taotoken.net/api-keys 重新生成，更新 config.toml 里api_key后 restart。
守护进程起不来：openclaw logs --follow --level error看启动日志。多半是 config.toml 格式错误，用openclaw configure重新走一遍向导覆盖。
关终端后 AI 下线：Daemon 那步选了 n。重新openclaw onboard或手动改 config.toml 里daemon.enabled = true，然后openclaw restart。
日常维护命令速查：
| 场景 | 命令 |
|---|---|
| 查看网关状态 | openclaw gateway status |
| 实时错误日志 | openclaw logs --follow --level error |
| 重启 | openclaw restart |
| 重进配置向导 | openclaw onboard |
| 更新飞书插件 | openclaw plugins update @m1heng-clawd/feishu |
6. 接入文档与后续扩展
模型认证和飞书接入的详细参数，以 TaoToken 接入文档为准：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。想先在网页里试模型对话效果，用 https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 。长期跑编码或 Agent 任务，看 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。控制台管理 Key 在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 。
链路跑通后，你可以按需加 Skills 扩展能力，或者用openclaw configure补配 Advanced 模式里的其他渠道。守护进程日志建议定期看一眼，openclaw logs --follow --level error挂个后台窗口，出问题第一时间能定位。
