如果误操作修改了配置启动不了,可尝试还原默认配置
配置存储位置:
~/.openclaw/openclaw.json
WSL:
/root/.openclaw/openclaw.json
该文件定义了代理的工作空间、通信网关、安全凭证等关键参数。初始化过程可通过 openclaw setup 命令进行交互式配置。
如何编辑配置文件?
1)通过命令行修改
通过命令行修改配置
openclaw config get agents.defaults.workspace openclaw config set agents.defaults.heartbeat.every “2h” openclaw config unset tools.web.search.apiKey
GPT plus 代充 只需 145
2)直接修改文件
Vim /.openclaw/openclaw.json
讯享网 { // 环境变量 + Shell env: { OPENROUTER_API_KEY: “sk-or-…”, vars: { GROQ_API_KEY: “gsk-…” }, shellEnv: { enabled: true, timeoutMs: 15000 } }, // 认证配置文件元数据(密钥存储在 auth-profiles.json 中) auth: { profiles: { “anthropic:”: { provider: “anthropic”, mode: “oauth”, email: “” }, “anthropic:work”: { provider: “anthropic”, mode: “api_key” }, “openai:default”: { provider: “openai”, mode: “api_key” }, “openai-codex:default”: { provider: “openai-codex”, mode: “oauth” } }, order: { anthropic: [“anthropic:”, “anthropic:work”], openai: [“openai:default”], “openai-codex”: [“openai-codex:default”] } }, // 身份标识 identity: { name: “Samantha”, theme: “helpful sloth”, emoji: “🦥” }, // 日志记录 logging: { level: “info”, file: “/tmp/openclaw-cn/openclaw-cn.log”, consoleLevel: “info”, consoleStyle: “pretty”, redactSensitive: “tools” }, // 消息格式化 messages: { messagePrefix: “[openclaw-cn]”, responsePrefix: “>”, ackReaction: “👀”, ackReactionScope: “group-mentions” }, // 路由 + 队列 routing: { groupChat: { mentionPatterns: [“@clawd”, “openclaw-cn”], historyLimit: 50 }, queue: { mode: “collect”, debounceMs: 1000, cap: 20, drop: “summarize”, byChannel: { whatsapp: “collect”, telegram: “collect”, discord: “collect”, slack: “collect”, signal: “collect”, imessage: “collect”, webchat: “collect” } } }, // 工具配置 tools: { media: { audio: { enabled: true, maxBytes: , models: [ { provider: “openai”, model: “gpt-4o-mini-transcribe” }, // 可选的 CLI 备用方案(Whisper 二进制文件): // { type: “cli”, command: “whisper”, args: [“–model”, “base”, “{{MediaPath}}”] } ], timeoutSeconds: 120 }, video: { enabled: true, maxBytes: , models: [{ provider: “google”, model: “gemini-3-flash-preview” }] } } }, // 会话行为 session: { scope: “per-sender”, reset: { mode: “daily”, atHour: 4, idleMinutes: 60 }, resetByChannel: { discord: { mode: “idle”, idleMinutes: 10080 } }, resetTriggers: [“/new”, “/reset”], store: “/.openclaw/agents/default/sessions/sessions.json”, typingIntervalSeconds: 5, sendPolicy: { default: “allow”, rules: [ { action: “deny”, match: { channel: “discord”, chatType: “group” } } ] } }, // 渠道配置 channels: { whatsapp: { dmPolicy: “pairing”, allowFrom: [“+”], groupPolicy: “allowlist”, groupAllowFrom: [“+”], groups: { “”: { requireMention: true } } }, telegram: { enabled: true, botToken: “YOUR_TELEGRAM_BOT_TOKEN”, allowFrom: [“”], groupPolicy: “allowlist”, groupAllowFrom: [“”], groups: { “”: { requireMention: true } } }, discord: { enabled: true, token: “YOUR_DISCORD_BOT_TOKEN”, dm: { enabled: true, allowFrom: [“steipete”] }, guilds: { “”: { slug: “friends-of-clawd”, requireMention: false, channels: { general: { allow: true }, help: { allow: true, requireMention: true } } } } }, slack: { enabled: true, botToken: “xoxb-REPLACE_ME”, appToken: “xapp-REPLACE_ME”, channels: { “#general”: { allow: true, requireMention: true } }, dm: { enabled: true, allowFrom: [“U123”] }, slashCommand: { enabled: true, name: “clawd”, sessionPrefix: “slack:slash”, ephemeral: true } } }, // Agent 运行时 agents: { defaults: { workspace: “/clawd”, userTimezone: “America/Chicago”, model: { primary: “anthropic/claude-sonnet-4-5”, fallbacks: [“anthropic/claude-opus-4-5”, “openai/gpt-5.2”] }, imageModel: { primary: “openrouter/anthropic/claude-sonnet-4-5” }, models: { “anthropic/claude-opus-4-5”: { alias: “opus” }, “anthropic/claude-sonnet-4-5”: { alias: “sonnet” }, “openai/gpt-5.2”: { alias: “gpt” } }, thinkingDefault: “low”, verboseDefault: “off”, elevatedDefault: “on”, blockStreamingDefault: “off”, blockStreamingBreak: “text_end”, blockStreamingChunk: { minChars: 800, maxChars: 1200, breakPreference: “paragraph” }, blockStreamingCoalesce: { idleMs: 1000 }, humanDelay: { mode: “natural” }, timeoutSeconds: 600, mediaMaxMb: 5, typingIntervalSeconds: 5, maxConcurrent: 3, heartbeat: { every: “30m”, model: “anthropic/claude-sonnet-4-5”, target: “last”, to: “+”, prompt: “HEARTBEAT”, ackMaxChars: 300 }, memorySearch: { provider: “gemini”, model: “gemini-embedding-001”, remote: { apiKey: “${GEMINI_API_KEY}” } }, sandbox: { mode: “non-main”, perSession: true, workspaceRoot: “/.openclaw/sandboxes”, docker: { image: “clawdbot-sandbox:bookworm-slim”, workdir: “/workspace”, readOnlyRoot: true, tmpfs: [“/tmp”, “/var/tmp”, “/run”], network: “none”, user: “1000:1000” }, browser: { enabled: false } } } }, tools: { allow: [“exec”, “process”, “read”, “write”, “edit”, “apply_patch”], deny: [“browser”, “canvas”], exec: { backgroundMs: 10000, timeoutSec: 1800, cleanupMs: }, elevated: { enabled: true, allowFrom: { whatsapp: [“+”], telegram: [“”], discord: [“steipete”], slack: [“U123”], signal: [“+”], imessage: [“”], webchat: [“session:demo”] } } }, // 自定义模型提供商 models: { mode: “merge”, providers: { “custom-proxy”: { baseUrl: “http://localhost:4000/v1", apiKey: ”LITELLM_KEY“, api: ”openai-responses“, authHeader: true, headers: { ”X-Proxy-Region“: ”us-west“ }, models: [ { id: ”llama-3.1-8b“, name: ”Llama 3.1 8B“, api: ”openai-responses“, reasoning: false, input: [”text“], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: , maxTokens: 32000 } ] } } }, // 定时任务 cron: { enabled: true, store: ”/.openclaw/cron/cron.json“, maxConcurrentRuns: 2 }, // Webhooks hooks: { enabled: true, path: ”/hooks“, token: ”shared-secret“, presets: [”gmail“], transformsDir: ”/.openclaw/hooks/transforms“, mappings: [ { id: ”gmail-hook“, match: { path: ”gmail“ }, action: ”agent“, wakeMode: ”now“, name: ”Gmail“, sessionKey: ”hook:gmail:{{messages[0].id}}“, messageTemplate: ”From: {{messages[0].from}}\nSubject: {{messages[0].subject}}“, textTemplate: ”{{messages[0].snippet}}“, deliver: true, channel: ”last“, to: ”+“, thinking: ”low“, timeoutSeconds: 300, transform: { module: ”gmail.js“, export: ”transformGmail“, }, }, ], gmail: { account: ”“, label: ”INBOX“, topic: ”projects/<project-id>/topics/gog-gmail-watch“, subscription: ”gog-gmail-watch-push“, pushToken: ”shared-push-token“, hookUrl: ”http://127.0.0.1:18789/hooks/gmail", includeBody: true, maxBytes: 20000, renewEveryMinutes: 720, serve: { bind: “127.0.0.1”, port: 8788, path: “/” }, tailscale: { mode: “funnel”, path: “/gmail-pubsub” } } }, // 网关 + 网络 gateway: { mode: “local”, port: 18789, bind: “loopback”, controlUi: { enabled: true, basePath: “/openclaw-cn” }, auth: { mode: “token”, token: “gateway-token”, allowTailscale: true }, tailscale: { mode: “serve”, resetOnExit: false }, remote: { url: “ws://gateway.tailnet:18789”, token: “remote-token” }, reload: { mode: “hybrid”, debounceMs: 300 } }, skills: { allowBundled: [“gemini”, “peekaboo”], load: { extraDirs: [“/Projects/agent-scripts/skills”] }, install: { preferBrew: true, nodeManager: “npm” }, entries: { “nano-banana-pro”: { enabled: true, apiKey: “GEMINI_KEY_HERE”, env: { GEMINI_API_KEY: “GEMINI_KEY_HERE” } }, peekaboo: { enabled: true } } } }
{ agent: { workspace: “/clawd” }, channels: {
讯享网 whatsapp: { allowFrom: ["+"] }, telegram: { enabled: true, botToken: "YOUR_TOKEN", allowFrom: [""] }, discord: { enabled: true, token: "YOUR_TOKEN", dm: { allowFrom: ["yourname"] } }
} }
{ auth: {
讯享网 profiles: { "anthropic:subscription": { provider: "anthropic", mode: "oauth", email: "" }, "anthropic:api": { provider: "anthropic", mode: "api_key" } }, order: { anthropic: ["anthropic:subscription", "anthropic:api"] }
}, agent: {
workspace: "~/clawd", model: { primary: "anthropic/claude-sonnet-4-5", fallbacks: ["anthropic/claude-opus-4-5"] }
} }
讯享网 { agent: {
workspace: "~/clawd", model: { primary: "lmstudio/minimax-m2.1-gs32" }
}, models: {
讯享网 mode: "merge", providers: { lmstudio: { baseUrl: "http://127.0.0.1:1234/v1", apiKey: "lmstudio", api: "openai-responses", models: [ { id: "minimax-m2.1-gs32", name: "MiniMax M2.1 GS32", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: , maxTokens: 8192 } ] } }
} }
- 如果您设置了
dmPolicy: “open”,匹配的allowFrom列表必须包含“*” - 提供商 ID 有所不同(电话号码、用户 ID、频道 ID)。请使用提供商文档确认格式
openclaw doctor是OpenClaw的修复+迁移工具。它能修复陈旧的配置/状态,检查健康状态,并提供可作的修复步骤
示例:
openclaw doctor
无需提示就接受默认(包括适用的重启/服务/沙箱修复步骤)
openclaw doctor –repair
在不提示的情况下应用推荐维修(修复+安全重启)
openclaw doctor –repair –force
如果你想在写入前查看更改,请先打开配置文件:
cat /.openclaw/openclaw.json
也要进行积极修复(覆盖自定义配置)
openclaw doctor –non-interactive
当您访问 Web 界面时,可能会遇到错误:
错误描述:
disconnected (1008): unauthorized: gateway token mismatch (open a tokenized dashboard URL or paste token in Control UI settings)
这是因为用户没有使用终端带令牌的链接打开,导致权限认证失败
解决方案:
使用命令行获取带令牌的链接
执行以下命令
讯享网 openclaw dashboard –no-open
自动生成带令牌的仪表板链接
然后复制输出的链接并在浏览器中打开,即可自动带令牌访问 Web 页面
手动配置令牌
手动配置令牌:
- 在 Web 界面的设置面板中,粘贴您配置的网关令牌(或密码)
- 令牌通常存储在
/.openclaw/openclaw.json文件中的gateway.auth.token,或通过环境变量OPENCLAW_GATEWAY_TOKEN设置
错误描述:
当您在 容器化部署(Docker、Kubernetes 等)中访问 Web 界面时,可能会遇到错误:
disconnected (1008): pairing required
症状:
- Web UI 立即断开连接,显示错误消息
- 浏览器控制台显示 WebSocket 关闭代码
1008和原因pairing required - 网关日志显示类似:
[ws] closed before connect … reason=pairing required
GPT plus 代充 只需 145
解决方案:
启用 Web UI 不安全认证(推荐)
本地部署
openclaw config set gateway.controlUi.allowInsecureAuth true openclaw gateway restart
手动编辑文件:
讯享网 { “gateway”: {
"port": 18789, "mode": "local", "bind": "loopback", "auth": { "mode": "token", "token": "your-token-here" }, "controlUi": { "allowInsecureAuth": true }
} }
执行以下命令
讯享网 openclaw status openclaw gateway status openclaw logs –follow openclaw doctor openclaw channels status –probe
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/213408.html