没有找到相关章节
试试减少关键词，或清空搜索后浏览完整目录。
快速开始
FaroAI 推荐从一个可运行的本地网关开始，再逐步接入模型、微信通道和自动化规则。这样每一步都能被验证，出问题时也容易定位。
确认 OpenClaw CLI 可用
先确认命令行能正常运行，并记录当前版本。后续所有配置、诊断和重启都通过 CLI 完成。
openclaw --version
openclaw doctor启动 Gateway
Gateway 是 FaroAI 的本地中枢，负责连接模型、通道和任务调用。
openclaw gateway install
openclaw gateway restart
openclaw gateway status验证模型调用
不要一上来接复杂通道，先确认 Gateway 能调用 AI 模型。
openclaw capability model run --gateway \
--model ollama/qwen3.8:27b-q8_0 \
--prompt "请只回复 OK。" --json安装与升级
通过 npm 安装时，先查询发布通道，确认要使用稳定版还是预发布版；页面里的历史版本不作为今天的安装目标。升级前备份配置，升级后运行诊断、重启 Gateway，并重新验证微信与本地模型链路。
npm view openclaw dist-tags
openclaw --version全局安装
适合个人电脑、Mac Studio、本地开发机。安装后 CLI 会在终端中可用。
npm install -g openclaw@latest
openclaw --version升级现有环境
已有安装时使用内置更新命令，它会根据当前安装方式执行更新。
openclaw update --yes
openclaw doctor --fix --yes --non-interactive
openclaw gateway restart提示：不同版本的命令参数可能略有变化。遇到参数不识别时，先运行 openclaw <command> --help 查看当前版本支持的选项。
网关 Gateway
Gateway 是 FaroAI 的运行核心。你可以把它理解为一个本地 AI 总线：微信机器人、网页、CLI、模型 provider、工具调用都会经过这里协调。
常用健康检查
检查服务是否加载、端口是否监听、是否具备管理能力。
openclaw gateway status
openclaw channels status --probe
openclaw health本地默认端口
常见本地配置为 loopback 绑定，端口 18789。仅本机访问更适合个人使用和本地模型。
ws://127.0.0.1:18789
http://127.0.0.1:18789/微信机器人接入
微信通道让 FaroAI 进入你的日常聊天入口。接入后，你可以通过微信触发总结、搜索、长文整理、日程辅助和自动化任务。
安装微信插件
当前 FaroAI 使用 OpenClaw 插件机制加载微信通道。
openclaw plugins install @tencent-weixin/openclaw-weixin --force
openclaw plugins inspect openclaw-weixin --runtime --json确认通道运行
状态中应看到 openclaw-weixin 为 enabled、configured、running。
openclaw gateway restart
openclaw channels status --probe设置默认模型
微信通道可以走默认 agent 模型，也可以按消息规则路由到不同模型。
openclaw models list
openclaw agents list模型配置
FaroAI 支持本地优先的模型策略。简单问题可以走快速模型，复杂分析、长文写作和代码任务可以路由到更强模型。
Ollama 本地模型
适合隐私敏感、成本可控、需要长期运行的个人 AI 工作台。
ollama list
openclaw models list模型调用测试
每次改模型配置后，用一次最小测试确认链路可用。
openclaw capability model run --gateway \
--prompt "用一句话说明当前模型可用。" --json本地模型耗时排查
首次响应慢时，先区分模型加载、输入处理和输出生成。确认是哪一段耗时，再调整模型驻留或输入长度；单次请求慢不等于模型不可用。
先看模型是否驻留
ollama list 查看已安装模型；ollama ps 查看已加载模型及 CPU/GPU 分配。已下载并不等于正在内存中运行。
ollama list
ollama ps对照请求耗时
Generate API 的 load_duration 对应加载，prompt_eval_duration 对应未命中缓存的输入处理，eval_duration 对应输出生成，单位均为纳秒。比较时保持模型、输入和输出限制一致。
连续请求可按可用内存设置 keep_alive；延长驻留会占用内存，不保证所有任务加速。
资料核对：2026-09-20。依据 Ollama FAQ 与 Generate API；本节是排查方法，不是本机性能测试结果。
知识库与记忆
知识库适合放长期稳定资料，例如项目文档、个人简历、产品说明、客户材料和常用 SOP。记忆则适合保存偏好、上下文和长期协作线索。
适合放入知识库的内容
产品介绍、常见问答、流程文档、技术规范、项目背景、合同模板、邮件模板。
不建议放入知识库的内容
明文密码、长期有效 token、银行卡信息、身份证件、一次性验证码和未经授权的他人隐私数据。
自动化任务流
当一个任务反复出现，就可以把它从聊天指令沉淀成任务流。FaroAI 的目标是让 AI 不只是回答，还能持续执行、跟进和复盘。
新闻与资料摘要
微信发起主题，FaroAI 搜索资料、抽取重点、生成摘要，并按固定格式回复。
技术排障助手
收集日志、识别错误、给出下一步命令，并把操作过程整理成复盘。
内容创作流水线
输入主题后生成提纲、初稿、标题、摘要和发布检查清单。
个人知识助理
围绕你的知识库进行问答、补充背景、生成学习计划和行动项。
故障排查
优先按“网关是否在线 - 插件是否加载 - 通道是否运行 - 模型是否可调用”的顺序排查。不要直接改复杂配置，先用最小命令确认是哪一段链路失败。
Gateway 显示 not reachable 怎么办？
先运行 openclaw gateway status，如果服务未运行，执行 openclaw gateway restart。如果端口被占用，可查看 status 输出中的进程信息。
微信插件显示 unknown channel id 怎么办？
通常是插件未安装成功或有旧配置残留。重新安装插件后运行 openclaw plugins registry --refresh，再重启 Gateway。
模型调用慢或失败怎么办？
先用最小 prompt 测试模型。如果本地模型很大，确认 Ollama 已加载、机器资源足够，并适当增加 timeout。
页面登录需要怎样配置？
Google/GitHub OAuth 后端已接入 Cloudflare Worker。正式可用前，需要在第三方控制台配置回调地址，并在 Worker 的变量与密钥中设置 GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET、GITHUB_CLIENT_ID、GITHUB_CLIENT_SECRET、OAUTH_COOKIE_SECRET。如果线上点击后提示 missing_env，说明密钥还未配置完整。
网站发布与缓存
FaroAI 静态页面通过 GitHub Pages 发布，Cloudflare 位于域名前层并承接部分 API 路由。更新后按下列顺序检查，避免把推送成功当成页面已经生效。
核对正式页面与交互
部署成功后，打开正式域名核对本次新增内容，并操作搜索、目录和手机菜单。页面返回 200 只能证明请求成功，不能证明功能正常。
排除浏览器和 CDN 缓存
先用禁用缓存的浏览器检查；源站已更新而 CDN 仍旧时，再按受影响 URL 清除缓存。若地址返回 301 或 302，跳转响应与最终目标页面应分别核对；自定义缓存键需按 Cloudflare 文档处理。
资料核对：2026-09-20。依据 GitHub 部署历史 与 Cloudflare 按 URL 清除缓存。正式域名交互检查是本站采用的维护步骤。
还需要帮你配置？
如果你希望直接接入微信机器人、本地模型和自动化规则，可以联系站长一起把链路跑通。