1. 为什么 OpenClaw 的 CLI 命令总让人记不住OpenClaw 是一个把 Agent、Session、Memory、Skills、Plugins、MCP、Browser、Cron、Gateway、Channel、Node、Sandbox 全部塞进一套运行时的本地 AI Agent 基础设施。它对外暴露的入口只有一个词openclaw。但真正用起来你会发现这个入口下面挂着上百个子命令覆盖配置、Agent 编排、多 Agent 管理、模型切换、消息收发、浏览器控制、Skill 加载、插件系统、MCP、定时任务、设备、节点、沙箱等模块。很多人第一次接触 OpenClaw以为它就是个能接 Telegram 的 AI 助手直到敲下openclaw --help看到那一屏命令树才意识到自己面对的是一个 Agent 操作系统。问题也正出在这里。OpenClaw 更新速度快插件还能动态注册新的 CLI 顶级命令所以不同用户装出来的命令列表可能并不完全一致。官方明确建议把openclaw command --help当作当前安装版本最权威的命令参考。这意味着你没法靠一篇静态文档吃一辈子必须掌握一套可复制的命令清单和配置模板再配合--help现场确认。这篇内容面向本地已经装好 OpenClaw 的开发者目标是把安装、Agent、模型、Skill、Browser 五大模块的命令串成一条可跟做的链路同时把 TaoToken 统一 Key 在模型配置里的填写位置讲清楚。TaoToken 是一个统一模型接入层官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。它的作用是让你用一套 Key 和 Base URL 去调用多家模型省掉在 OpenClaw 里逐个 Provider 配 Key 的麻烦。下面所有命令都按「可复制、可验证」的标准来写每条命令后面我会说明预期返回什么方便你判断是否真的跑通了。2. 安装与初始化openclaw setup 与 onboard 命令速查OpenClaw 的安装和初始化是整条链路的地基。核心命令有三个openclaw setup、openclaw onboard、openclaw configure。它们的分工不一样用错了会浪费时间。openclaw setup是当前非常重要的入口。在新环境里运行openclaw setup会进入初始化流程。如果已经配置过 OpenClaw它还可以作为 system-agent 入口使用。只想初始化基础目录的话openclaw setup --baseline官方当前的 setup 实际上同时承担了初始化和 Agent 入口的一部分功能。openclaw onboard是完整的新手引导。传统完整 Wizardopenclaw onboard --classic快速模式openclaw onboard --flow quickstart高级模式openclaw onboard --flow advanced自动化环境还可以用非交互方式openclaw onboard \ --non-interactive \ --accept-risk这个模式适合服务器、Docker、CI/CD 环境不需要人工点选。openclaw configure用于已经安装完成、只想修改部分配置的场景。它主要用来重新配置 credentials、devices、agent defaults、gateway、channels、plugins、skills、health checks。也就是说openclaw onboard更适合第一次安装openclaw configure更适合后期维护。配置管理命令同样重要openclaw config get agents.defaults.model openclaw config set agents.defaults.model.primary openai/gpt-5.6-sol openclaw config unset agents.defaults.model.primary openclaw config validate openclaw config fileopenclaw config get读取配置set修改unset删除validate校验file查看配置文件路径。改完配置后建议跑一次openclaw config validate避免格式错误导致 Gateway 起不来。初始化完成后用openclaw status查看整体状态用openclaw doctor做一键体检。openclaw doctor类似系统体检工具会检查配置、环境、迁移、依赖等问题升级版本之后也建议执行一次。遇到问题时的四件套是openclaw status openclaw health openclaw doctor openclaw logsopenclaw status --usage还能查看模型 API 使用额度OpenClaw 会在 Provider 支持的情况下读取使用量和剩余额度并统一展示。如果你不喜欢一直用命令行openclaw dashboard可以打开 Dashboard / Control UI查看 Session、Agent、Channel、Gateway、Model、Usage 等信息。3. TaoToken 统一 Key 接入模型配置模板与填写位置这一节是整篇的核心配置部分。OpenClaw 的模型体系围绕openclaw models展开模型 ID 基本采用provider/model形式。要让 OpenClaw 通过 TaoToken 统一 Key 调用模型你需要把 Base URL、Key、Model ID 三件套填到正确的位置。先看模型相关命令的全貌openclaw models list openclaw models status openclaw models set openclaw models set-image openclaw models scan openclaw models aliases openclaw models fallbacks openclaw models image-fallbacks openclaw models auth查看模型openclaw models list openclaw models list --all openclaw models status直接敲openclaw models默认等价于openclaw models status。切换默认模型openclaw models set openai/gpt-5.6-sol openclaw models set anthropic/claude-sonnet-4-6设置图片模型openclaw models set-image openai/gpt-image-2模型别名openclaw models aliases list openclaw models aliases add openclaw models aliases remove模型 Fallbackopenclaw models fallbacks list openclaw models fallbacks add openclaw models fallbacks remove openclaw models fallbacks clear图片模型 Fallback 类似openclaw models image-fallbacks list openclaw models image-fallbacks add openclaw models image-fallbacks remove openclaw models image-fallbacks clear模型登录与 API Key 管理openclaw models auth list openclaw models auth add openclaw models auth login openclaw models auth setup-token openclaw models auth paste-token openclaw models auth paste-api-key openclaw models auth login-github-copilotAuth 顺序openclaw models auth order get openclaw models auth order set openclaw models auth order clear模型扫描openclaw models scanOpenClaw 可以扫描部分 Provider 的模型 Catalog当前官方特别支持扫描 OpenRouter 免费模型并可以测试 Tool / Image 能力。现在讲 TaoToken 的填写位置。OpenClaw 的 Provider 配置通常写在配置文件里你可以先用openclaw config file找到配置文件路径。一个可复制的 Provider 配置片段JSON 形式路径以你本机openclaw config file输出为准如下{ providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken统一Key, models: [ openai/gpt-5.6-sol, anthropic/claude-sonnet-4-6, google/gemini-3.1-pro-preview ] } }, agents: { defaults: { model: { primary: taotoken/openai/gpt-5.6-sol, fallbacks: [ taotoken/anthropic/claude-sonnet-4-6, taotoken/google/gemini-3.1-pro-preview ] } } } }如果你更习惯用 TOML等价片段如下[providers.taotoken] baseUrl https://taotoken.net/api apiKey sk-你的TaoToken统一Key models [ openai/gpt-5.6-sol, anthropic/claude-sonnet-4-6, google/gemini-3.1-pro-preview, ] [agents.defaults.model] primary taotoken/openai/gpt-5.6-sol fallbacks [ taotoken/anthropic/claude-sonnet-4-6, taotoken/google/gemini-3.1-pro-preview, ]三件套对应关系要记牢Base URL 填https://taotoken.net/apiKey 填你的 TaoToken 统一 KeyModel ID 填taotoken/前缀加具体模型名。填完之后用openclaw config validate校验再用openclaw models status确认模型已加载。如果你用的是 Claude Code 或 Codex 这类外部工具TaoToken 的接入文档在 https://taotoken.net/doc API Key 在 https://taotoken.net/api-keys 管理模型对话入口在 https://taotoken.net/chat 。4. Agent、Skill 与 Browser命令验证与成功结果Agent 是 OpenClaw 最核心的命令之一。注意openclaw agent和openclaw agents不是一个意思前者是执行 Agent后者是管理 Agent。执行一次 Agent 任务openclaw agent \ --agent main \ --message 帮我分析这个项目普通openclaw agent默认通过 Gateway 执行 Agent turn如果使用明确的--local则走内嵌本地执行路径。openclaw agent exec更适合自动化openclaw agent exec 检查当前项目并修复测试失败 openclaw agent exec 检查代码 --cwd ./repo cat task.md | openclaw agent exec --message-file - --json指定模型和 Fallbackopenclaw agent exec \ 实现这个功能 \ --model taotoken/openai/gpt-5.6-sol \ --fallback taotoken/anthropic/claude-sonnet-4-6 \ --fallback taotoken/google/gemini-3.1-pro-preview这个模式尤其适合 CI/CD、GitHub Actions、自动写代码、自动测试、自动修 Bug、脚本调用 Agent。官方当前也明确把agent exec推荐为 Headless / CI / Coding Automation 入口之一。管理多个 Agentopenclaw agents list openclaw agents list --bindings openclaw agents list --json openclaw agents add work --workspace ~/.openclaw/workspace-work openclaw agents add coding --workspace ~/.openclaw/workspace-coding --model taotoken/openai/gpt-5.6-sol openclaw agents bind --agent work --bind telegram:ops openclaw agents bind --agent work --bind telegram:* --bind discord:* openclaw agents unbind --agent work --bind telegram:ops openclaw agents unbind --agent work --all openclaw agents set-identity --agent main --name JavaPub AI --emoji openclaw agents delete work --force验证动作运行openclaw agents list预期返回一个表格列出每个 Agent 的名称、Workspace、模型配置和绑定关系。如果返回空列表说明还没创建 Agent用openclaw agents add补一个。Skill 是 OpenClaw 的能力扩展生态openclaw skills search openclaw skills install openclaw skills update openclaw skills verify openclaw skills list openclaw skills info openclaw skills checkSkill Workshopopenclaw skills workshop list openclaw skills workshop inspect openclaw skills workshop propose-create openclaw skills workshop propose-update openclaw skills workshop revise openclaw skills workshop apply openclaw skills workshop reject openclaw skills workshop quarantine验证动作运行openclaw skills list预期返回已安装 Skill 的清单。如果为空先openclaw skills search找一个再openclaw skills install。Browser 命令控制浏览器openclaw browser status openclaw browser start openclaw browser stop openclaw browser profiles openclaw browser create-profile openclaw browser delete-profile openclaw browser reset-profile openclaw browser tabs openclaw browser open openclaw browser focus openclaw browser close openclaw browser navigate openclaw browser screenshot openclaw browser snapshot openclaw browser click openclaw browser type openclaw browser press openclaw browser hover openclaw browser drag openclaw browser select openclaw browser upload openclaw browser fill openclaw browser dialog openclaw browser wait openclaw browser evaluate openclaw browser console openclaw browser resize openclaw browser pdf验证动作运行openclaw browser status预期返回浏览器运行状态、Profile 信息和当前 Tab 数量。如果显示未启动先openclaw browser start。Browser 实际上已经可以理解成一套 AI Agent 浏览器自动化接口。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来对照。OpenClaw 接入 TaoToken 统一 Key 时最容易踩的坑集中在认证、代理、响应解析和 OAuth 四类。401 Unauthorized。这是最常见的认证失败。原因通常是 Key 填错、Key 过期、或者 Base URL 写成了带 UTM 的官网地址而不是 API 地址。检查你的配置里baseUrl是不是https://taotoken.net/api注意不要写成官网首页。Key 要去 https://taotoken.net/api-keys 重新确认。改完配置后跑openclaw config validate openclaw models status如果models status里对应 Provider 显示未认证用openclaw models auth list看认证状态必要时openclaw models auth paste-api-key重新粘贴。local proxy failed。这个报错通常出现在 Gateway 或本地代理层。先跑openclaw gateway status看 Gateway 是否在运行再跑openclaw gateway health和openclaw gateway diagnostics。如果是 Gateway 没起来openclaw gateway start或openclaw gateway restart。如果 Gateway 正常但代理失败检查openclaw proxy coverage和openclaw proxy sessions确认代理覆盖范围。注意不要配置任何违规的网络代理工具OpenClaw 的 proxy 命令指的是它自身的请求代理层不是外部网络工具。reading choices 报错。这类错误通常出现在模型返回体解析阶段说明返回的 JSON 结构里没有预期的choices字段。常见原因是 Base URL 指向了一个不兼容 OpenAI 响应格式的端点或者模型 ID 写错导致请求被路由到了错误的服务。检查 Model ID 是否带了taotoken/前缀检查baseUrl是否是https://taotoken.net/api。用openclaw models list确认模型已正确加载再用openclaw infer model run单独测试一次模型调用openclaw infer model run openclaw infer model list openclaw infer model inspect openclaw infer model providersOAuth 相关报错。OpenClaw 支持openclaw models auth login、openclaw models auth login-github-copilot等 OAuth 流程。如果 OAuth 回调失败先确认本地端口没有被占用再检查openclaw models auth order get的认证顺序。如果你用的是 TaoToken 统一 Key通常不需要走 OAuth直接用openclaw models auth paste-api-key粘贴 Key 即可。OAuth 顺序可以用openclaw models auth order set openclaw models auth order clear调整。如果同时配了多个认证源认证顺序会影响实际使用的 Key。排查通用四件套再强调一次openclaw status openclaw health openclaw doctor openclaw logsopenclaw logs在排查时非常关键报错堆栈基本都在里面。openclaw doctor会检查配置、环境、迁移、依赖等问题升级版本之后也建议执行一次。如果涉及 Secret 管理用openclaw secrets reload openclaw secrets audit openclaw secrets configure openclaw secrets applyOpenAI API Key、Claude Key、Telegram Token、Database Password 这些都不应该随便硬编码进配置走openclaw secrets管理更稳妥。6. 从命令清单到长期编码把 OpenClaw 用成 Agent 运行时把上面五节串起来OpenClaw 的命令体系其实可以压缩成一条主线setup初始化configure维护配置models接模型agents管 Agentagent exec跑自动化skills扩能力browser控浏览器gateway保运行doctor做体检。日常使用其实重点掌握 20% 的命令就足够我建议先记这 20 条openclaw --help openclaw --version openclaw setup openclaw onboard openclaw configure openclaw status openclaw doctor openclaw logs openclaw gateway status openclaw gateway start openclaw gateway restart openclaw agent openclaw agent exec 帮我检查当前项目 openclaw agents list openclaw models list openclaw models set taotoken/openai/gpt-5.6-sol openclaw skills list openclaw plugins list openclaw browser status openclaw cron list这 20 条熟悉了日常玩 OpenClaw 基本没有太大问题。如果你要长期做编码和 Agent 自动化建议把openclaw agent exec和 TaoToken 的 Coding Plan 结合起来用。Coding Plan 入口在 https://taotoken.net/coding-plan 适合需要长期跑 Agent 任务的场景。模型对话验证入口在 https://taotoken.net/chat 接入文档在 https://taotoken.net/doc API Key 管理在 https://taotoken.net/api-keys 。最后说一个我踩过的坑OpenClaw 的插件可以动态注册新的 CLI 顶级命令所以你在网上看到的命令列表和你本机openclaw --help输出的可能不一致。永远以本机openclaw command --help为准。另外openclaw message send的主参数在较新版本里已经从--to调整为--target复制老教程命令时要注意版本差异。把这些细节处理好OpenClaw 这套 CLI 就能真正变成你本地 Agent 运行时的稳定入口。