OpenClaw Companion CLI
A bilingual CLI for OpenClaw: setup, checks, upgrades with a backup, repair and diagnostics from a single command
- 104 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs the official OpenClaw commands that upgrade the installation, repair the configuration and restart the gateway after confirmation
- The quick-install scripts are downloaded from the internet and run in your shell
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/openclaw-companionDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs the official OpenClaw commands that upgrade the installation, repair the configuration and restart the gateway after confirmation
- The quick-install scripts are downloaded from the internet and run in your shell
This is third-party code. Review the repository files before installing.
What it does
OpenClaw Companion wraps the official OpenClaw commands into clear workflows in Chinese and English. It does not replace the OpenClaw installer, onboarding wizard, Doctor, update, backup and diagnostics but calls them in order and, before risky steps, shows what will change and asks for confirmation. It does not accept or store API keys and bot tokens: sign-in happens in the official OpenClaw wizard. The workflows are the `setup`, `check`, `upgrade`, `backup`, `repair` and `support` commands. A check collects the version, update availability, gateway state and the Doctor result and changes nothing. An upgrade first makes a verified backup and stops if the backup fails. A repair runs Doctor read-only, shows the consequences and applies fixes one by one after confirmation. The `support` command creates a sanitized diagnostics package on disk and sends it nowhere.
Who it is for. For owners of a personal OpenClaw on Windows, macOS, Ubuntu or Debian who prefer a Chinese-language menu over official commands from the documentation.
Good fit when
- A fresh OpenClaw install where you need to quickly pick Qwen, Kimi, DeepSeek, MiniMax or a Feishu channel in the wizard.
- Before upgrading OpenClaw you want to see a plan and get a verified backup.
- After an upgrade on Windows the agent does not start, and repair goes step by step with confirmation.
- A failure has to be described in a ticket: `openclaw-companion support` collects a sanitized diagnostics package.
- The installation state is checked in CI or on a schedule: `check --json --strict` returns an exit code for automation.
Not a fit when
- You need a web panel or a desktop app: Companion works only in the terminal and starts no background services.
- Your OpenClaw is older than 2026.5.29 or you run Node.js 23: Companion does not support these combinations.
- You need sign-in through WeChat, WeCom or DingTalk: the project promises no channels without an official stable OpenClaw plugin.
Example request
Show the OpenClaw upgrade plan through openclaw-companion without applying it and check that the backup is created without errorsLimitations
This is a community project, not an OpenClaw product, and the OpenClaw name and code belong to their owners. It needs Node.js 22.22.3 or newer, 24.15 or newer, 25.9 or newer or 26 (Node 23 is not supported), OpenClaw 2026.5.29 or higher and one of the systems: Windows 10 or 11, macOS 13 or newer, Ubuntu 22.04 or 24.04, Debian 12. New OpenClaw versions may need a newer Node.js, which the official installer checks. There is no automatic rollback after a failed upgrade: Companion keeps the backup path and points to the official restore. The quick-install scripts from the internet are better downloaded and read before running. Licensed under MIT.
How to disable. Companion is removed with `npm uninstall -g openclaw-companion`. It has no background services of its own, and the OpenClaw installation itself stays untouched.
FAQ
Is this an official OpenClaw tool?
No, it is an independent community project. It calls the official OpenClaw CLI, and the OpenClaw name and code belong to their owners.
Does Companion store my keys and tokens?
No. It does not read or save API keys, bot tokens, cookies, passwords or chat content: sign-in goes directly through the official OpenClaw wizard.
What if an upgrade fails?
There is no automatic rollback. Companion keeps the verified backup, shows its path and points to the official OpenClaw restore process.
How do I use the check in automation?
With `openclaw-companion check --json`: the output schema is stable. Code 0 means no errors, code 1 means errors found (with `--strict` warnings too), code 2 means the run failed.
Which interface language is used?
The order is the `--lang` flag, then the `OPENCLAW_COMPANION_LANG` variable, then the system language, otherwise English. `zh-CN` and `en` are available.
Discussion
No questions or reviews yet.
Related
CLI toolsA monitoring dashboard for OpenClaw agents: sessions, token and cost use, system load and scheduled jobs in one browser window
A local one-page dashboard for OpenClaw agents: gateway, model costs, cron, sessions and sub-agents, with no login and no cloud.
A Go CLI: plain-language questions to AWS, GCP, Azure, Cloudflare and Kubernetes, change plans and its own MCP server
A CLI that runs Claude Code and Codex in isolated Docker containers with a firewall, worktrees and a no-Dockerfile image.
clawk is a virtual-environment CLI that snapshots a Linux machine’s memory and disk so running processes can be resumed later.
OpenDeRisk CLI
OpenDeRisk
OpenDeRisk CLI starts an environment with separate agent roles for inspecting observations, writing analysis code and reporting.
README in short
The project positions itself as a layer over the official OpenClaw CLI for ordinary users: every operation has a preview, a confirmation and stable machine output. The README covers a capability table with safety boundaries, commands and flags, the check output schema, connecting Qwen, Moonshot, DeepSeek and MiniMax models, the privacy policy and CI checks on several systems.