OpenClaw 我第一次跑通的时候,说实话有点懵。项目装好、模型配置好、进程也起来了,日志里干干净净,看起来一切正常——但我愣是不知道该怎么跟它“说话”。后来才反应过来,OpenClaw 本身不是一个带界面的应用,它是一套本地跑的 AI Agent 框架,你得自己选一个入口接进去。这个“入口”选得对不对,直接影响后面好不好用。
这篇文章不聊怎么安装 OpenClaw,聊的是部署完成之后怎么接入。我把自己实际用过的三种方式完整梳理了一遍:命令行直连、HTTP API 接入、消息平台接入。三种方式解决三类问题,配套的场景、配置步骤、踩坑记录都在下面,照着抄基本能跑通。适合正在折腾本地 AI 部署的朋友,也适合已经跑起来了但不知道怎么把 OpenClaw 能力暴露给其他工具的人。
1. 接入的本质:先想清楚你要连的是哪个“口”
1.1 OpenClaw 本地部署后到底是一个什么东西
要搞懂怎么接入,先得明白部署完成后你面前摆了一个什么形态的服务。OpenClaw 本质是一个常驻进程。它启动之后会做三件事:读取配置(比如 openclaw.json 和 .env 里的环境变量)、加载模型后端、把各个通道(作者称之为 Channel)拉起来。
模型后端这一步很关键。OpenClaw 本身不含模型,它需要对接一个推理服务,最常见的就是本地 Ollama。你可以在配置里写 provider: ollama,然后指定模型名,比如 qwen2.5:7b 或者 llama3.1:8b。跑起来之后,OpenClaw 只是一个“大脑调度器”,真正干活的是背后的模型。所以接入 OpenClaw 之前,先确认模型服务是通的,这个我后面在准备章节里会具体说。
通道这层决定了你能从哪里喊它。CLI 通道就是终端;API 通道是一个本地 HTTP 服务;IM 通道则是企业微信、Telegram 这类平台。三种接入方式,本质上就是针对这三类通道做配置和调用。
1.2 三种接入方式的定位差异
我整理了一张表,方便你按需求直接选:
| 接入方式 | 入口形态 | 典型场景 | 技术门槛 | 适合谁 |
|---|---|---|---|---|
| 命令行 CLI | 终端交互 | 调试 prompt、验证工具调用、快速问答 | 低 | 开发者、正在调配置的人 |
| HTTP API | REST 接口 | 把 OpenClaw 作为后端服务嵌入自己的系统、给第三方 AI 工具当模型源 | 中 | 二次开发、工具链集成 |
| 消息平台 | 微信/Telegram 机器人 | 日常使用、远程指令、多人共用 | 中 | 想把它当私人助理的非技术用户 |
选型之前一定要想清楚一个问题:你到底想让谁用?如果只是自己调试,CLI 就够了,没必要开 API;如果想让笔记本上的脚本、家里的自动化任务调用它,API 是正路;如果是想让同事在微信上直接跟机器人说话,那必须走消息平台。三种方式可以同时启用,互不冲突,但每多开一个口就多一份暴露面,这一点到文章后面你们会看到我踩过的坑。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 接入前的准备:跑起来不等于能接入
2.1 确认 OpenClaw 进程和配置
开始之前,先把环境确认一遍。我的部署习惯是:先看日志确认进程是健康的,再看配置确认要用的通道是开的,最后才动手接。
OpenClaw 启动之后,终端会打印当前加载的配置摘要,包括模型、API 端口、各通道状态。如果你在 Windows 上用 WSL2 跑,启动时可能会碰到一个很经典的报错:could not safely verify the wsl2 environment。这个问题我放到后面排查章节细说,这里只想强调一点:在 WSL2 里部署和直接在 Linux 裸机上部署,遇到的接入问题完全不是一回事,Windows 用户务必先把这个环境校验过掉。
配置文件这块,我以我自己的 openclaw.json 为例。主配置里最重要的是三段:model 段决定模型后端,api 段决定是否开放 HTTP 接口,channels 段决定哪些 IM 平台被拉起来。确认这三个段都符合预期,再继续往下。如果你不确定当前配置是否生效,用 openclaw doctor 这类自检命令扫一遍,哪一环没就绪它会直接标红,省得自己猜。
2.2 打通模型后端,否则接进去也是哑巴
我见过太多人卡在这一步:OpenClaw 跑起来了,CLI 也能进,但问什么它都不回。查了半天发现是 Ollama 没起来,或者模型根本没下载。所以接入之前,务必先单独验证模型服务。
以 Ollama 为例,先确认服务在跑:
bash复制curl http://127.0.0.1:11434/api/tags
如果返回一个 JSON 列表,里面有模型名,说明服务正常。接着确认你要用的模型存在:
bash复制ollama list
如果没有,先拉一个。我个人在这台机器上用 qwen2.5:7b,日常问答和工具调用都够用。然后回到 OpenClaw 配置里,把模型名写成和本地模型完全一致
