OpenClaw从入门到应用:基础知识——CLI 入门

发布时间:2026/7/9 13:47:33

OpenClaw从入门到应用:基础知识——CLI 入门 通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》OpenClaw 的 CLI 入门向导是在macOS、Linux 或 Windows强烈推荐通过 WSL2上设置 OpenClaw 的推荐方式。它通过一个引导式交互流程帮助您配置本地或远程网关连接以及频道channels、技能skills和工作区workspace的默认设置。openclaw onboard最快开启首次聊天直接打开控制界面无需配置频道。运行openclaw dashboard即可在浏览器中开始聊天。文档详见控制面板。如需后续重新配置可以使用以下命令openclaw configure openclaw agentsadd⚠️ 注意--json参数并不表示非交互模式。若用于脚本请使用--non-interactive。向导中包含一个网络搜索配置步骤您可以选择一个提供商Perplexity、Brave、Gemini、Grok 或 Kimi并粘贴 API 密钥以便智能体agent能够使用web_search功能。您也可以稍后通过openclaw configure --section web进行配置。文档详见Web 工具。快速启动 vs 高级模式向导开始时提供两种选择快速启动QuickStart使用默认设置或高级模式Advanced完全控制每一步。快速启动QuickStart默认配置包括本地网关loopback 地址工作区使用默认路径或已有工作区网关端口18789网关认证方式Token即使在 loopback 模式下也会自动生成新本地设置的工具策略默认值tools.profile: coding如果已存在明确配置的 profile则保留原值私信DM隔离默认行为若未设置本地入门流程将写入session.dmScope: per-channel-peer。详情见 CLI 入门向导参考文档Tailscale 暴露关闭Telegram 和 WhatsApp 私信默认为允许列表allowlist模式系统会提示您输入手机号码高级模式Advanced则暴露所有配置步骤模式mode工作区workspace网关gateway频道channels守护进程daemon技能skills向导配置的内容本地模式默认将引导您完成以下步骤1. 模型/认证Model/Auth选择任意受支持的提供商/认证流程API 密钥、OAuth 或 setup-token包括自定义提供商Custom Provider兼容 OpenAI、Anthropic或自动检测未知类型。选择默认模型。安全提示如果此智能体将运行工具或处理 webhook/hooks 内容建议使用当前最强的最新模型并保持工具策略严格。较弱或较旧的模型更容易受到提示注入攻击。非交互式运行--secret-input-mode ref会将基于环境变量的引用存储在认证配置文件中而不是明文 API 密钥。必须预先设置对应的 provider 环境变量若未设置而直接传入内联密钥标志程序将立即失败。交互式运行选择 secret reference 模式可让您指向环境变量或已配置的 provider 引用file或exec类型并在保存前进行快速预检验证。2. 工作区Workspace智能体文件的存储位置默认为~/.openclaw/workspace并生成引导文件bootstrap files。3. 网关Gateway配置端口、绑定地址、认证模式、Tailscale 暴露选项。在交互式 token 模式下可选择默认的明文 token 存储方式或启用 SecretRef。非交互式 token SecretRef 路径参数--gateway-token-ref-env。4. 频道Channels支持 WhatsApp、Telegram、Discord、Google Chat、Mattermost、Signal、BlueBubbles 或 iMessage。5. 守护进程Daemon安装 LaunchAgentmacOS或 systemd 用户单元Linux/WSL2。若 token 认证需要 token且gateway.auth.token由 SecretRef 管理守护进程安装时会验证该引用但不会将解析后的 token 持久化到 supervisor 服务的环境元数据中。若 token 认证需要 token但配置的 token SecretRef 未解析则守护进程安装会被阻止并提供可操作的指引。若同时配置了gateway.auth.token和gateway.auth.password但gateway.auth.mode未设置则守护进程安装会被阻止直到显式指定认证模式。6. 健康检查Health check启动 Gateway 并验证其是否正常运行。7. 技能Skills安装推荐的技能及可选依赖项。重新运行向导不会删除任何现有内容除非您明确选择重置Reset或传入--reset参数。CLI 的--reset默认重置配置、凭据和会话若要包含工作区请使用--reset-scope full。如果当前配置无效或包含过时字段向导会提示您先运行openclaw doctor。远程模式Remote mode仅配置本地客户端以连接到其他位置的 Gateway不会在远程主机上安装或更改任何内容。添加另一个智能体使用openclaw agents add可创建一个独立的智能体拥有自己的工作区、会话和认证配置文件。若不带--workspace参数运行将启动向导。它会设置以下字段agents.list[].nameagents.list[].workspaceagents.list[].agentDir注意事项默认工作区路径遵循~/.openclaw/workspace-命名规则。可添加bindings以路由入站消息向导可协助完成此操作。非交互式标志包括--model、--agent-dir、--bind、--non-interactive。

相关新闻