跳转到主要内容
千问云 home page
开放平台文档
客户端与工具

OpenClaw

在 OpenClaw 中使用 Token Plan

OpenClaw（原名 Moltbot/Clawdbot）是一个开源的个人 AI 助手平台，支持通过多种消息渠道与 AI 交互。

安装 OpenClaw

  1. 安装或更新 Node.js 在终端运行以下命令查看当前 Node.js 版本（需 v22.0 或更高版本）。如果提示"找不到命令"，说明未安装；如果显示版本号低于 v22.0，说明需要更新。 
node -v
访问 nodejs.org，在页面中选择"LTS"且版本号 >= 22.x.x，根据系统下载安装包。
  1. 执行安装命令
  • macOS/Linux
  • Windows
按 Command + Space 打开终端，运行：
curl -fsSL https://openclaw.ai/install.sh | bash
  1. 完成 Onboarding Wizard 配置 安装结束后会自动出现提示信息，请根据提示完成配置：
    配置项配置内容
    I understand this is powerful and inherently risky. Continue?选择 "Yes"
    Onboarding mode选择 "QuickStart"
    Model/auth provider选择 "Skip for now"，后续可以配置
    Filter models by provider选择 "All providers"
    Default model使用默认配置
    Select channel (QuickStart)选择 "Skip for now"，后续可以配置
    Configure skills now? (recommended)选择 "No"，后续可以配置
    Enable hooks?按空格键选中 "Skip for now"，按回车键进入下一步
    How do you want to hatch your bot?选择 "Do this later"

配置 Token Plan 团队版

  • 通过终端修改
  • 通过网页浏览器修改
  1. 在终端执行以下命令打开配置文件：
nano ~/.openclaw/openclaw.json
  1. 首次配置：复制以下内容到配置文件，将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。 已有配置：若需保留已有配置，请勿直接全量替换，详见已有配置如何安全修改。 
{
  "models": {
    "mode": "merge",
    "providers": {
      "qwencloud-token-plan": {
        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.6-plus",
            "name": "qwen3.6-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "compat": {
              "thinkingFormat": "qwen"
            }
          },
          {
            "id": "qwen3.6-flash",
            "name": "qwen3.6-flash",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "deepseek-v4-pro",
            "name": "deepseek-v4-pro",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "deepseek-v4-flash",
            "name": "deepseek-v4-flash",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "deepseek-v3.2",
            "name": "deepseek-v3.2",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "kimi-k2.6",
            "name": "kimi-k2.6",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "kimi-k2.5",
            "name": "kimi-k2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "glm-5.1",
            "name": "glm-5.1",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 202752,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "glm-5",
            "name": "glm-5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 202752,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "MiniMax-M2.5",
            "name": "MiniMax-M2.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 196608,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwencloud-token-plan/qwen3.6-plus"
      },
      "models": {
        "qwencloud-token-plan/qwen3.6-plus": {},
        "qwencloud-token-plan/qwen3.6-flash": {},
        "qwencloud-token-plan/deepseek-v4-pro": {},
        "qwencloud-token-plan/deepseek-v4-flash": {},
        "qwencloud-token-plan/deepseek-v3.2": {},
        "qwencloud-token-plan/kimi-k2.6": {},
        "qwencloud-token-plan/kimi-k2.5": {},
        "qwencloud-token-plan/glm-5.1": {},
        "qwencloud-token-plan/glm-5": {},
        "qwencloud-token-plan/MiniMax-M2.5": {}
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "test123"
    }
  }
}
如需添加更多模型，请在 providers.qwencloud-token-plan.models 中添加模型定义，在 agents.defaults.models 中添加 "qwencloud-token-plan/模型ID": {} 条目。可用模型请参考 Token Plan 团队版支持的模型。
  1. 保存文件并退出，运行以下命令使配置生效：
openclaw gateway restart

配置按量计费

将 YOUR_API_KEY 替换为千问云 API Key（格式为 sk-xxxxx）。可用模型请参考模型广场。
配置项说明
API Key千问云 API Key，格式为 sk-xxxxx
Base URLhttps://dashscope.aliyuncs.com/compatible-mode/v1
可用模型模型广场中支持的模型
  • 通过终端修改
  • 通过网页浏览器修改
  1. 在终端执行以下命令打开配置文件：
