1. 为什么你需要一个常驻 AI 助手而不是又一个聊天窗口OpenClaw 是一个免费开源的 AI 智能体平台核心运行在你自己的设备上能实现持续记忆与主动行动。它和普通 AI 聊天工具最大的区别在于关掉页面后它不会失忆也不需要你每次重新交代背景。它通过网关架构接收你在日常通讯工具里发出的指令调度大模型完成理解与处理再落地执行具体任务。整个过程数据留在本地隐私可控。适合谁个人开发者、想搭长期在线智能体的人、手里有闲置小主机或云服务器的人。你不需要会写复杂代码但要能改配置文件、会复制命令、能看懂报错。我这次要落地的是用 TaoToken 统一 Key 接入 ClawHub 网关架构让 OpenClaw 从零到常驻运行。下面给出 config.toml 与 settings.json 可复制骨架、CC Switch 切换步骤、连通性验证和常见报错排查。整套流程实测下来从拿 Key 到跑通第一条消息大约 20 分钟。2. TaoToken 前置准备统一 Key 与 API 通道TaoToken 在这里的角色是统一模型入口。OpenClaw 的网关需要调用大模型你可以把它理解成给智能体装一个模型插座不管底层换哪个模型网关只认这一个 Key 和 API 地址。先注册并登录控制台地址是 https://taotoken.net/api 进入后找到 API Keys 页面创建一个新 Key。建议命名带用途比如openclaw-gateway方便以后多项目区分。创建后立刻复制保存页面刷新后不再完整显示。拿到 Key 后你需要确认两件事一是 API 基础地址二是准备用哪个模型。TaoToken 的 API 通道兼容常见调用格式OpenClaw 网关配置里填 base_url 和 api_key 即可。如果你还没想好用哪个模型可以先去模型对话页面试几条确认响应正常再写进配置。注意Key 属于敏感凭证不要提交到 Git 仓库也不要贴进公开的 config 示例里。建议用环境变量或本地.env文件承载。对于长期编码或 Agent 场景如果你打算让 OpenClaw 持续跑任务、频繁调用模型可以了解 Coding Plan 方案按长期使用来规划额度比零散调用更省心。入口在控制台的 Coding Plan 页面。3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的网关配置分两层config.toml管网关与模型通道settings.json管智能体行为与技能加载。下面骨架可以直接复制后改字段。先建目录建议放在用户主目录下统一管理mkdir -p ~/openclaw/{config,data,logs} cd ~/openclawconfig.toml骨架[gateway] host 127.0.0.1 port 8787 data_dir ./data log_dir ./logs # 常驻运行建议开启自动重启 auto_restart true [model] provider taotoken base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model_name your-model-name timeout_seconds 60 max_retries 3 [clawhub] enabled true registry https://clawhub.openclaw.dev auto_update_skills false skill_dir ./data/skills [memory] persist true store_path ./data/memory max_context_tokens 32000settings.json骨架{ agent: { name: resident-assistant, language: zh-CN, persona: 简洁、主动、先确认再执行, proactive: true }, channels: { telegram: { enabled: true, bot_token: ${TELEGRAM_BOT_TOKEN} } }, skills: { enabled: [web-search, file-ops, scheduler], disabled: [] }, safety: { confirm_before_write: true, allowed_paths: [~/openclaw/data] } }把 Key 写进环境变量避免明文落盘export TAOTOKEN_API_KEY你的Key export TELEGRAM_BOT_TOKEN你的BotToken如果你用 systemd 常驻把这两行放进 service 的Environment里。改完配置后先做语法检查再启动网关。4. CC Switch 切换与连通性验证CC Switch 用来在多个模型通道之间切换比如你同时配了 TaoToken 和备用通道可以一键切。它的配置文件通常和config.toml同级叫cc-switch.toml[[profiles]] name taotoken-main provider taotoken base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY model_name your-model-name [[profiles]] name backup provider taotoken base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY_BACKUP model_name your-backup-model切换命令cc-switch use taotoken-main cc-switch listlist会显示当前激活的 profile确认taotoken-main前面有星号即可。接下来验证连通性。先单独测模型通道再测网关整体curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY | head -c 300返回模型列表说明 Key 和网络都通。然后启动网关cd ~/openclaw openclaw gateway --config ./config.toml看到gateway listening on 127.0.0.1:8787就是起来了。再发一条本地测试请求curl -s http://127.0.0.1:8787/health curl -s -X POST http://127.0.0.1:8787/message \ -H Content-Type: application/json \ -d {text:现在几点帮我记一条待办}成功结果应该是/health返回{status:ok}/message返回智能体的回复文本并且./data/memory下出现新的记忆文件。到这一步常驻助手的闭环就跑通了。5. 本篇常见报错排查报错一401 Unauthorized。九成是 Key 没读到。检查环境变量是否在当前 shell 生效echo $TAOTOKEN_API_KEY。如果是 systemd 启动环境变量要写在 service 文件里不是.bashrc。报错二connection refused 127.0.0.1:8787。网关没起来或端口被占。先lsof -i :8787看占用再改config.toml里的 port。也可能是启动时配置解析失败看./logs下最新日志。报错三model not found。model_name写错了。用第 4 节的 models 接口列出可用模型名复制准确字段填回去。报错四ClawHub 技能加载失败。检查registry是否可达skill_dir是否有写权限。如果不需要自动更新把auto_update_skills保持 false手动装技能更稳。报错五记忆文件不生成。memory.persist是否为 truestore_path目录是否存在。权限问题最常见chmod -R 755 ./data后重启。报错六CC Switch 切换后不生效。切换后要重启网关进程配置是启动时读取的。cc-switch list确认激活项再openclaw gateway --config ./config.toml重启。提示排障时优先看日志tail -f ./logs/gateway.log比猜快得多。6. 把常驻助手真正用起来配置跑通只是起点。要让 OpenClaw 成为常驻助手关键是让它持续在线并主动做事。用 systemd 托管网关开机自启、崩溃自拉[Unit] DescriptionOpenClaw Gateway Afternetwork.target [Service] ExecStart/usr/local/bin/openclaw gateway --config /home/you/openclaw/config.toml EnvironmentTAOTOKEN_API_KEY你的Key Restartalways RestartSec5 [Install] WantedBymulti-user.targetsystemctl enable --now openclaw之后它就一直在后台。接着在settings.json的skills.enabled里加上scheduler你就能让它定时提醒、定时抓取、定时整理。记忆目录会越用越厚助手对你的了解也越具体。如果你准备长期跑编码类或 Agent 类任务建议把模型通道规划好用 Coding Plan 承载高频调用避免临时额度不够打断任务。接入细节和更多配置项可以查接入文档模型效果想先试就去模型对话Key 管理在 API Keys 页面。整套下来你手里就有了一台真正属于自己的、能长期在线的 AI 常驻助手。