从0开始配置 OpenClaw(Linux 版)

系列：第一季 · 第 3 篇

这篇解决什么

• 在 Linux 上从零安装 OpenClaw，接 DeepSeek，跑通 CLI + tg bot
• OpenClaw 是 Node.js 写的 AI Agent，和上一篇的 Hermes（Python）路线不同
• 所有步骤在 Ubuntu 24.04 干净环境实测通过

最小前提

• 系统：Ubuntu 24.04
• Shell：bash
• 网络：能访问 npm registry、api.deepseek.com
• 你需要准备：一个 DeepSeek API Key、一个 tg bot token（可选）
• 本文主例子：DeepSeek（deepseek-v4-pro）
• 本文扩展范围：微信 / QQ / 飞书 / 自定义 API 网关

最终你会得到什么

1. openclaw 命令可用
2. 默认模型切到 DeepSeek v4-pro，CLI 能正常对话
3. tg bot 在线，私聊能收到回复
4. 本地 Web Dashboard 可访问

1. 安装前检查

做什么

确认终端环境满足最小条件。OpenClaw 是 Node.js 项目，需要 Node.js ≥ 20。

命令

whoamicat /etc/os-release | head -4node --versionnpm --version

执行结果

neolabai@lab:~$ whoamineolabaineolabai@lab:~$ cat /etc/os-release | head -4PRETTY_NAME="Ubuntu 24.04.4 LTS"neolabai@lab:~$ node --versionv22.22.2neolabai@lab:~$ npm --version10.9.7

成功标志 / 失败点

• Node.js ≥ 20，npm 正常
• 如果没有 Node.js：curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash - && sudo apt install -y nodejs
• 这一步没通过不要往下走

2. 安装 OpenClaw

做什么

npm 全局安装，一行搞定。

命令

npm install -g openclaw@latest

执行结果

added 549 packages in 26s

成功标志 / 失败点

• which openclaw 有路径（通常是 /usr/bin/openclaw）
• openclaw --version 输出版本号
• 比 Hermes 的安装简单很多，不用等 Python 环境和 Playwright 下载

3. 验证命令入口

命令

openclaw --versionopenclaw --help | head -5

执行结果

neolabai@lab:~$ openclaw --versionOpenClaw 2026.5.7 (eeef486)

4. 配置 DeepSeek

4.1 非交互式初始化

OpenClaw 的 onboard 命令支持一键非交互配置，比 Hermes 的"先装后配"更直接：

命令

openclaw onboard \  --non-interactive \  --mode local \  --auth-choice deepseek-api-key \  --deepseek-api-key "sk-你的真实key" \  --skip-health \  --accept-risk

执行结果

Updated ~/.openclaw/openclaw.jsonWorkspace OK: ~/.openclaw/workspaceSessions OK: ~/.openclaw/agents/main/sessions

4.2 切到 v4-pro

默认模型是 deepseek-v4-flash，切到 v4-pro：

命令

openclaw config set agents.defaults.model.primary deepseek/deepseek-v4-pro

执行结果

Updated agents.defaults.model.primary. Restart the gateway to apply.

成功标志 / 失败点

• openclaw.json 中 model.primary = deepseek/deepseek-v4-pro
• 和 Hermes 不同：OpenClaw 没有 base_url 陷阱，不需要手动清空

5. CLI 验收

命令

openclaw agent --local --agent main -m "请用一句话介绍你自己" --json

执行结果

{  "meta": {    "agentMeta": {      "provider": "deepseek",      "model": "deepseek-v4-pro",      "durationMs": 5058    }  },  "finalAssistantVisibleText": "我是 OpenClaw，一个运行在你本地的 AI 助手..."}

成功标志 / 失败点

• provider 为 deepseek
• model 为 deepseek-v4-pro
• 返回完整的文本回答

6. 接入 tg bot

6.1 写 token 到环境变量

export TELEGRAM_BOT_TOKEN="你的bot token"

6.2 添加 Telegram 频道

openclaw channels add --channel telegram --use-env