nano ~/.openclaw/openclaw.json
  1. 首次配置：复制以下内容到配置文件，将 YOUR_API_KEY 替换为千问云 API Key。 已有配置：若需保留已有配置，请勿直接全量替换，详见已有配置如何安全修改。 
{
  "models": {
    "mode": "merge",
    "providers": {
      "qwencloud": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.6-plus",
            "name": "qwen3.6-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "compat": {
              "thinkingFormat": "qwen"
            }
          },
          {
            "id": "MiniMax-M2.5",
            "name": "MiniMax-M2.5",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 196608,
            "maxTokens": 32768
          },
          {
            "id": "glm-5",
            "name": "glm-5",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 202752,
            "maxTokens": 16384,
            "compat": {
              "thinkingFormat": "qwen"
            }
          },
          {
            "id": "deepseek-v3.2",
            "name": "deepseek-v3.2",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 131072,
            "maxTokens": 16384,
            "compat": {
              "thinkingFormat": "qwen"
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwencloud/qwen3.6-plus"
      },
      "models": {
        "qwencloud/qwen3.6-plus": {},
        "qwencloud/MiniMax-M2.5": {},
        "qwencloud/glm-5": {},
        "qwencloud/deepseek-v3.2": {}
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "test123"
    }
  }
}
  1. 保存文件并退出，运行以下命令使配置生效：
openclaw gateway restart

使用 OpenClaw

支持通过网页浏览器和终端命令行的方式使用 OpenClaw。
  • 网页浏览器
  • 终端命令行
新开一个终端，运行以下命令，浏览器将自动打开 OpenClaw 的操作界面：
openclaw dashboard
界面打开后即可开始对话。

常见命令

命令说明示例
/help显示可用命令的快速摘要/help
/status查看当前模型、会话、网关等状态信息/status
/model <模型名称>切换当前会话使用的模型/model qwen3.6-plus
/new开始一个新会话/new
/compact压缩对话历史，释放上下文窗口空间/compact
/think <级别>设置思考（推理）深度级别，可选 off、low、medium、high 等/think high
/skills展示全部可用的 Skill/skills

切换模型

在当前会话切换模型（临时有效） 在终端输入 openclaw tui，进入 OpenClaw 终端命令行，使用 /model <模型名称> 在当前会话中切换模型： 
/model qwen3.6-plus
界面返回提示"model set to qwen3.6-plus"即表示生效。 切换默认模型（永久有效） 如需在每次新会话中使用指定模型，修改配置文件中的 agents.defaults.model.primary 字段为目标模型，然后重启网关： 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwencloud-token-plan/qwen3.6-plus"
      }
    }
  }
}

openclaw gateway restart
文本模型（如 qwen3.6-plus、glm-5 等）可直接使用。图像生成模型需通过自定义 Skill 接入，参见接入多模态生成模型。

常见问题

如何查看已配置的模型？ 在终端输入 openclaw tui，进入 OpenClaw 终端命令行，接着输入 /model 查看模型列表。按回车键选中模型，按 Esc 键退出模型列表。
报错 API rate limit reached 怎么办？ 请按以下顺序排查：
  1. OpenClaw 配置错误：若 Base URL 或模型提供商配置有误，导致请求未进入 Token Plan 团队版专属通道，而是被路由到通用 API 调用，从而触发限流。
    • 若使用 Token Plan 团队版套餐，请核对配置文件中的 models、agents、gateway（含嵌套字段），确保与文档配置一致。例如：模型服务提供商的结构为 { "models": { "providers": { "qwencloud-token-plan": {...} } } }。
    • 若当前未使用 Token Plan 团队版套餐，建议切换至 Token Plan 团队版以获取专属额度。
  2. 超出套餐限额：在 Token Plan 团队版页面查看套餐用量情况。
  3. 尝试重置 API Key：若完成上述排查后问题仍未解决，请前往 Token Plan 团队版页面重置 API Key。
