OpenClaw 接入 Open Move 教程

📋 前置条件

在开始配置之前，请确保您具备以下条件：

API 凭证： 在 Omni Move 中获取到 Claude 的密钥/令牌（Key）

Node.js 环境： 需安装 Node.js 24+ 版本 (点击前往官网下载)

一、安装与基础初始化

首先，请确保您的终端环境已正确安装 Node.js 24+，然后执行以下步骤：

1. npm 安装（推荐全局安装）

2. 验证安装

安装完成后，检查版本号以确认是否成功：

3. 初始化配置

执行初始化命令（配置文件默认将生成在 ~/.openclaw/openclaw.json）：

二、配置 OpenClaw

⚠️ 提示： 如果您之前已经配置过其他大模型（如小龙虾），您可以直接跳到下方的**“方案 B：只添加模型”**部分，或使用命令行让工具自动添加模型。

接下来，请配置 openclaw.json 文件。您可以按需替换 API 地址、API Key 和访问 Token。后续也可以通过运行 openclaw config 命令或直接修改该文件来持续调整配置。

👉 方案 A：完整 `openclaw.json` 参考模板

您可以直接复制以下模板，并替换其中的中文注释部分：

{
  "gateway": {
    "port": 18789, 
    "mode": "local",
    "auth": {
      "token": "你的访问令牌"  // 访问 Dashboard 登录需要用到
    },
    "trustedProxies": ["127.0.0.1"],
    "controlUi": {
      "allowedOrigins": ["*"],
      "allowInsecureAuth": true
    }
  },
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/chromium-browser", // 需要先在服务器安装 Chromium
    "headless": true,
    "noSandbox": true
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "claude/claude-opus-4-6-thinking", // 主模型
        "fallbacks": [ // 备用模型
          "claude/claude-sonnet-4-6-thinking",
          "claude/claude-sonnet-4-6",
          "gpt/gpt-5.4",
          "gemini/gemini-3.1-pro-preview"
        ]
      },
      "models": {
        "gemini/gemini-3.1-pro-preview": {
          "alias": "gemini 3 pro"
        }
      },
      "imageModel": {
        "primary": "gemini/gemini-3.1-pro-preview"
      },
      "compaction": {
        "mode": "default"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "claude": {
        "baseUrl": "https://api.omove.ai/v1",
        "apiKey": "sk-你的Claude令牌",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 思考版",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      },
      "gpt": {
        "baseUrl": "https://api.omove.ai/v1",
        "apiKey": "sk-你的GPT令牌",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      },
      "gemini": {
        "baseUrl": "https://api.omove.ai/v1",
        "apiKey": "sk-你的Gemini令牌",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-3.1-pro-preview",
            "name": "Gemini 3.1 Pro",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1048576,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "channels": {
    "telegram": { 
      "enabled": true,
      "botToken": "你的TelegramBotToken", 
      "dmPolicy": "allowlist",
      "allowFrom": ["*"], 
      "groupPolicy": "allowlist",
      "streaming": "partial"
    },
    "feishu": {
      "enabled": true,
      "dmPolicy": "open",
      "allowFrom": ["*"],
      "appId": "你的appid",
      "appSecret": "你的appSecret",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open",
      "streaming": true,
      "footer": {
        "elapsed": true,
        "status": true
      }
    }
  },
  "plugins": {
    "slots": {
      "memory": "memory-lancedb"
    },
    "entries": {
      "memory-lancedb": {
        "enabled": true,
        "config": {
          "embedding": {
            "apiKey": "sk-用于embedding的令牌"  // 永久记忆
          }
        }
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true
  }
}

👉 方案 B：只添加/更新模型配置

编辑 openclaw.json，在 models.providers 节点里添加下方代码（添加不同厂商模型时请用逗号隔开）：

Claude 模型配置：

"claude": {
  "baseUrl": "https://api.omove.ai/v1",          
  "apiKey": "sk-", // 替换自己的 api key
  "api": "anthropic-messages",
  "models": [
    {
      "id": "claude-opus-4-6-thinking",
      "name": "Claude Opus 4.6 思考版",
      "reasoning": true,
      "input": ["text", "image"],
      "contextWindow": 200000,
      "maxTokens": 16384
    }
  ]
}

GPT 模型配置：

"gpt": {
  "baseUrl": "https://api.omove.ai/v1",
  "apiKey": "sk-", // 替换自己的 api key
  "api": "openai-completions",
  "models": [
    {
      "id": "gpt-5.4",
      "name": "GPT-5.4",
      "reasoning": false,
      "input": ["text", "image"],
      "contextWindow": 200000,
      "maxTokens": 16384
    }
  ]
}

Gemini 模型配置：

"gemini": {
  "baseUrl": "https://api.omove.ai/v1",
  "apiKey": "sk-", // 替换自己的 api key
  "api": "openai-completions",
  "models": [
    {
      "id": "gemini-3.1-pro-preview",
      "name": "Gemini 3.1 Pro",
      "reasoning": true,
      "input": ["text", "image"],
      "contextWindow": 1048576,
      "maxTokens": 65536
    }
  ]
}

在 openclaw.json 文件的 agents.defaults.model.primary 中，添加上述模型为您期望的主模型，fallbacks 为备用模型，imageModel 为视觉模型。

配置完毕后，保存文件并重启 OpenClaw 服务。

验证配置文件

修改完毕后，请验证配置是否有语法错误。如有报错请按提示修改，无报错则可继续下一步。

三、启动服务

使用 nohup 命令在后台启动网关服务（注意：启动过程可能会有几十秒的延迟加载时间）：

验证服务是否成功启动：

四、访问 Dashboard (OpenClaw 仪表盘)

在浏览器中输入以下地址（请注意加上您的 token 参数进行验证）：

http://你的服务器IP:18789/#token=你设置的token令牌值

如果登录页面出现 pairing 字样，则说明需要进行设备验证。

设备验证步骤：

回到终端，输入以下命令，此时会显示 Request 值（如图中箭头所示），请复制该值：

再次在终端输入授权命令（替换为你刚复制的 Request 值）：

返回浏览器，不要刷新页面，等待一会自动连接。如果没有自动连接，可以点击左侧“概览”，然后手动点击“连接”。

五、接入第三方通讯平台

🟢 接入飞书 (Feishu)

1. 创建飞书机器人

进入飞书开放平台：https://open.feishu.cn

注册登录后，进入 开发者后台 -> 创建企业自建应用 -> 创建。

添加应用能力：选择 “添加机器人”。

权限管理：开通权限，搜索 im:，开通所有消息相关权限（可自选），并确认开通。

创建版本并发布：填写版本详情，保存并发布。

2. OpenClaw 连接飞书

回到服务器终端，输入交互配置命令并回车：

按以下路径选择 (空格勾选，回车确认)： Local -> Channels -> Configure/link -> feishu(飞书) -> Download from npm(安装飞书插件)

根据提示，去飞书开放平台（凭证与基础信息）复制 App Secret 和 App ID，分别粘贴到终端中并回车。

继续选择：WebSocket -> Feishu.cn China -> Open re... -> Finished -> yes -> pairing -> Continue。

重启 OpenClaw 服务：

3. 配置飞书事件订阅

回到飞书开放平台 -> 事件与回调。

订阅方式：选择 “长链接” 并保存。

添加事件：搜索“接收”，勾选 “接收消息” 并确认添加。

权限管理：搜索“通讯录”，勾选 “获取通讯录基本信息” 并确认开通。

再次创建版本并发布。

4. 授权配对

打开手机飞书 App -> 开发者小助手 -> 打开刚才创建的应用，向机器人发送任意消息。

机器人会回复一段包含配对码的信息。复制箭头指向的最后一段配对命令，在终端中运行：

🎉 成功提示： 配对成功后，回到飞书 App 即可与机器人正常对话！

🔵 接入 Telegram

💡 提示： 接入前请确保您已安装并能正常使用 Telegram App。

1. 获取 Bot Token
打开 Telegram，搜索 @BotFather 发送 /newbot，按提示设置 Bot 名称和用户名。创建成功后，复制系统提供的 Bot Token（格式类似 123456789:ABCdef...）。

2. 配置 JSON 文件
编辑 openclaw.json，在 channels 部分添加或修改以下内容：

"telegram": {
  "enabled": true,
  "botToken": "你的Bot Token",
  "dmPolicy": "allowlist", 
  "allowFrom": ["*"], // 建议替换为您自己的 Telegram 用户 ID，"*" 存在安全风险
  "groupPolicy": "allowlist",
  "streaming": "partial"
}

3. 验证并重启服务

4. 设置 Webhook (关键)
Telegram 需要您的服务器有一个公网 HTTPS 地址来接收消息。请在终端执行以下命令进行绑定：

(注意：请将 URL 中的括号替换为实际的 Token 和公网 IP)

✅ 测试验证： 去 Telegram 搜索您创建的 Bot，发送一条消息，查看是否能收到正常回复。

六、常用操作指令

配置向导

（交互式配置，自动合并写入 openclaw.json 文件）

进程管理

模型管理

临时切换（在聊天框中直接发送）：

/model claude/claude-sonnet-4-6-thinking

命令行管理：

配置管理

软件更新

聊天框常见斜杠命令 (Slash Commands)

命令	功能说明
`/new`	开启全新会话
`/stop`	中止当前运行的任务
`/compact`	释放上下文窗口空间
`/status`	显示健康状态和当前上下文
`/context list`	列出所有上下文贡献者
`/subagents list`	列出子智能体
`/subagents info`	查看子智能体信息
`/model`	查看当前使用的模型
`/model list`	列出所有可用模型
`/model <编号>`	按编号快速切换模型（如 `/model 3`）
`/model <ID>`	按完整 ID 切换模型
`/model status`	查看模型详细状态
`/think`	开启 / 关闭推理模式
`/reasoning on`	开启深度推理
`/tts on`	开启文本转语音
`/tts off`	关闭文本转语音

❓ 七、常见问题排查 (FAQ)

❌ Q1: 启动服务时提示 Invalid config 错误？

💡 解决办法： 请检查配置文件中 claude.api 的值是否正确。正确值必须是 anthropic-messages，如果简写为 anthropic 会导致此报错。

🛠️ Q2: 聊天时回复工具调用错误（function tag mismatch）？

💡 解决办法： 同上，这也是由于 claude.api 填错导致，请将配置修改为 anthropic-messages 后重启服务即可。

⚙️ Q3: 使用 systemctl restart openclaw 失败怎么办？

💡 解决办法： 如果您的服务器环境（如某些 Docker 容器内）没有 systemd 管理器，请使用 pkill + nohup 的方式进行手动重启（详见上方“进程管理”部分的命令）。

🌐 Q4: 发送消息后模型请求超时或无响应？

💡 解决办法： 请使用 curl 命令直接在服务器上测试您配置的 provider key 和 baseUrl 的网络连通性。确认 Key 有效且网络无阻断后，重启服务重试。

📋 前置条件#

一、安装与基础初始化#

1. npm 安装（推荐全局安装）#

2. 验证安装#

3. 初始化配置#

二、配置 OpenClaw#

👉 方案 A：完整 openclaw.json 参考模板#

👉 方案 B：只添加/更新模型配置#

验证配置文件#

三、启动服务#

四、访问 Dashboard (OpenClaw 仪表盘)#

五、接入第三方通讯平台#

🟢 接入飞书 (Feishu)#

🔵 接入 Telegram#

六、常用操作指令#

配置向导#

进程管理#

模型管理#

配置管理#

软件更新#

聊天框常见斜杠命令 (Slash Commands)#

❓ 七、常见问题排查 (FAQ)#