执行结果

Added Telegram account "default".

6.3 启动 gateway

openclaw gateway

执行结果

[gateway] agent model: deepseek/deepseek-v4-pro (thinking=high)[telegram] [default] starting provider (@neolab_hermes_bot)[gateway] ready

6.4 验证

openclaw status

│ Telegram │ ON      │ OK     │ token env (8743… · len 46) · accounts 1/1 │

如果你之前跑过 Hermes 的 tg bot，同一个 token 会冲突。先停掉 Hermes gateway 再启动 OpenClaw 即可。

成功标志 / 失败点

• openclaw status 中 Telegram 显示 OK
• 收到 [telegram] starting provider 日志

7. Web Dashboard

OpenClaw 自带 Web 管理面板，默认 http://127.0.0.1:18789。

启动 gateway 后自动可用：

curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:18789

200

浏览器打开就能看到状态面板，包括 agent 信息、channel 连接状态、会话管理等。

成功标志 / 失败点

• curl 返回 200
• 默认绑 127.0.0.1，仅本机可访问
• 端口和 Hermes 不同（18789 vs 9119），不会冲突

8. 微信与 QQ 接入

OpenClaw 同样支持微信和 QQ，接入命令和 Hermes 类似：

8.1 微信

openclaw channels add --channel wechat

接入方式同样是 iLink Bot API，需要扫码登录配对。DM 私聊最稳，群支持受限。

8.2 QQ

openclaw channels add --channel qqbot --app-id 你的AppID --app-token 你的Secret

走官方 QQ Bot API (v2)，需要先去 q.qq.com 注册应用。

⚠️ 微信和 QQ 的接入流程已核实（命令存在、参数正确），但未做端到端验收（需要扫码/注册应用）。

9. 飞书 bot

飞书插件已通过 channels add 安装，但配置方式和 tg 略有不同：

openclaw channels add --channel feishu --use-env

安装后 openclaw status 显示飞书为 SETUP 状态，需要在 openclaw.json 中手动填入 appId 和 appSecret 完成配置。

⚠️ 本篇验证了插件安装和命令路径，未做端到端收发验证。完整配置步骤参考 Hermes 篇（权限、scope 等流程一致）。

10. 自定义 API 网关

OpenClaw 支持任何 OpenAI 兼容接口。已核实 openai-api-key 方式可用（本文未做端到端验证，配置逻辑和 Hermes 篇的 custom provider 一致）：

openclaw onboard \  --non-interactive \  --mode local \  --auth-choice openai-api-key \  --openai-api-key "sk-xxx" \  --accept-risk

然后手动在 openclaw.json 中配置自定义 base_url。

11. 配置系统常驻服务

生产环境需要 gateway 常驻后台、开机自启。

11.1 安装 systemd 服务

openclaw gateway install

装完后：

systemctl --user enable --now openclaw-gateway.servicesystemctl --user status openclaw-gateway

11.2 验证

openclaw statuscurl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:18789

⚠️ systemd 需要真实 Linux 系统，Docker 容器无法验证。和上一篇 Hermes 的 systemd 章节一样。

12. Hermes vs OpenClaw 快速对比

最终验收

openclaw --versionopenclaw statusopenclaw agent --local --agent main -m "你好" --json

通过标准

• openclaw --version 有输出
• openclaw status 显示 gateway reachable
• agent 返回完整回答

总结

• OpenClaw 用 npm 一行安装，onboard 一条命令配好 DeepSeek，比 Hermes 的门槛更低
• 没有 base_url 陷阱，非交互式初始化非常干净
• 微信、QQ、飞书都支持，接入方式和 Hermes 大同小异
• 下一篇我们对比三个 Agent 的实际使用体验

🧬 生物信息学 · 智能医学工程 · 医学影像学 交流群

入群咨询：19.9 元（全系统支持，群内优先答疑） 远程安装/配置：168 元/次（一对一远程，包教会）

加微信：neolabai加好友请备注：单位/学校 - 专业/方向 - 姓名/昵称