OpenClaw - Teio

OpenClaw 是一个自托管 Gateway 网关，可将你常用的聊天应用和渠道界面——包括内置渠道，以及 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等内置或外部渠道插件——连接到像 Pi 这样的 AI 编码智能体。你只需在自己的机器上（或服务器上）运行一个 Gateway 网关进程，它就会成为你的消息应用与一个始终在线的 AI 助手之间的桥梁。

本文档以 2026.4.8 版本的 OpenClaw 为例进行说明，其他版本的安装流程基本一致。

前置条件

已创建 API 密钥
若选择NPM安装，则需要 Node.js 24+ LTS版本

安装 OpenClaw

macOS
Windows

一键安装（推荐）：

curl -fsSL https://openclaw.ai/install.sh | bash

或通过 NPM：

npm install -g openclaw

通过 NPM：

npm install -g openclaw

配置

安装完成后，在终端运行：

openclaw onboard

等着会输出询问你是否锁定共享账户，需要选择yes并回车

Macshot Clipboard DC944263 FF94 4307 9C65 DAA3649730ED

选择 QuickStart 快速安装模式

Macshot Clipboard A341BD0E 5CDA 4080 96BC 0B906DADAB5C

选择Model模型供应商时一直向下，选择 Custom Provider

Macshot Clipboard 460F6BFF 543B 4929 B92D 7B80E8AD1B9E

输入 Teio 平台提供的链接: https://teio.me/v1

Macshot Clipboard C84A503A 306C 425C 971E F6F399DEBF52

选择现在提供密钥

Macshot Clipboard 8EE2F0C4 0F8E 427B BCA4 D7900BF9726A

输入对应 API密钥： 你的密钥

Macshot Clipboard 74278170 CFB2 442D AFFD A82DE82FD528

选择兼容性为 Anthropic 。这里配置的是Claude分组密钥。若配置 OpenAI分组密钥则选择 OpenAI

Macshot Clipboard 11F51C09 BFE0 4447 A2D5 5D1A992AB131

输入模型ID： claude-opus-4-6

Macshot Clipboard C30AD64C D1CA 4E13 A4DB 35C47AB6C44F

这里要等验证通过才能进行下一步确保验证成功

Macshot Clipboard F4A533DD 2429 4D21 9D57 C76474CBFF15

验证过程偶尔可能返回错误，重试通常即可成功。如果持续失败，请检查 API 密钥是否正确、网络是否通畅。

会自动显示模型提供商 Endpoint ID，什么都不做，直接回车

Macshot Clipboard A7AA36B9 41D1 45EF 8182 90DE56BE23C1

设置别名。这里根据自己设置对应别名就行

Macshot Clipboard ED029BD9 6439 4018 96E0 7DDED6B2C8D9

选择通讯工具。这里跳过

Macshot Clipboard 9799369A 092D 4D08 931D 71FFB4FE5CFC

选择搜索引擎提供商。这里跳过

Macshot Clipboard ED767DB6 F67F 4DD5 B7B2 D643C600FC02

是否配置 skills。这里不需要后续再说

Macshot Clipboard FCB88D3E CA1B 4A16 8214 D7E4CD16D877

配置hooks，用于在 OpenClaw 每次启动前执行某些脚本。空格选择，可多选

Macshot Clipboard 655F2200 E4B0 4DAB 96FF F0881DAD5D98

选择接下来与小龙虾沟通方式。TUI是文字交互界面，Web UI是浏览器界面。后续可以随意切换

Macshot Clipboard 13D28C58 D979 4137 A04C 56CC5F0D8F0D

如果配置正确，你会进入 OpenClaw 的交互界面，可以直接开始使用。

Macshot Clipboard 4B358D3C 4829 46B5 AF81 8D5B88A6E26D

常见问题

Cannot find module '@larksuiteoapi/node-sdk'

这是 npm 旧版本的依赖解析问题，按以下步骤修复：

安装最新 LTS 版本的 Node.js
删除本地 npm 缓存：
- macOS / Linux：rm -rf ~/.npm
- Windows：rd /s /q %AppData%\npm-cache
卸载 openclaw：npm uninstall -g openclaw
重新安装 openclaw：npm install -g openclaw

如果以上步骤仍未解决，我建议直接指定版本安装：npm install -g openclaw@2026.4.8 版本2026.4.22 已经修复这个问题

Context limit exceeded. I've reset our conversation to start fresh - please try again

这是因为模型的上下文窗口和最大 token 数配置太小了，需要手动调大。分三步：第一步：修改 ~/.openclaw/openclaw.json在 agents 下添加 compaction 配置，并在 models 中调大上下文和 token 限制：

{
  "agents": {
	"defaults": {
		"compaction": {
	      "reserveTokensFloor": 0
	    }
	}
  },
  "models": {
    "mode": "merge",
    "providers": {
      "custom-teio-me": {
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6 (Custom Provider)",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

第二步：修改 ~/.openclaw/agents/main/agent/models.json同样调大对应模型的上下文和 token 限制：

{
  "providers": {
    "custom-teio-me": {
      "models": [
        {
          "id": "claude-sonnet-4-6",
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

contextWindow 和 maxTokens 的值可以根据你的实际需求调整。

第三步：重启服务

openclaw gateway restart

版本2026.4.22 已经修复这个问题。不过还是要调整模型上下文窗口和最大 token 数

遇到问题？请参考常见问题。

​前置条件

​安装 OpenClaw

​配置

​常见问题

前置条件

安装 OpenClaw

配置

常见问题