报错"HTTP 401: Incorrect API key provided."或"No API key found for provider xxx"怎么办？ 可能原因：
  1. API Key 无效、过期、为空、格式错误，或与端点环境不匹配。请检查 API Key 是否为 Token Plan 团队版套餐专属 Key，复制完整且无空格；确认订阅状态有效。
  2. OpenClaw 的历史配置缓存导致配置错误。请删除 ~/.openclaw/agents/main/agent/models.json 文件中的 providers 配置项，并重启 OpenClaw。
报错 device identity required 怎么办？ 详细报错信息： 
http://127.0.0.1:18791/15:05:56 [ws] closed before connect conn=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx remote=127.0.0.1 fwd=n/a origin=n/a host=127.0.0.1:18789 ua=n/a code=1008 reason=device identity required
原因：客户端连接网关时未提供设备身份信息，通常由以下原因导致：
  • 首次打开浏览器访问地址，尚未完成设备配对。
  • 浏览器缓存被清除，设备密钥丢失。
  • 重装或升级 OpenClaw 后，~/.openclaw/identity/ 目录下的密钥文件缺失。
解决方法：在终端执行以下命令，允许当前设备连接并重新生成浏览器访问地址： 
openclaw devices approve --latest
openclaw dashboard --no-open
如果仍未解决，先清除异常的设备记录再重试： 
openclaw devices clear --pending --yes
openclaw dashboard --no-open
执行 openclaw devices list，确认设备显示在 Paired 列表中即为正常。

已有配置如何安全修改？

请勿直接全量覆盖配置文件。直接"全部替换"会覆盖掉自定义配置，请进行局部修改。
可以选择以下方式完成配置：
  • 若 OpenClaw 可正常对话：直接在 OpenClaw 对话中输入以下指令完成配置合并。
  • 若 OpenClaw 未配置模型或无法对话：参考上方"配置 Token Plan 团队版"章节完成首次配置。
在 OpenClaw 对话中输入以下指令（将 YOUR_API_KEY 替换为实际的 API Key）： 
请在 OpenClaw 中接入 Token Plan 团队版，步骤如下：
1. 打开配置文件：~/.openclaw/openclaw.json
2. 找到或创建以下字段，合并配置（保留原有配置不变，若字段不存在则新增）：
{
  "models": {
    "mode": "merge",
    "providers": {
      "qwencloud-token-plan": {
        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.6-plus",
            "name": "qwen3.6-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "compat": {
              "thinkingFormat": "qwen"
            }
          },
          {
            "id": "qwen3.6-flash",
            "name": "qwen3.6-flash",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "deepseek-v4-pro",
            "name": "deepseek-v4-pro",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "deepseek-v4-flash",
            "name": "deepseek-v4-flash",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "deepseek-v3.2",
            "name": "deepseek-v3.2",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "kimi-k2.6",
            "name": "kimi-k2.6",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "kimi-k2.5",
            "name": "kimi-k2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "glm-5.1",
            "name": "glm-5.1",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 202752,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "glm-5",
            "name": "glm-5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 202752,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "MiniMax-M2.5",
            "name": "MiniMax-M2.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 196608,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwencloud-token-plan/qwen3.6-plus"
      },
      "models": {
        "qwencloud-token-plan/qwen3.6-plus": {},
        "qwencloud-token-plan/qwen3.6-flash": {},
        "qwencloud-token-plan/deepseek-v4-pro": {},
        "qwencloud-token-plan/deepseek-v4-flash": {},
        "qwencloud-token-plan/deepseek-v3.2": {},
        "qwencloud-token-plan/kimi-k2.6": {},
        "qwencloud-token-plan/kimi-k2.5": {},
        "qwencloud-token-plan/glm-5.1": {},
        "qwencloud-token-plan/glm-5": {},
        "qwencloud-token-plan/MiniMax-M2.5": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}
3. 保存配置文件
4. 运行openclaw gateway restart，重启OpenClaw的网关，使配置生效。
配置完成后，新开一个 OpenClaw 会话，输入 openclaw models status 验证配置是否生效。重启网关后，已有会话可能无法正常对话，请重启会话。